@naulon/wayfarer 0.4.1 → 0.5.0

package/dist/rail.js

@@ -10,20 +10,115 @@
 import { classifyPaymentError, classifySignerRefusal, probe, } from "./buyer.js";
 import { runPaidFetch } from "./paidFetch.js";
 import { assembleMemoPayment } from "./memo.js";
-import { gatewayLegPayload } from "./gateway.js";
+import { gatewayLegPayload, gatewayLegPayloadsBatched } from "./gateway.js";
 import { networkByCaip2, supportsMemo } from "@naulon/shared";
-/** Pick the rail the GATE will settle this 402 on. Registry first: a known CAIP-2 network uses the
- *  same predicate the gate's verifyAndSettle uses (`supportsMemo` — memo self-relay vs Circle
- *  Gateway), so buyer and gate can never disagree. The `extra.name 'GatewayWalletBatched'` tell is
- *  only the fallback for a network we don't know: build402 stamps that descriptor on EVERY
- *  gateway-mode 402 — memo chains included — so on a known memo network it is noise, not a signal
- *  (trusting it signed the Gateway envelope against Arc's memo settle: "malformed memo payload"). */
+/** Pick the rail the GATE will settle this 402 on — which is now Circle Gateway on EVERY chain.
+ *
+ *  This used to read `supportsMemo` and sign a raw EIP-3009 authorization for Arc, because the gate
+ *  self-relayed Arc through the Memo predeploy. The gate stopped doing that (`verifyAndSettle`):
+ *  memo settlement is one on-chain transaction per read at our own gas, which Circle prices out of
+ *  the sub-cent band this product sells in. Buyer and gate must agree about the envelope or the
+ *  settle fails as "malformed memo payload", so this predicate moves in the SAME commit as that one
+ *  and keeps no independent opinion.
+ *
+ *  It is a function rather than a constant because the fallback still means something: an UNKNOWN
+ *  CAIP-2 network is judged by the descriptor `build402` stamps on every gateway-mode 402. A quote
+ *  from some future non-Gateway rail would not carry it, and should not be signed as one. */
 function isGateway402(quoted) {
-    const net = networkByCaip2(quoted.requirements.network);
-    if (net)
-        return !supportsMemo(net);
+    if (networkByCaip2(quoted.requirements.network))
+        return true;
     return quoted.requirements.extra?.name === "GatewayWalletBatched";
 }
