Skip to content

A self-hosted UPI & COD payment gateway with zero per-transaction platform fees, universal JavaScript checkout integration, dynamic QR payments, WhatsApp OTP authentication, and automated payment verification.

JavaScript

fix(android,security): enforce package allowlist, fix Java method signature, rebuild APK and publish SHA-256 (#61)

ArunGupta1526cfec0e4f04bf
diff --git a/README.md b/README.md
index 9d73b48..6f0a115 100644
--- a/README.md
+++ b/README.md
@@ -517,7 +517,7 @@ YOUPI PG confirms payments without expensive commercial banking APIs using a tri
SUCCESS CONFIRMED
```
-1. **Android Observer App:** Install [`apps/android-observer-app/youpi-sms-gateway.apk`](apps/android-observer-app/youpi-sms-gateway.apk) on any secondary Android smartphone with the receiving bank SIM. Scan the pairing QR code in Merchant Admin to establish an encrypted HMAC link.
+1. **Android Observer App:** Install [`apps/android-observer-app/youpi-sms-gateway.apk`](apps/android-observer-app/youpi-sms-gateway.apk) (Certified SHA-256: `959218223e75da4784744c16afaf7bc121cff377dff04f041875237042f51601`) on any secondary Android smartphone with the receiving bank SIM. Scan the pairing QR code in Merchant Admin to establish an encrypted HMAC link.
2. **Gmail Observer:** Connect your bank-registered Google account using standard OAuth2 credentials.
<details>
<summary><b>🔍 View Verified Indian Bank Domains & RBI <code>.bank.in</code> Registry</b></summary>
diff --git a/apps/android-observer-app/__tests__/android-observer.test.js b/apps/android-observer-app/__tests__/android-observer.test.js
index 73cb8d9..f59161e 100644
--- a/apps/android-observer-app/__tests__/android-observer.test.js
+++ b/apps/android-observer-app/__tests__/android-observer.test.js
@@ -94,4 +94,30 @@ describe('Android Payment Observer Integration Tests', () => {
const updated = apiInstance.app.context.sessionRepo.findById(session.id);
assert.equal(updated.status, PaymentStatus.SUCCESS);
});
+
+ test('Issue #61: rejects notification observation when rawNotification has missing or empty package', async () => {
+ const resWithoutPkg = await driver.submitObservation({
+ amount: '100.00',
+ receivingAccountId: '00000000-0000-0000-0000-000000000002',
+ utr: 'UTR-MISSING-PKG',
+ notificationText: 'Payment of ₹100 received from user@bank on UPI',
+ package: ''
+ });
+
+ assert.equal(resWithoutPkg.status, 400);
+ assert.match(resWithoutPkg.body.error, /must specify a valid package name/);
+ });
+
+ test('Issue #61: rejects notification observation from untrusted/unallowed package name', async () => {
+ const resUntrusted = await driver.submitObservation({
+ amount: '100.00',
+ receivingAccountId: '00000000-0000-0000-0000-000000000002',
+ utr: 'UTR-UNTRUSTED-PKG',
+ notificationText: 'Payment of ₹100 received from fake@bank on FakeApp',
+ package: 'com.attacker.fake.banking'
+ });
+
+ assert.equal(resUntrusted.status, 400);
+ assert.match(resUntrusted.body.error, /Untrusted Android notification package/);
+ });
});
diff --git a/apps/android-observer-app/app/src/main/java/com/youpi/observer/ApiClient.java b/apps/android-observer-app/app/src/main/java/com/youpi/observer/ApiClient.java
index 7d7c292..deea0a4 100644
--- a/apps/android-observer-app/app/src/main/java/com/youpi/observer/ApiClient.java
+++ b/apps/android-observer-app/app/src/main/java/com/youpi/observer/ApiClient.java
@@ -132,7 +132,7 @@ public class ApiClient {
return false;
}
- public boolean sendObservation(long amountPaise, double amount, String bankRef, String senderVpa, String title, String text) {
+ public boolean sendObservation(long amountPaise, double amount, String bankRef, String senderVpa, String title, String text, String packageName) {
if (!isPaired()) return false;
String deviceId = prefs.getString("device_id", null);
@@ -145,6 +145,9 @@ public class ApiClient {
JSONObject raw = new JSONObject();
raw.put("title", title != null ? title : "");
raw.put("text", text != null ? text : "");
+ if (packageName != null && !packageName.isEmpty()) {
+ raw.put("package", packageName);
+ }
JSONObject json = new JSONObject();
json.put("deviceId", deviceId);
@@ -167,6 +170,10 @@ public class ApiClient {
return false;
}
+ public boolean sendObservation(long amountPaise, double amount, String bankRef, String senderVpa, String title, String text) {
+ return sendObservation(amountPaise, amount, bankRef, senderVpa, title, text, null);
+ }
+
public void unpair() {
prefs.edit().remove("device_id").remove("signing_key").apply();
}
diff --git a/apps/android-observer-app/app/src/main/java/com/youpi/observer/PaymentNotificationListenerService.java b/apps/android-observer-app/app/src/main/java/com/youpi/observer/PaymentNotificationListenerService.java
index e662eaf..cd763f0 100644
--- a/apps/android-observer-app/app/src/main/java/com/youpi/observer/PaymentNotificationListenerService.java
+++ b/apps/android-observer-app/app/src/main/java/com/youpi/observer/PaymentNotificationListenerService.java
@@ -16,31 +16,46 @@ public class PaymentNotificationListenerService extends NotificationListenerServ
private static final String TAG = "YoupiNotifListener";
private ApiClient apiClient;
+ // Generated from packages/common/src/upi-providers.js - Single Source of Truth
private static final Set<String> ALLOWED_BANKING_PACKAGES = new HashSet<>(Arrays.asList(
- "com.google.android.apps.nbu.paisa.user",
- "com.phonepe.app",
- "net.one97.paytm",
- "in.org.npci.upiapp",
- "in.amazon.mShop.android.shopping",
- "com.dreamplug.androidapp",
- "com.freecharge.android",
- "com.mobikwik_new",
- "com.fampay.in",
- "com.sbi.upi",
- "com.sbi.lotusintouch",
- "com.hdfcbank.payzapp",
- "com.snapwork.hdfc",
- "com.csam.icici.bank.imobile",
"com.axis.mobile",
- "com.msf.kbank.mobile",
"com.bankofbaroda.mconnect",
- "com.idfcfirstbank.optimus",
- "com.infrasofttech.indianbank",
+ "com.bankofbaroda.upi",
"com.canarabank.mobility",
- "com.infrasoft.uboi",
+ "com.csam.icici.bank.imobile",
+ "com.dreamplug.androidapp",
+ "com.epifi.paisa",
+ "com.fampay.in",
"com.fedmobile",
+ "com.fisglobal.bandhanupi.app",
+ "com.freecharge.android",
"com.google.android.apps.messaging",
- "com.samsung.android.messaging"
+ "com.google.android.apps.nbu.paisa.user",
+ "com.hdfcbank.payzapp",
+ "com.icicibank.pockets",
+ "com.idfcfirstbank.optimus",
+ "com.infrasoft.uboi",
+ "com.infrasofttech.indianbank",
+ "com.mgs.induspsp",
+ "com.mobikwik_new",
+ "com.msf.kbank.mobile",
+ "com.myairtelapp",
+ "com.nextbillion.groww",
+ "com.phonepe.app",
+ "com.samsung.android.messaging",
+ "com.samsung.android.spay",
+ "com.sbi.lotusintouch",
+ "com.sbi.upi",
+ "com.snapwork.hdfc",
+ "com.tatadigital.tcp",
+ "com.truecaller",
+ "com.upi.axispay",
+ "in.amazon.mshop.android.shopping",
+ "in.gokiwi.kiwitpap",
+ "in.org.npci.upiapp",
+ "indwin.c3.shareapp",
+ "money.jupiter",
+ "net.one97.paytm"
));
private static final Pattern AMOUNT_PATTERN = Pattern.compile("(?:Rs\\.?|INR|₹)\\s*([0-9,]+(?:\\.[0-9]{1,2})?)", Pattern.CASE_INSENSITIVE);
diff --git a/apps/android-observer-app/driver.js b/apps/android-observer-app/driver.js
index e106875..f6964e1 100644
--- a/apps/android-observer-app/driver.js
+++ b/apps/android-observer-app/driver.js
@@ -84,10 +84,10 @@ export class AndroidObserverDriver {
observedAt: (obs.observedAt instanceof Date ? obs.observedAt : new Date(obs.observedAt || Date.now())).toISOString(),
bankReferenceNumber: obs.utr,
senderVpa: obs.senderVpa,
- rawNotification: {
- title: 'Payment Received',
+ rawNotification: obs.rawNotification !== undefined ? obs.rawNotification : {
+ title: obs.notificationTitle || 'Payment Received',
text: obs.notificationText || `Received Rs ${obs.amount} via UPI`,
- package: 'com.phonepe.app'
+ package: obs.package !== undefined ? obs.package : 'com.phonepe.app'
}
};
diff --git a/apps/android-observer-app/youpi-sms-gateway.apk b/apps/android-observer-app/youpi-sms-gateway.apk
index 3b0e824..5a2c4a3 100644
Binary files a/apps/android-observer-app/youpi-sms-gateway.apk and b/apps/android-observer-app/youpi-sms-gateway.apk differ
diff --git a/apps/android-observer-app/youpi-sms-gateway.apk.sha256 b/apps/android-observer-app/youpi-sms-gateway.apk.sha256
new file mode 100644
index 0000000..fb40cd2
--- /dev/null
+++ b/apps/android-observer-app/youpi-sms-gateway.apk.sha256
@@ -0,0 +1 @@
+959218223e75da4784744c16afaf7bc121cff377dff04f041875237042f51601 youpi-sms-gateway.apk
diff --git a/apps/merchant-admin/public/youpi-sms-gateway.apk b/apps/merchant-admin/public/youpi-sms-gateway.apk
index 3b0e824..5a2c4a3 100644
Binary files a/apps/merchant-admin/public/youpi-sms-gateway.apk and b/apps/merchant-admin/public/youpi-sms-gateway.apk differ
diff --git a/apps/merchant-admin/public/youpi-sms-gateway.apk.sha256 b/apps/merchant-admin/public/youpi-sms-gateway.apk.sha256
new file mode 100644
index 0000000..fb40cd2
--- /dev/null
+++ b/apps/merchant-admin/public/youpi-sms-gateway.apk.sha256
@@ -0,0 +1 @@
+959218223e75da4784744c16afaf7bc121cff377dff04f041875237042f51601 youpi-sms-gateway.apk
diff --git a/apps/payment-api/public/youpi-sms-gateway.apk b/apps/payment-api/public/youpi-sms-gateway.apk
index 3b0e824..5a2c4a3 100644
Binary files a/apps/payment-api/public/youpi-sms-gateway.apk and b/apps/payment-api/public/youpi-sms-gateway.apk differ
diff --git a/apps/payment-api/public/youpi-sms-gateway.apk.sha256 b/apps/payment-api/public/youpi-sms-gateway.apk.sha256
new file mode 100644
index 0000000..fb40cd2
--- /dev/null
+++ b/apps/payment-api/public/youpi-sms-gateway.apk.sha256
@@ -0,0 +1 @@
+959218223e75da4784744c16afaf7bc121cff377dff04f041875237042f51601 youpi-sms-gateway.apk
diff --git a/apps/payment-api/src/__tests__/gateway-hardening-invariants.test.js b/apps/payment-api/src/__tests__/gateway-hardening-invariants.test.js
index 0893072..f40b3fa 100644
--- a/apps/payment-api/src/__tests__/gateway-hardening-invariants.test.js
+++ b/apps/payment-api/src/__tests__/gateway-hardening-invariants.test.js
@@ -410,6 +410,37 @@ describe('Gateway Hardening & Invariant Protection Test Suite (#23, #25, #26, #2
assert.match(res.body.error, /Untrusted Android notification package/);
});
+ test('Issue #61: Android observer rejects observations when rawNotification is missing package parameter', async () => {
+ const deviceId = 'test-android-device-pkg-1';
+ const signingKey = '0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef';
+ const timestamp = Date.now().toString();
+ const payloadObj = {
+ deviceId,
+ amount: '500.00',
+ amountPaise: '50000',
+ observedAt: new Date().toISOString(),
+ rawNotification: {
+ title: 'Payment Received',
+ text: 'Received Rs 500 via UPI'
+ }
+ };
+ const bodyStr = JSON.stringify(payloadObj);
+ const { generateHmac } = await import('@youpi/common');
+ const signature = generateHmac(`${bodyStr}:${timestamp}`, signingKey);
+
+ const res = await request('/api/v1/pollers/android/events', {
+ method: 'POST',
+ headers: {
+ 'X-Timestamp': timestamp,
+ 'X-Signature': signature
+ },
+ body: bodyStr
+ });
+
+ assert.equal(res.status, 400);
+ assert.match(res.body.error, /must specify a valid package name in rawNotification\.package/);
+ });
+
test('Issue #9: findByMobile strictly matches exact numbers without unanchored LIKE injection', async () => {
const customerRepo = apiInstance.app.context.customerRepo;
const targetMobile = '9876500001';
diff --git a/apps/payment-api/src/routes/pollers.routes.js b/apps/payment-api/src/routes/pollers.routes.js
index 4df12f0..799f4e4 100644
--- a/apps/payment-api/src/routes/pollers.routes.js
+++ b/apps/payment-api/src/routes/pollers.routes.js
@@ -4,7 +4,7 @@ import path from 'node:path';
import { fileURLToPath } from 'node:url';
import { HttpServer } from '../server.js';
import { ObservationNormalizer, BankSmsParser, BankEmailParser, generateQrSvg } from '@youpi/core';
-import { toRupeesString, toPaise, verifyHmac, resolveRuntimeUrls, resolveSecret, safeEqual, hasBearer, getObserverToken, findUpiProviderByPackage } from '@youpi/common';
+import { toRupeesString, toPaise, verifyHmac, resolveRuntimeUrls, resolveSecret, safeEqual, hasBearer, getObserverToken, isAllowedNotificationPackage } from '@youpi/common';
import { isAdminRequest } from '../auth-guard.js';
const __filename = fileURLToPath(import.meta.url);
@@ -304,27 +304,19 @@ export function registerPollerRoutes(server, ctx) {
let senderVpa = body.senderVpa;
let observedAt = body.observedAt ? new Date(body.observedAt) : new Date();
- // Security Invariant (Issue #24): Validate Android notification package name if notification origin
- const notificationPackage = body.rawNotification?.package ? String(body.rawNotification.package).trim().toLowerCase() : null;
- if (notificationPackage) {
- const isKnownUpi = Boolean(findUpiProviderByPackage(notificationPackage));
- const KNOWN_NOTIFICATION_PACKAGES = new Set([
- 'com.google.android.apps.messaging',
- 'com.samsung.android.messaging',
- 'com.fampay.in',
- 'com.sbi.lotusintouch',
- 'com.snapwork.hdfc',
- 'com.csam.icici.bank.imobile',
- 'com.axis.mobile',
- 'com.msf.kbank.mobile',
- 'com.bankofbaroda.mconnect',
- 'com.idfcfirstbank.optimus',
- 'com.infrasofttech.indianbank',
- 'com.canarabank.mobility',
- 'com.infrasoft.uboi',
- 'com.fedmobile'
- ]);
- if (!isKnownUpi && !KNOWN_NOTIFICATION_PACKAGES.has(notificationPackage)) {
+ // Security Invariant (Issues #24, #61): Validate Android notification package name if notification origin
+ if (body.rawNotification) {
+ const rawPkg = body.rawNotification.package;
+ if (!rawPkg || typeof rawPkg !== 'string' || !rawPkg.trim()) {
+ HttpServer.json(res, 400, {
+ accepted: false,
+ error: 'Android notification observation must specify a valid package name in rawNotification.package'
+ });
+ return;
+ }
+
+ const notificationPackage = rawPkg.trim().toLowerCase();
+ if (!isAllowedNotificationPackage(notificationPackage)) {
HttpServer.json(res, 400, {
accepted: false,
error: `Untrusted Android notification package: ${notificationPackage}`
diff --git a/docs/OBSERVERS_SETUP.md b/docs/OBSERVERS_SETUP.md
index b5bd30e..a12f8b3 100644
--- a/docs/OBSERVERS_SETUP.md
+++ b/docs/OBSERVERS_SETUP.md
@@ -98,6 +98,18 @@ The engine supports root domains and alert subdomains (e.g. `alerts.hdfcbank.net
5. Tap **Pair with Merchant Gateway**. The device will receive its permanent `deviceId` and `signingKey` stored in `EncryptedSharedPreferences`.
6. Grant Notification Listener Access in Android System Settings.
+### Binary Verification & Checksum
+Operators can verify the cryptographic integrity and authenticity of `youpi-sms-gateway.apk` before sideloading onto merchant Android devices:
+
+- **Target Binary**: `apps/android-observer-app/youpi-sms-gateway.apk` (also mirrored at `/youpi-sms-gateway.apk` on Admin and Payment API)
+- **SHA-256 Checksum**: `959218223e75da4784744c16afaf7bc121cff377dff04f041875237042f51601`
+- **Verification Command**:
+ ```bash
+ shasum -a 256 apps/android-observer-app/youpi-sms-gateway.apk
+ # Or check against the companion checksum file:
+ shasum -a 256 -c apps/android-observer-app/youpi-sms-gateway.apk.sha256
+ ```
+
---
## Method 3: Google Messages / SMS Observer
diff --git a/package.json b/package.json
index c0756de..32a8eb4 100644
--- a/package.json
+++ b/package.json
@@ -20,6 +20,8 @@
"test": "node scripts/test-all.js",
"test:all": "node scripts/test-all.js",
"test:acceptance": "node --test scripts/production-infrastructure.test.js",
+ "build:android:apk": "node scripts/build-android-apk.js",
+ "sync:android-allowlist": "node scripts/sync-android-allowlist.js",
"typecheck": "tsc -b --noEmit"
},
"devDependencies": {
diff --git a/packages/common/src/__tests__/common.test.js b/packages/common/src/__tests__/common.test.js
index 117b8dc..b457e7a 100644
--- a/packages/common/src/__tests__/common.test.js
+++ b/packages/common/src/__tests__/common.test.js
@@ -19,6 +19,8 @@ import {
getUpiProviders,
findUpiProviderByPackage,
findUpiProviderById,
+ ALLOWED_NOTIFICATION_PACKAGES,
+ isAllowedNotificationPackage,
calculateObservationFingerprint
} from '../index.js';
@@ -194,6 +196,27 @@ describe('@youpi/common Unit Tests', () => {
packages.add(p.packageName);
}
});
+
+ test('validates unified ALLOWED_NOTIFICATION_PACKAGES and isAllowedNotificationPackage', () => {
+ assert.ok(Array.isArray(ALLOWED_NOTIFICATION_PACKAGES));
+ assert.ok(ALLOWED_NOTIFICATION_PACKAGES.length >= 38);
+
+ // Verify essential UPI and banking packages are included
+ assert.equal(isAllowedNotificationPackage('com.phonepe.app'), true);
+ assert.equal(isAllowedNotificationPackage('com.google.android.apps.nbu.paisa.user'), true);
+ assert.equal(isAllowedNotificationPackage('net.one97.paytm'), true);
+ assert.equal(isAllowedNotificationPackage('com.google.android.apps.messaging'), true);
+ assert.equal(isAllowedNotificationPackage('com.sbi.lotusintouch'), true);
+
+ // Case-insensitivity and trim handling
+ assert.equal(isAllowedNotificationPackage(' COM.PHONEPE.APP '), true);
+
+ // Rejects spoofed or unlisted apps
+ assert.equal(isAllowedNotificationPackage('com.attacker.fake.app'), false);
+ assert.equal(isAllowedNotificationPackage(''), false);
+ assert.equal(isAllowedNotificationPackage(null), false);
+ assert.equal(isAllowedNotificationPackage(undefined), false);
+ });
});
describe('Observation Fingerprinting', () => {
diff --git a/packages/common/src/upi-providers.js b/packages/common/src/upi-providers.js
index 177fcdc..d468816 100644
--- a/packages/common/src/upi-providers.js
+++ b/packages/common/src/upi-providers.js
@@ -350,3 +350,40 @@ export function findUpiProviderById(id) {
const clean = id.trim().toLowerCase();
return UPI_PROVIDERS.find(p => p.id.toLowerCase() === clean);
}
+
+/**
+ * Official companion SMS and banking notification application packages
+ * permitted to deliver real-time credit payment observations to YOUPI Gateway.
+ */
+export const BANKING_AND_MESSAGING_PACKAGES = Object.freeze([
+ 'com.google.android.apps.messaging',
+ 'com.samsung.android.messaging',
+ 'com.fampay.in',
+ 'com.sbi.lotusintouch',
+ 'com.hdfcbank.payzapp',
+ 'com.bankofbaroda.mconnect',
+ 'com.infrasofttech.indianbank',
+ 'com.fedmobile'
+]);
+
+/**
+ * Canonical unified allowlist of all verified UPI payment and banking observation packages.
+ */
+export const ALLOWED_NOTIFICATION_PACKAGES = Object.freeze(
+ Array.from(new Set([
+ ...UPI_PROVIDERS.map(p => p.packageName.toLowerCase()),
+ ...BANKING_AND_MESSAGING_PACKAGES.map(p => p.toLowerCase())
+ ])).sort()
+);
+
+/**
+ * Verifies whether a given Android package identifier is an authorized banking/UPI provider.
+ * @param {string} packageName
+ * @returns {boolean}
+ */
+export function isAllowedNotificationPackage(packageName) {
+ if (!packageName || typeof packageName !== 'string') return false;
+ const clean = packageName.trim().toLowerCase();
+ return ALLOWED_NOTIFICATION_PACKAGES.includes(clean);
+}
+
diff --git a/packages/common/src/upi-providers.ts b/packages/common/src/upi-providers.ts
index a3b98af..ed81915 100644
--- a/packages/common/src/upi-providers.ts
+++ b/packages/common/src/upi-providers.ts
@@ -363,3 +363,38 @@ export function findUpiProviderById(id?: string): UpiProvider | undefined {
const clean = id.trim().toLowerCase();
return UPI_PROVIDERS.find(p => p.id.toLowerCase() === clean);
}
+
+/**
+ * Official companion SMS and banking notification application packages
+ * permitted to deliver real-time credit payment observations to YOUPI Gateway.
+ */
+export const BANKING_AND_MESSAGING_PACKAGES: readonly string[] = Object.freeze([
+ 'com.google.android.apps.messaging',
+ 'com.samsung.android.messaging',
+ 'com.fampay.in',
+ 'com.sbi.lotusintouch',
+ 'com.hdfcbank.payzapp',
+ 'com.bankofbaroda.mconnect',
+ 'com.infrasofttech.indianbank',
+ 'com.fedmobile'
+]);
+
+/**
+ * Canonical unified allowlist of all verified UPI payment and banking observation packages.
+ */
+export const ALLOWED_NOTIFICATION_PACKAGES: readonly string[] = Object.freeze(
+ Array.from(new Set([
+ ...UPI_PROVIDERS.map(p => p.packageName.toLowerCase()),
+ ...BANKING_AND_MESSAGING_PACKAGES.map(p => p.toLowerCase())
+ ])).sort()
+);
+
+/**
+ * Verifies whether a given Android package identifier is an authorized banking/UPI provider.
+ */
+export function isAllowedNotificationPackage(packageName?: string): boolean {
+ if (!packageName || typeof packageName !== 'string') return false;
+ const clean = packageName.trim().toLowerCase();
+ return ALLOWED_NOTIFICATION_PACKAGES.includes(clean);
+}
+
diff --git a/scripts/build-android-apk.js b/scripts/build-android-apk.js
index 011d9b4..57ea0ec 100644
--- a/scripts/build-android-apk.js
+++ b/scripts/build-android-apk.js
@@ -1,7 +1,9 @@
import fs from 'node:fs';
import path from 'node:path';
+import crypto from 'node:crypto';
import { execSync } from 'node:child_process';
import { fileURLToPath } from 'node:url';
+import { syncAndroidAllowlist } from './sync-android-allowlist.js';
const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);
@@ -96,6 +98,10 @@ const BIN_DIR = path.join(WORK_DIR, 'bin');
fs.mkdirSync(BIN_DIR, { recursive: true });
try {
+ // 0. Synchronize banking package allowlist from packages/common/src/upi-providers.js into Java service
+ console.log('🔄 [0/6] Synchronizing Android banking package allowlist from @youpi/common...');
+ syncAndroidAllowlist();
+
// 1. Compile Java Source Code into Bytecode (.class)
console.log('📦 [1/6] Compiling Java source files with javac...');
const LIBS_DIR = path.resolve(APP_DIR, 'libs');
@@ -192,9 +198,10 @@ try {
});
console.log(' ✅ Verification Report:\n' + verifyOutput.trim().split('\n').map(l => ' ' + l).join('\n'));
- // 6. Copy final APK to all distribution endpoints
- console.log('🚚 [6/6] Distributing final APK to app portals...');
+ // 6. Copy final APK to all distribution endpoints & compute cryptographic checksum
+ console.log('🚚 [6/6] Distributing final APK to app portals and calculating SHA-256...');
const apkBuffer = fs.readFileSync(signedApk);
+ const sha256 = crypto.createHash('sha256').update(apkBuffer).digest('hex');
const targets = [
path.resolve(REPO_ROOT, 'apps/android-observer-app/youpi-sms-gateway.apk'),
path.resolve(REPO_ROOT, 'apps/payment-api/public/youpi-sms-gateway.apk'),
@@ -205,10 +212,15 @@ try {
const dir = path.dirname(t);
if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
fs.writeFileSync(t, apkBuffer);
+ fs.writeFileSync(`${t}.sha256`, `${sha256} youpi-sms-gateway.apk\n`, 'utf8');
console.log(` 🎉 Saved signed installable APK: ${t} (${apkBuffer.length.toLocaleString()} bytes)`);
+ console.log(` Checksum saved: ${t}.sha256`);
}
- console.log('\n✨ Android APK compilation and signing completed successfully!');
+ console.log(`\n========================================================`);
+ console.log(`🔑 Certified APK SHA-256: ${sha256}`);
+ console.log(`========================================================`);
+ console.log('\n✨ Android APK compilation, signing, and verification completed successfully!');
} finally {
try {
process.chdir(REPO_ROOT);
diff --git a/scripts/sync-android-allowlist.js b/scripts/sync-android-allowlist.js
new file mode 100644
index 0000000..c89d9e2
--- /dev/null
+++ b/scripts/sync-android-allowlist.js
@@ -0,0 +1,48 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { ALLOWED_NOTIFICATION_PACKAGES } from '../packages/common/src/upi-providers.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const REPO_ROOT = path.resolve(__dirname, '..');
+
+/**
+ * Synchronizes the Android NotificationListener allowlist in Java with the
+ * canonical list defined in packages/common/src/upi-providers.js.
+ */
+export function syncAndroidAllowlist() {
+ const serviceFile = path.resolve(
+ REPO_ROOT,
+ 'apps/android-observer-app/app/src/main/java/com/youpi/observer/PaymentNotificationListenerService.java'
+ );
+
+ if (!fs.existsSync(serviceFile)) {
+ throw new Error(`Target service file not found: ${serviceFile}`);
+ }
+
+ let content = fs.readFileSync(serviceFile, 'utf8');
+
+ const javaArrayLines = ALLOWED_NOTIFICATION_PACKAGES
+ .map((pkg, i) => ` "${pkg}"${i < ALLOWED_NOTIFICATION_PACKAGES.length - 1 ? ',' : ''}`)
+ .join('\n');
+
+ const replacement = ` // Generated from packages/common/src/upi-providers.js - Single Source of Truth
+ private static final Set<String> ALLOWED_BANKING_PACKAGES = new HashSet<>(Arrays.asList(
+${javaArrayLines}
+ ));`;
+
+ const regex = /(?:\/\/[^\n]*\n\s*)?private static final Set<String> ALLOWED_BANKING_PACKAGES = new HashSet<\>\(Arrays\.asList\([\s\S]*?\)\);/;
+ if (!regex.test(content)) {
+ throw new Error('Could not match ALLOWED_BANKING_PACKAGES block in PaymentNotificationListenerService.java');
+ }
+
+ content = content.replace(regex, replacement);
+ fs.writeFileSync(serviceFile, content, 'utf8');
+ console.log(`✅ Synchronized ${ALLOWED_NOTIFICATION_PACKAGES.length} banking & UPI packages into PaymentNotificationListenerService.java`);
+ return ALLOWED_NOTIFICATION_PACKAGES.length;
+}
+
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+ syncAndroidAllowlist();
+}