@zkp2p/cash 0.4.0 → 0.4.1

package/AGENTS.md

@@ -205,6 +205,7 @@ Every `CashError` carries `code`, `retryable`, `remediation`. Behavior:
 | `AMOUNT_BELOW_MINIMUM`                  | no        | Raise amount (hard floor $0.01, recommended at least 1 USDC)                               |
 | `INVALID_INTENT_AMOUNT_RANGE`           | no        | Use a positive min, max at least min, and max no greater than amount                       |
 | `INVALID_PAYOUT_CURRENCIES`             | no        | Pass one or more unique currencies listed for the platform                                 |
+| `INVALID_PAYOUT_PLATFORMS`              | no        | Pass one leg or an array of legs, using each platform at most once                         |
 | `PAYEE_VERIFICATION_REQUIRED`           | no        | Register a new Wise/PayPal payee through Peer; an existing registered handle can be reused |
 | `PAYEE_REGISTRATION_FAILED`             | yes       | Validate against `payeeHint`, then retry                                                   |
 | `SOURCE_ROUTE_UNSUPPORTED_IN_PREPARE`   | no        | Execute Relay with a signer first, then prepare a Base-USDC cashout                        |

package/dist/tools.cjs

@@ -2,7 +2,7 @@
 
 // package.json
 var package_default = {
-  version: "0.4.0"};
+  version: "0.4.1"};
 
 // src/tools/index.ts
 var bigintString = {

package/dist/tools.js

@@ -1,6 +1,6 @@
 // package.json
 var package_default = {
-  version: "0.4.0"};
+  version: "0.4.1"};
 
 // src/tools/index.ts
 var bigintString = {

package/docs/lifecycle-and-recovery.md

@@ -197,7 +197,9 @@ receipts.
 Orders also carry their `payouts` legs reconstructed from the chain -
 platform, currency, payee hash, and a pricing proof (`spreadBps: 0`,
 `kind: 'oracle_chainlink'`, `marketRate: true`): the zero-spread claim is a
-queryable fact, not marketing copy.
+queryable fact, not marketing copy. An order created with several payout
+platforms (`receive` as an array of legs) surfaces one entry per
+platform-currency pair, every one of them at the zero-spread oracle rate.
 
 Reconstruction is fail-closed: every payment method on the indexed deposit
 must resolve through the active SDK catalog, and the result must be exactly
@@ -286,6 +288,7 @@ explicit override.
 | `AMOUNT_BELOW_MINIMUM`                  | no        | Amount is below the $0.01 hard floor. The recommended minimum is 1 USDC.                                                                     |
 | `INVALID_INTENT_AMOUNT_RANGE`           | no        | Min/max is non-positive, inverted, or exceeds the deposit. Correct the range.                                                                |
 | `INVALID_PAYOUT_CURRENCIES`             | no        | The currency set is empty or contains duplicates. Pass a non-empty unique set from `capabilities()`.                                         |
+| `INVALID_PAYOUT_PLATFORMS`              | no        | The payout leg set is empty or repeats a platform. Pass one leg, or an array of legs using each platform at most once.                       |
 | `PAYEE_VERIFICATION_REQUIRED`           | no        | A new Wise/PayPal payee needs an attestation. Register it through Peer first; an existing registration can be reused.                        |
 | `PAYEE_REGISTRATION_FAILED`             | yes       | Curator rejected the handle or was unavailable. Check `payeeHint` and retry.                                                                 |
 | `SOURCE_ROUTE_UNSUPPORTED_IN_PREPARE`   | no        | `prepare()` accepts Base USDC only. Use signed source execution, or complete Relay first and then prepare the Base cashout.                  |

package/examples/node-cashout.ts

@@ -23,6 +23,8 @@ import type { CurrencyType } from '@zkp2p/cash';
 const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`);
 const signer = createWalletClient({ account, chain: base, transport: http() });
 
+// One leg here; `receive` also accepts an array of legs to offer several
+// platforms on one order (each platform at most once, all at the oracle rate).
 const receive = {
   platform: process.env.CASH_PLATFORM ?? 'venmo',
   currency: (process.env.CASH_CURRENCY ?? 'USD') as CurrencyType,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zkp2p/cash",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Peer Cash - offramp-only SDK for routing crypto to Base USDC, then cashing out to fiat at the live oracle market rate.",
   "license": "MIT",
   "author": "Peer (https://peer.xyz)",