+/**
+ * Sign a 402 the caller already holds, on the rail the GATE will settle it on — the payment
+ * builder `railBuyer` runs inside its fetch loop, exposed on its own for a host that never needs
+ * the loop: one that built the 402 itself and is now paying it from the buyer's session signers
+ * (the cloud selling a licence it just offered). Picking the rail here, once, is what keeps a
+ * sale and a toll on the same envelope for the same tenant chain.
+ *
+ * Throws on a rail with no signer, and lets `gatewayLegPayload` / the signer throw their own
+ * coded refusals (N-leg on the Circle SDK, a grant refusal) — the caller owns the mapping.
+ */
+export async function assembleRailPayment(quoted, nowMs, signers) {
+    if (isGateway402(quoted)) {
+        if (!signers.gateway) {
+            throw new Error("no gateway signer for a Circle Gateway 402 (this tenant settles on a memo-less chain)");
+        }
+        return Buffer.from(JSON.stringify(await gatewayEnvelopes(signers.gateway, quoted))).toString("base64");
+    }
+    if (!signers.memo) {
+        throw new Error("no memo signer for a memo-rail 402 (this tenant settles on a memo chain)");
+    }
+    // Reached only for an UNKNOWN CAIP-2 that also lacks the Gateway descriptor — every chain in the
+    // registry settles through Circle now (`isGateway402`). Kept because a caller may still hold a
+    // memo signer for a network we do not ship, and silently signing that as a Circle envelope would
+    // produce a payment no facilitator can verify.
+    const net = networkByCaip2(quoted.requirements.network);
+    return assembleMemoPayment(quoted, nowMs, signers.memo, net);
+}
+/**
+ * One Circle envelope per leg the 402 advertised — the multi-leg Gateway payment.
+ *
+ * ## Why this is a loop and not one SDK call
+ *
+ * `BatchEvmScheme.createPaymentPayload(x402Version, paymentRequirements)` takes ONE requirement
+ * (verified against `@circle-fin/x402-batching` 3.4.0). Signing a two-leg toll with it would
+ * authorize the author leg and silently drop the operator fee, so `gatewayLegPayload` refuses a
+ * multi-leg quote outright — correctly, as a single-leg builder.
+ *
+ * That guard used to mean multi-leg tolls were memo-rail-only, which made the operator fee
+ * collectable on exactly one chain. It was never an SDK limit on what the RAIL can carry: the gate
+ * parses an ARRAY of per-leg payloads (`verifyAndSettle`) and `settleGateway` verifies each leg
+ * against its own requirements. So N legs settle fine on Gateway; the buyer simply has to sign N
+ * envelopes rather than asking the SDK for one that covers them all.
+ *
+ * Each leg is signed as its own single-leg quote — same `requirements` with that leg's `payTo` and
+ * `amount`, exactly how `build402` assembled them — so `gatewayLegPayload`'s descriptor guard still
+ * runs on every one, and its N-leg guard stays meaningful for anyone calling it directly.
+ *
+ * A single-leg quote returns the bare envelope, not a one-element array: that is the shape stock
+ * x402 clients send and the gate still accepts either, so there is no reason to change what the
+ * common case puts on the wire.
+ *
+ * ## Why a batch-capable signer takes a different path
+ *
+ * The loop above signs each leg through a SEPARATE call, and for a plain key that is nothing — the
+ * same account signs N times. For a HOSTED signer it is not nothing: signing there also debits a
+ * spending grant and enforces the buyer's per-read ceilings, and a signer asked one leg at a time
+ * can only reason about one leg. Two independent debits for one toll, and the moment a sibling leg
+ * trips a ceiling the author leg is already debited and signed while this function throws and NO
+ * payment goes out at all. The buyer's "never pay more than $X for one read" degrades to a per-leg
+ * bound in the same move.
+ *
+ * So when the signer offers `signTypedDataBatch`, every leg's authorization is built first and the
+ * whole set is signed in ONE call — which is the only shape in which a hosted signer can reserve a
+ * toll atomically and bound it as a citation. The SDK still builds every authorization; only the
+ * moment of signing moves (`gatewayLegPayloadsBatched`).
+ */
+async function gatewayEnvelopes(signer, quoted) {
+    const legs = quoted.legs;
+    if (!legs || legs.length <= 1)
+        return gatewayLegPayload(signer, quoted, 2);
+    // Leg order is the contract: the gate pairs payloads[i] with its own legs[i] and refuses on a
+    // count mismatch, so this must stay a sequential map over `quoted.legs` and never a filter.
+    const legQuotes = legs.map((leg) => ({
+        ...quoted,
+        amountAtomic: leg.amount,
+        requirements: { ...quoted.requirements, payTo: leg.payTo, amount: leg.amount },
+        legs: undefined,
+    }));
+    // A batch-capable signer gets the whole toll in one call. A plain one (a viem account, the
+    // self-host path) keeps the per-leg loop unchanged — it has no grant to protect, and requiring
+    // the method would make an ordinary key unusable.
+    if (signer.signTypedDataBatch) {
+        return gatewayLegPayloadsBatched(signer, legQuotes, 2);
+    }
+    const out = [];
+    for (const legQuote of legQuotes) {
+        out.push(await gatewayLegPayload(signer, legQuote, 2));
+    }
+    return out;
+}
 export function railBuyer(signers) {
     const address = (signers.memo?.address ?? signers.gateway?.address ?? "0x");
     return {
@@ -35,28 +130,7 @@ export function railBuyer(signers) {
             return probe(url, kind, address).then((o) => (o.status === "gated" ? o.quoted : null));
         },
         async fetch(url, kind, guard) {
-            const buildPayment = async (quoted, nowMs) => {
-                if (isGateway402(quoted)) {
-                    if (!signers.gateway) {
-                        throw new Error("no gateway signer for a Circle Gateway 402 (this tenant settles on a memo-less chain)");
-                    }
-                    // gatewayLegPayload owns the N-leg + GatewayWalletBatched guards, so the mixed-fleet
-                    // rail gets the same loud, actionable refusals gatewayBuyer gives (it previously had
-                    // neither, silently dropping extra legs until the gate rejected on leg-count mismatch).
-                    const payload = await gatewayLegPayload(signers.gateway, quoted, 2);
-                    return Buffer.from(JSON.stringify(payload)).toString("base64");
-                }
-                if (!signers.memo) {
-                    throw new Error("no memo signer for a memo-rail 402 (this tenant settles on a memo chain)");
-                }
-                // Resolve the memo chain from the 402's advertised network so a non-fleet memo chain signs
-                // against the right USDC domain (registry: memo = arcTestnet today, but keep it honest). An
-                // unknown CAIP-2 falls back to activeNetwork() inside assembleMemoPayment (undefined triggers the
-                // default). A multi-leg toll signed by a batch-capable injected signer reserves atomically here;
-                // a single leg or a batch-less signer takes the per-leg path — same framing either way.
-                const net = networkByCaip2(quoted.requirements.network);
-                return assembleMemoPayment(quoted, nowMs, signers.memo, net);
-            };
+            const buildPayment = (quoted, nowMs) => assembleRailPayment(quoted, nowMs, signers);
             const onSignError = (error) => {
                 // Parity with memoBuyer/gatewayBuyer: a hosted session signer throws a coded refusal
                 // (grant exhausted/expired/no session) → typed so the agent can act; any other throw (incl.

package/dist/rail.js.map

@@ -1 +1 @@
-{"version":3,"file":"rail.js","sourceRoot":"","sources":["../src/rail.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"rail.js","sourceRoot":"","sources":["../src/rail.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -77,6 +77,11 @@ export interface Source {
     settlementRef?: string;
     /** Citation License `jti` proving this read was paid for (verifiable at the gate). */
     licenseId?: string;
+    /** The page a reader opens to see this record checked against the issuer's published keys, in
+     *  their own browser. THIS is what a citation carries beside the source. */
+    proofUrl?: string;
+    /** The gate's record route for the same settlement — the machine document behind `proofUrl`. */
+    recordUrl?: string;
 }
 export interface RunResult {
     topic: string;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+FAA+F;IAC/F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;mFACmF;AACnF,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,KAAK,EAAE,IAAI,CAAC;CACb;AAED,uEAAuE;AACvE,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAE1D,mEAAmE;AACnE,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd;iFAC6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,8EAA8E;AAC9E,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+FAA+F;IAC/F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;mFACmF;AACnF,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,KAAK,EAAE,IAAI,CAAC;CACb;AAED,uEAAuE;AACvE,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAE1D,mEAAmE;AACnE,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd;iFAC6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,8EAA8E;AAC9E,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;gFAC4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gGAAgG;IAChG,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naulon/wayfarer",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "The naulon paying agent: discover \u2192 quote \u2192 appraise \u2192 decide \u2192 pay \u2192 ground. Budgeted x402 buying over Circle Gateway on Arc, with reusable Citation Licenses (pay once, re-read free).",
   "keywords": [
     "x402",
@@ -42,10 +42,10 @@
     "test": "node --import tsx --test \"src/**/*.test.ts\""
   },
   "dependencies": {
-    "@circle-fin/x402-batching": "^3.4.0",
+    "@circle-fin/x402-batching": "^3.5.0",
     "@langchain/core": "^1.2.9",
     "@langchain/openai": "^1.5.10",
-    "@naulon/shared": "^0.4.0",
+    "@naulon/shared": "^0.5.0",
     "@x402/core": "^2.23.0",
     "@x402/evm": "^2.23.0",
     "viem": "^2.56.0"