fix: align Peer Cash runtime contract

Author: ADWilkinson

packages/peer-cash/README.md

@@ -57,9 +57,9 @@ locked quotes. Call `fillStats()` before choosing a corridor; it returns
 ```ts
 const prepared = await runtime.peerCash.prepareCashout({
   amountUsdc: '25',
-  platform: 'wise',
+  platform: 'revolut',
   currency: 'GBP',
-  payee: 'recipient@example.com',
+  payee: { offchainId: 'your-revtag' },
 });
 
 // Host-owned wallet boundary. Inspect, sign, submit, and confirm each
@@ -79,6 +79,11 @@ if (prepared.accessPolicyRequired) {
 runtime, an account-abstraction wallet, an external signer, or another policy
 layer that can submit Base transactions.
 
+Wise and PayPal require a verified identity for a new payee registration. Pass
+the structured `CashPayeeInput` returned by the host's identity-attestation
+flow; an already registered handle can still be reused as a string. The Peer
+Cash SDK validates this before any funds move on-chain.
+
 ## Resume and unwind
 
 The composite `depositId` is the durable resume key:

packages/peer-cash/package.json

@@ -9,7 +9,10 @@
   },
   "type": "module",
   "lucidAgents": {
-    "runtime": "portable"
+    "runtime": "node"
+  },
+  "engines": {
+    "node": ">=22"
   },
   "main": "./dist/index.js",
   "module": "./dist/index.js",

packages/peer-cash/src/__tests__/peer-cash.test.ts

@@ -110,6 +110,39 @@ describe('peerCash', () => {
     expect(() => JSON.stringify(prepared)).not.toThrow();
   });
 
+  it('passes structured payee data through for attested payout identities', async () => {
+    const baseClient = createCashClient({ environment: 'production' });
+    let received: CashoutInput | undefined;
+    const client = {
+      ...baseClient,
+      prepare: async (input: CashoutInput) => {
+        received = input;
+        return prepareResultFromJson({
+          txs: [],
+          steps: [],
+          register: { hashedOnchainIds: [] },
+          accessPolicyRequired: false,
+        });
+      },
+    } as CashClient;
+    const agent = await createAgent({ name: 'cash-agent', version: '1.0.0' })
+      .use(peerCash({ client }))
+      .build();
+
+    await agent.peerCash.prepareCashout({
+      amountUsdc: '25.5',
+      platform: 'revolut',
+      currency: 'gbp',
+      payee: { offchainId: 'your-revtag' },
+    });
+
+    expect(received?.receive).toMatchObject({
+      platform: 'revolut',
+      currency: 'GBP',
+      payee: { offchainId: 'your-revtag' },
+    });
+  });
+
   it('returns resumable order state as JSON', async () => {
     const depositId = '0x71e18f1b6a1c1a4dfa5c1728f5b70cf4a4d5c111_12';
     const baseClient = createCashClient({ environment: 'production' });

packages/peer-cash/src/peer-cash.ts

@@ -17,6 +17,7 @@ import {
   type CashFillStatsJson,
   type CashOrderJson,
   type CashPreparedStepJson,
+  type CashPayeeInput,
   type PrepareResultJson,
   type PreparedTransactionJson,
   type PreparedCashoutReceipt,
@@ -73,7 +74,7 @@ export type PeerCashoutInput = {
   amountUsdc: string;
   platform: string;
   currency: string;
-  payee: string;
+  payee: CashPayeeInput;
   minimumFillUsdc?: string;
   maximumFillUsdc?: string;
 };