feat: optional Flashnet Orchestra pay-in and payout rails

.env.example

@@ -75,3 +75,7 @@ LIVEMODE=
 # Anonymous usage telemetry (opt-in via setup/settings; off by default).
 # Set to 0 to force disable.
 # ZONELESS_TELEMETRY=
+
+# Flashnet Orchestra (optional). Server key only (fn_...). Leave unset for simulated rails in test mode.
+# ORCHESTRA_API_URL=https://orchestration.flashnet.xyz
+# ORCHESTRA_API_KEY=

.env.production.example

@@ -68,4 +68,8 @@ LIVEMODE=true
 
 # Anonymous usage telemetry (opt-in via setup/settings; off by default).
 # Set to 0 to force disable.
-# ZONELESS_TELEMETRY=
+# ZONELESS_TELEMETRY=
+
+# Flashnet Orchestra (optional). Server key only (fn_...). Leave unset for simulated rails in test mode.
+# ORCHESTRA_API_URL=https://orchestration.flashnet.xyz
+# ORCHESTRA_API_KEY=

README.md

@@ -195,6 +195,8 @@ zoneless/
 └── nx.json
 ```
 
+Optional Cash App and other-chain stables (settling to USDC on Solana) are documented in [docs/orchestra.md](./docs/orchestra.md). Native `solana:USDC` is unchanged.
+
 ## Contributing
 
 See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup, style guidelines, and the pull request process.

apps/api/src/__tests__/ExternalWallet.spec.ts

@@ -105,6 +105,38 @@ describe('ExternalWalletModule', () => {
         })
       ).rejects.toThrow('Account not found');
     });
+
+    it('accepts USDT on Base', async () => {
+      mockDb.Get = jest.fn().mockResolvedValue({
+        id: 'acct_z_1',
+        platform_account: 'acct_z_platform',
+      });
+
+      const wallet = await module.CreateExternalWallet('acct_z_1', {
+        wallet_address: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e',
+        network: 'base',
+        currency: 'usdt',
+      });
+
+      expect(wallet.network).toBe('base');
+      expect(wallet.currency).toBe('usdt');
+    });
+
+    it('accepts USDT on Solana', async () => {
+      mockDb.Get = jest.fn().mockResolvedValue({
+        id: 'acct_z_1',
+        platform_account: 'acct_z_platform',
+      });
+
+      const wallet = await module.CreateExternalWallet('acct_z_1', {
+        wallet_address: VALID_WALLET,
+        network: 'solana',
+        currency: 'usdt',
+      });
+
+      expect(wallet.network).toBe('solana');
+      expect(wallet.currency).toBe('usdt');
+    });
   });
 
   describe('GetExternalWallet', () => {