@x402r/evm 0.0.1

package/README.md

@@ -0,0 +1,44 @@
+# @x402r/evm
+
+Escrow payment scheme for x402 HTTP 402 flows. Bridges the x402 protocol with x402r escrow contracts on Base.
+
+## Install
+
+```bash
+npm install @x402r/evm
+```
+
+## Usage
+
+### Client — Create payment payloads
+
+```typescript
+import { createPaymentPayload } from "@x402r/evm/escrow/client";
+
+const payload = await createPaymentPayload(requirements, walletClient);
+```
+
+### Server — Register with x402 resource server
+
+```typescript
+import { EscrowServerScheme } from "@x402r/evm/escrow/server";
+
+const scheme = new EscrowServerScheme();
+server.register("eip155:84532", scheme);
+```
+
+## Exports
+
+- `@x402r/evm/escrow/client` — `createPaymentPayload()`, `EscrowScheme`
+- `@x402r/evm/escrow/server` — `EscrowServerScheme`
+- `@x402r/evm/escrow/facilitator` — Settlement and verification
+- `@x402r/evm/escrow/types` — `EscrowExtra`, `EscrowPayload`
+
+## Links
+
+- [Documentation](https://docs.x402r.org)
+- [GitHub](https://github.com/BackTrackCo/x402r-scheme)
+
+## License
+
+MIT

package/dist/escrow/client/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Escrow Scheme - Client
+ * Creates payment payloads for escrow payments
+ */
+import type { WalletClient } from "viem";
+import type { EscrowExtra, EscrowPayload } from "../../shared/types.js";
+export interface PaymentRequirements {
+    scheme: string;
+    network: string;
+    amount: string;
+    asset: `0x${string}`;
+    payTo: `0x${string}`;
+    extra: EscrowExtra;
+}
+/**
+ * Create an escrow payment payload from payment requirements
+ */
+export declare function createPaymentPayload(requirements: PaymentRequirements, wallet: WalletClient): Promise<EscrowPayload>;
+export declare const EscrowScheme: {
+    scheme: "escrow";
+    createPaymentPayload: typeof createPaymentPayload;
+};
+export type { EscrowExtra, EscrowPayload } from "../../shared/types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/escrow/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/escrow/client/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAOzC,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAExE,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,KAAK,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,WAAW,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,mBAAmB,EACjC,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,aAAa,CAAC,CAmDxB;AAED,eAAO,MAAM,YAAY;;;CAGxB,CAAC;AAEF,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/escrow/client/index.js

@@ -0,0 +1,45 @@
+/**
+ * Escrow Scheme - Client
+ * Creates payment payloads for escrow payments
+ */
+import { computeEscrowNonce, signERC3009, generateSalt, } from "../../shared/nonce.js";
+import { MAX_UINT48 } from "../../shared/constants.js";
+/**
+ * Create an escrow payment payload from payment requirements
+ */
+export async function createPaymentPayload(requirements, wallet) {
+    const { escrowAddress, operatorAddress, tokenCollector, minFeeBps = 0, maxFeeBps = 0, feeReceiver, preApprovalExpirySeconds, refundExpirySeconds, authorizationExpirySeconds, } = requirements.extra;
+    const chainId = await wallet.getChainId();
+    const maxAmount = requirements.amount;
+    const paymentInfo = {
+        operator: operatorAddress,
+        receiver: requirements.payTo,
+        token: requirements.asset,
+        maxAmount,
+        preApprovalExpiry: preApprovalExpirySeconds ?? MAX_UINT48,
+        authorizationExpiry: authorizationExpirySeconds ?? MAX_UINT48,
+        refundExpiry: refundExpirySeconds ?? MAX_UINT48,
+        minFeeBps,
+        maxFeeBps,
+        feeReceiver: feeReceiver ?? operatorAddress,
+        salt: generateSalt(),
+    };
+    const nonce = computeEscrowNonce(chainId, escrowAddress, paymentInfo);
+    // ERC-3009 authorization - validBefore MUST match what contract passes to receiveWithAuthorization
+    // The contract uses paymentInfo.preApprovalExpiry as validBefore
+    const authorization = {
+        from: wallet.account.address,
+        to: tokenCollector,
+        value: maxAmount,
+        validAfter: "0",
+        validBefore: String(paymentInfo.preApprovalExpiry),
+        nonce,
+    };
+    const signature = await signERC3009(wallet, authorization, requirements.extra, requirements.asset);
+    return { authorization, signature, paymentInfo };
+}
+export const EscrowScheme = {
+    scheme: "escrow",
+    createPaymentPayload,
+};
+//# sourceMappingURL=index.js.map

package/dist/escrow/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/escrow/client/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,YAAY,GACb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAYvD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,YAAiC,EACjC,MAAoB;IAEpB,MAAM,EACJ,aAAa,EACb,eAAe,EACf,cAAc,EACd,SAAS,GAAG,CAAC,EACb,SAAS,GAAG,CAAC,EACb,WAAW,EACX,wBAAwB,EACxB,mBAAmB,EACnB,0BAA0B,GAC3B,GAAG,YAAY,CAAC,KAAK,CAAC;IAEvB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC;IAEtC,MAAM,WAAW,GAAG;QAClB,QAAQ,EAAE,eAAe;QACzB,QAAQ,EAAE,YAAY,CAAC,KAAK;QAC5B,KAAK,EAAE,YAAY,CAAC,KAAK;QACzB,SAAS;QACT,iBAAiB,EAAE,wBAAwB,IAAI,UAAU;QACzD,mBAAmB,EAAE,0BAA0B,IAAI,UAAU;QAC7D,YAAY,EAAE,mBAAmB,IAAI,UAAU;QAC/C,SAAS;QACT,SAAS;QACT,WAAW,EAAE,WAAW,IAAI,eAAe;QAC3C,IAAI,EAAE,YAAY,EAAE;KACrB,CAAC;IAEF,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;IAEtE,mGAAmG;IACnG,iEAAiE;IACjE,MAAM,aAAa,GAAG;QACpB,IAAI,EAAE,MAAM,CAAC,OAAQ,CAAC,OAAO;QAC7B,EAAE,EAAE,cAAc;QAClB,KAAK,EAAE,SAAS;QAChB,UAAU,EAAE,GAAG;QACf,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,iBAAiB,CAAC;QAClD,KAAK;KACN,CAAC;IAEF,MAAM,SAAS,GAAG,MAAM,WAAW,CACjC,MAAM,EACN,aAAa,EACb,YAAY,CAAC,KAAK,EAClB,YAAY,CAAC,KAAK,CACnB,CAAC;IAEF,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,MAAM,EAAE,QAAiB;IACzB,oBAAoB;CACrB,CAAC"}

package/dist/escrow/facilitator/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Escrow Scheme - Facilitator
+ * Handles verification and settlement of escrow payments.
+ *
+ * Implements x402's SchemeNetworkFacilitator interface so the escrow scheme
+ * is a drop-in for the x402 facilitator, just like ExactEvmScheme.
+ */
+import type { Network, PaymentPayload, PaymentRequirements, SchemeNetworkFacilitator, SettleResponse, VerifyResponse } from "@x402/core/types";
+import type { FacilitatorEvmSigner } from "@x402/evm";
+import { x402Facilitator } from "@x402/core/facilitator";
+/**
+ * Escrow Facilitator Scheme - implements x402's SchemeNetworkFacilitator
+ *
+ * The facilitator is operator-agnostic: it does not store operator/escrow/tokenCollector
+ * config. Those values are set by the merchant via `refundable()` and arrive in
+ * `requirements.extra` at verify/settle time.
+ */
+export declare class EscrowFacilitatorScheme implements SchemeNetworkFacilitator {
+    private signer;
+    readonly scheme = "escrow";
+    readonly caipFamily = "eip155:*";
+    constructor(signer: FacilitatorEvmSigner);
+    getSigners(_network: string): string[];
+    getExtra(_network: string): Record<string, unknown>;
+    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
+    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+}
+/**
+ * Register escrow scheme with x402Facilitator
+ *
+ * The facilitator is operator-agnostic — it supports any operator. Operator,
+ * escrow, and tokenCollector addresses are provided per-request by the merchant
+ * via `refundable()` and arrive in `requirements.extra`.
+ *
+ * @example
+ * ```typescript
+ * const facilitator = new x402Facilitator();
+ * registerEscrowScheme(facilitator, {
+ *   signer: evmSigner,
+ *   networks: "eip155:84532",
+ * });
+ * ```
+ */
+export declare function registerEscrowScheme(facilitator: x402Facilitator, config: {
+    signer: FacilitatorEvmSigner;
+    networks: Network | Network[];
+}): x402Facilitator;
+export type { EscrowExtra, EscrowPayload } from "../../shared/types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/escrow/facilitator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/escrow/facilitator/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,cAAc,EACd,cAAc,EACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAwBzD;;;;;;GAMG;AACH,qBAAa,uBAAwB,YAAW,wBAAwB;IAI1D,OAAO,CAAC,MAAM;IAH1B,QAAQ,CAAC,MAAM,YAAY;IAC3B,QAAQ,CAAC,UAAU,cAAc;gBAEb,MAAM,EAAE,oBAAoB;IAEhD,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAItC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI7C,MAAM,CACV,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,cAAc,CAAC;IAgDpB,MAAM,CACV,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,cAAc,CAAC;CAuD3B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,eAAe,EAC5B,MAAM,EAAE;IACN,MAAM,EAAE,oBAAoB,CAAC;IAC7B,QAAQ,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC;CAC/B,GACA,eAAe,CAMjB;AAED,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/escrow/facilitator/index.js

@@ -0,0 +1,146 @@
+/**
+ * Escrow Scheme - Facilitator
+ * Handles verification and settlement of escrow payments.
+ *
+ * Implements x402's SchemeNetworkFacilitator interface so the escrow scheme
+ * is a drop-in for the x402 facilitator, just like ExactEvmScheme.
+ */
+import { OPERATOR_ABI } from "../../shared/constants.js";
+import { verifyERC3009Signature } from "../../shared/nonce.js";
+/**
+ * Parse chainId from CAIP-2 network identifier
+ * @param network - CAIP-2 network identifier (e.g., 'eip155:84532')
+ * @returns The chain ID as a number
+ */
+function parseChainId(network) {
+    const parts = network.split(":");
+    if (parts.length !== 2 || parts[0] !== "eip155") {
+        throw new Error(`Invalid network format: ${network}. Expected 'eip155:<chainId>'`);
+    }
+    const chainId = parseInt(parts[1], 10);
+    if (isNaN(chainId)) {
+        throw new Error(`Invalid chainId in network: ${network}`);
+    }
+    return chainId;
+}
+/**
+ * Escrow Facilitator Scheme - implements x402's SchemeNetworkFacilitator
+ *
+ * The facilitator is operator-agnostic: it does not store operator/escrow/tokenCollector
+ * config. Those values are set by the merchant via `refundable()` and arrive in
+ * `requirements.extra` at verify/settle time.
+ */
+export class EscrowFacilitatorScheme {
+    signer;
+    scheme = "escrow";
+    caipFamily = "eip155:*";
+    constructor(signer) {
+        this.signer = signer;
+    }
+    getSigners(_network) {
+        return [...this.signer.getAddresses()];
+    }
+    getExtra(_network) {
+        return { name: "USDC", version: "2" };
+    }
+    async verify(payload, requirements) {
+        const escrowPayload = payload.payload;
+        const extra = requirements.extra;
+        const chainId = parseChainId(requirements.network);
+        // Verify ERC-3009 signature
+        const isValidSignature = await verifyERC3009Signature(this.signer, escrowPayload.authorization, escrowPayload.signature, { ...extra, chainId }, requirements.asset);
+        if (!isValidSignature) {
+            return { isValid: false, invalidReason: "Invalid ERC-3009 signature" };
+        }
+        // Verify amount meets requirements
+        if (BigInt(escrowPayload.authorization.value) <
+            BigInt(requirements.amount)) {
+            return { isValid: false, invalidReason: "Insufficient payment amount" };
+        }
+        // Verify token matches
+        if (escrowPayload.paymentInfo.token.toLowerCase() !==
+            requirements.asset.toLowerCase()) {
+            return { isValid: false, invalidReason: "Token mismatch" };
+        }
+        // Verify receiver matches
+        if (escrowPayload.paymentInfo.receiver.toLowerCase() !==
+            requirements.payTo.toLowerCase()) {
+            return { isValid: false, invalidReason: "Receiver mismatch" };
+        }
+        return {
+            isValid: true,
+            payer: escrowPayload.authorization.from,
+        };
+    }
+    async settle(payload, requirements) {
+        const escrowPayload = payload.payload;
+        const extra = requirements.extra;
+        const { authorizeAddress, operatorAddress, tokenCollector } = extra;
+        const paymentInfo = {
+            operator: escrowPayload.paymentInfo.operator,
+            payer: escrowPayload.authorization.from,
+            receiver: escrowPayload.paymentInfo.receiver,
+            token: escrowPayload.paymentInfo.token,
+            maxAmount: BigInt(escrowPayload.paymentInfo.maxAmount),
+            preApprovalExpiry: escrowPayload.paymentInfo.preApprovalExpiry,
+            authorizationExpiry: escrowPayload.paymentInfo.authorizationExpiry,
+            refundExpiry: escrowPayload.paymentInfo.refundExpiry,
+            minFeeBps: escrowPayload.paymentInfo.minFeeBps,
+            maxFeeBps: escrowPayload.paymentInfo.maxFeeBps,
+            feeReceiver: escrowPayload.paymentInfo.feeReceiver,
+            salt: BigInt(escrowPayload.paymentInfo.salt),
+        };
+        // Pass raw signature - ERC3009PaymentCollector expects raw bytes, not ABI-encoded
+        const collectorData = escrowPayload.signature;
+        const target = authorizeAddress ?? operatorAddress;
+        try {
+            const txHash = await this.signer.writeContract({
+                address: target,
+                abi: OPERATOR_ABI,
+                functionName: "authorize",
+                args: [
+                    paymentInfo,
+                    BigInt(escrowPayload.authorization.value),
+                    tokenCollector,
+                    collectorData,
+                ],
+            });
+            return {
+                success: true,
+                transaction: txHash,
+                network: requirements.network,
+                payer: escrowPayload.authorization.from,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                errorReason: error instanceof Error ? error.message : "Settlement failed",
+                transaction: "",
+                network: requirements.network,
+                payer: escrowPayload.authorization.from,
+            };
+        }
+    }
+}
+/**
+ * Register escrow scheme with x402Facilitator
+ *
+ * The facilitator is operator-agnostic — it supports any operator. Operator,
+ * escrow, and tokenCollector addresses are provided per-request by the merchant
+ * via `refundable()` and arrive in `requirements.extra`.
+ *
+ * @example
+ * ```typescript
+ * const facilitator = new x402Facilitator();
+ * registerEscrowScheme(facilitator, {
+ *   signer: evmSigner,
+ *   networks: "eip155:84532",
+ * });
+ * ```
+ */
+export function registerEscrowScheme(facilitator, config) {
+    facilitator.register(config.networks, new EscrowFacilitatorScheme(config.signer));
+    return facilitator;
+}
+//# sourceMappingURL=index.js.map

package/dist/escrow/facilitator/index.js.map

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

package/dist/escrow/server/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Escrow Scheme - Server
+ * Handles price parsing and requirement enhancement for resource servers.
+ *
+ * Implements x402's SchemeNetworkServer interface so it can be registered
+ * on an x402ResourceServer via server.register('eip155:84532', new EscrowServerScheme()).
+ */
+/**
+ * x402 PaymentRequirements (matches @x402/core/types PaymentRequirements)
+ */
+export interface PaymentRequirements {
+    scheme: string;
+    network: string;
+    amount: string;
+    asset: string;
+    payTo: string;
+    maxTimeoutSeconds: number;
+    extra: Record<string, unknown>;
+}
+export interface SupportedKind {
+    x402Version: number;
+    scheme: string;
+    network: string;
+    extra?: Record<string, unknown>;
+}
+/**
+ * x402 AssetAmount (matches @x402/core/types AssetAmount)
+ */
+export interface AssetAmount {
+    asset: string;
+    amount: string;
+    extra?: Record<string, unknown>;
+}
+/**
+ * x402 Price type (matches @x402/core/types Price)
+ */
+export type Price = string | number | AssetAmount;
+export type Network = `${string}:${string}`;
+/**
+ * Server scheme - handles price parsing and requirement enhancement.
+ * Implements x402's SchemeNetworkServer interface.
+ */
+export declare class EscrowServerScheme {
+    readonly scheme = "escrow";
+    private readonly decimals;
+    constructor(config?: {
+        decimals?: number;
+    });
+    /**
+     * Parse a price into an x402 AssetAmount.
+     *
+     * Accepts x402's Price type:
+     * - string: "$0.01", "0.01", "10000"
+     * - number: 0.01
+     * - AssetAmount: { asset: "0x...", amount: "10000" }
+     */
+    parsePrice(price: Price, network: Network): Promise<AssetAmount>;
+    /**
+     * Enhance payment requirements with facilitator's extra fields.
+     *
+     * Merges supportedKind.extra (from facilitator's /supported endpoint) into
+     * the requirements, so escrow addresses flow from facilitator → merchant
+     * requirements automatically.
+     */
+    enhancePaymentRequirements(requirements: PaymentRequirements, supportedKind: SupportedKind, _facilitatorExtensions: string[]): Promise<PaymentRequirements>;
+}
+export type { EscrowExtra, EscrowPayload } from "../../shared/types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/escrow/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/escrow/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;AAElD,MAAM,MAAM,OAAO,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAU5C;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,QAAQ,CAAC,MAAM,YAAY;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;IAI1C;;;;;;;OAOG;IACG,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IAoCtE;;;;;;OAMG;IACG,0BAA0B,CAC9B,YAAY,EAAE,mBAAmB,EACjC,aAAa,EAAE,aAAa,EAC5B,sBAAsB,EAAE,MAAM,EAAE,GAC/B,OAAO,CAAC,mBAAmB,CAAC;CAShC;AAED,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/escrow/server/index.js

@@ -0,0 +1,80 @@
+/**
+ * Escrow Scheme - Server
+ * Handles price parsing and requirement enhancement for resource servers.
+ *
+ * Implements x402's SchemeNetworkServer interface so it can be registered
+ * on an x402ResourceServer via server.register('eip155:84532', new EscrowServerScheme()).
+ */
+/**
+ * Known USDC addresses per network
+ */
+const USDC_ADDRESSES = {
+    "eip155:84532": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+    "eip155:8453": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+};
+/**
+ * Server scheme - handles price parsing and requirement enhancement.
+ * Implements x402's SchemeNetworkServer interface.
+ */
+export class EscrowServerScheme {
+    scheme = "escrow";
+    decimals;
+    constructor(config) {
+        this.decimals = config?.decimals ?? 6; // USDC default
+    }
+    /**
+     * Parse a price into an x402 AssetAmount.
+     *
+     * Accepts x402's Price type:
+     * - string: "$0.01", "0.01", "10000"
+     * - number: 0.01
+     * - AssetAmount: { asset: "0x...", amount: "10000" }
+     */
+    async parsePrice(price, network) {
+        // If already an AssetAmount, pass through
+        if (typeof price === "object" &&
+            price !== null &&
+            "amount" in price &&
+            "asset" in price) {
+            return price;
+        }
+        // Convert to number for calculation
+        let numericAmount;
+        if (typeof price === "number") {
+            numericAmount = price;
+        }
+        else {
+            const cleaned = String(price).replace(/[$,]/g, "").trim();
+            numericAmount = parseFloat(cleaned);
+        }
+        if (isNaN(numericAmount)) {
+            throw new Error(`Cannot parse price: ${price}`);
+        }
+        const rawAmount = BigInt(Math.round(numericAmount * 10 ** this.decimals));
+        const asset = USDC_ADDRESSES[network];
+        if (!asset) {
+            throw new Error(`No USDC address configured for network: ${network}`);
+        }
+        return {
+            asset,
+            amount: rawAmount.toString(),
+        };
+    }
+    /**
+     * Enhance payment requirements with facilitator's extra fields.
+     *
+     * Merges supportedKind.extra (from facilitator's /supported endpoint) into
+     * the requirements, so escrow addresses flow from facilitator → merchant
+     * requirements automatically.
+     */
+    async enhancePaymentRequirements(requirements, supportedKind, _facilitatorExtensions) {
+        return {
+            ...requirements,
+            extra: {
+                ...supportedKind.extra,
+                ...requirements.extra,
+            },
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/escrow/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/escrow/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwCH;;GAEG;AACH,MAAM,cAAc,GAA2B;IAC7C,cAAc,EAAE,4CAA4C;IAC5D,aAAa,EAAE,4CAA4C;CAC5D,CAAC;AAEF;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IACpB,MAAM,GAAG,QAAQ,CAAC;IACV,QAAQ,CAAS;IAElC,YAAY,MAA8B;QACxC,IAAI,CAAC,QAAQ,GAAG,MAAM,EAAE,QAAQ,IAAI,CAAC,CAAC,CAAC,eAAe;IACxD,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,UAAU,CAAC,KAAY,EAAE,OAAgB;QAC7C,0CAA0C;QAC1C,IACE,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACd,QAAQ,IAAI,KAAK;YACjB,OAAO,IAAI,KAAK,EAChB,CAAC;YACD,OAAO,KAAoB,CAAC;QAC9B,CAAC;QAED,oCAAoC;QACpC,IAAI,aAAqB,CAAC;QAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,aAAa,GAAG,KAAK,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1D,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,EAAE,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC1E,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,2CAA2C,OAAO,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,OAAO;YACL,KAAK;YACL,MAAM,EAAE,SAAS,CAAC,QAAQ,EAAE;SAC7B,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,0BAA0B,CAC9B,YAAiC,EACjC,aAA4B,EAC5B,sBAAgC;QAEhC,OAAO;YACL,GAAG,YAAY;YACf,KAAK,EAAE;gBACL,GAAG,aAAa,CAAC,KAAK;gBACtB,GAAG,YAAY,CAAC,KAAK;aACtB;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/shared/constants.d.ts

@@ -0,0 +1,98 @@
+export declare const ZERO_ADDRESS: "0x0000000000000000000000000000000000000000";
+export declare const MAX_UINT48 = 281474976710655;
+export declare const MAX_UINT32 = 4294967295;
+export declare const PAYMENT_INFO_COMPONENTS: readonly [{
+    readonly name: "operator";
+    readonly type: "address";
+}, {
+    readonly name: "payer";
+    readonly type: "address";
+}, {
+    readonly name: "receiver";
+    readonly type: "address";
+}, {
+    readonly name: "token";
+    readonly type: "address";
+}, {
+    readonly name: "maxAmount";
+    readonly type: "uint120";
+}, {
+    readonly name: "preApprovalExpiry";
+    readonly type: "uint48";
+}, {
+    readonly name: "authorizationExpiry";
+    readonly type: "uint48";
+}, {
+    readonly name: "refundExpiry";
+    readonly type: "uint48";
+}, {
+    readonly name: "minFeeBps";
+    readonly type: "uint16";
+}, {
+    readonly name: "maxFeeBps";
+    readonly type: "uint16";
+}, {
+    readonly name: "feeReceiver";
+    readonly type: "address";
+}, {
+    readonly name: "salt";
+    readonly type: "uint256";
+}];
+export declare const OPERATOR_ABI: readonly [{
+    readonly name: "authorize";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "paymentInfo";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "operator";
+            readonly type: "address";
+        }, {
+            readonly name: "payer";
+            readonly type: "address";
+        }, {
+            readonly name: "receiver";
+            readonly type: "address";
+        }, {
+            readonly name: "token";
+            readonly type: "address";
+        }, {
+            readonly name: "maxAmount";
+            readonly type: "uint120";
+        }, {
+            readonly name: "preApprovalExpiry";
+            readonly type: "uint48";
+        }, {
+            readonly name: "authorizationExpiry";
+            readonly type: "uint48";
+        }, {
+            readonly name: "refundExpiry";
+            readonly type: "uint48";
+        }, {
+            readonly name: "minFeeBps";
+            readonly type: "uint16";
+        }, {
+            readonly name: "maxFeeBps";
+            readonly type: "uint16";
+        }, {
+            readonly name: "feeReceiver";
+            readonly type: "address";
+        }, {
+            readonly name: "salt";
+            readonly type: "uint256";
+        }];
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "tokenCollector";
+        readonly type: "address";
+    }, {
+        readonly name: "collectorData";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
+}];
+export declare const TRANSFER_WITH_AUTHORIZATION_TYPEHASH: "0x7c7c6cdb67a18743f49ec6fa9b35f50d52ed05cbed4cc592e13b44501c1a2267";
+//# sourceMappingURL=constants.d.ts.map

package/dist/shared/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/shared/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,EACvB,4CAAqD,CAAC;AACxD,eAAO,MAAM,UAAU,kBAAkB,CAAC;AAC1C,eAAO,MAAM,UAAU,aAAa,CAAC;AAGrC,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa1B,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBf,CAAC;AAGX,eAAO,MAAM,oCAAoC,EAC/C,oEAA6E,CAAC"}

package/dist/shared/constants.js

@@ -0,0 +1,39 @@
+export const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+export const MAX_UINT48 = 281474976710655;
+export const MAX_UINT32 = 4294967295;
+// PaymentInfo struct for AuthCaptureEscrow (matches commerce-payments contract)
+export const PAYMENT_INFO_COMPONENTS = [
+    { name: "operator", type: "address" },
+    { name: "payer", type: "address" },
+    { name: "receiver", type: "address" },
+    { name: "token", type: "address" },
+    { name: "maxAmount", type: "uint120" },
+    { name: "preApprovalExpiry", type: "uint48" },
+    { name: "authorizationExpiry", type: "uint48" },
+    { name: "refundExpiry", type: "uint48" },
+    { name: "minFeeBps", type: "uint16" },
+    { name: "maxFeeBps", type: "uint16" },
+    { name: "feeReceiver", type: "address" },
+    { name: "salt", type: "uint256" },
+];
+export const OPERATOR_ABI = [
+    {
+        name: "authorize",
+        type: "function",
+        stateMutability: "nonpayable",
+        inputs: [
+            {
+                name: "paymentInfo",
+                type: "tuple",
+                components: PAYMENT_INFO_COMPONENTS,
+            },
+            { name: "amount", type: "uint256" },
+            { name: "tokenCollector", type: "address" },
+            { name: "collectorData", type: "bytes" },
+        ],
+        outputs: [],
+    },
+];
+// ERC-3009 TransferWithAuthorization type hash
+export const TRANSFER_WITH_AUTHORIZATION_TYPEHASH = "0x7c7c6cdb67a18743f49ec6fa9b35f50d52ed05cbed4cc592e13b44501c1a2267";
+//# sourceMappingURL=constants.js.map

package/dist/shared/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/shared/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GACvB,4CAAqD,CAAC;AACxD,MAAM,CAAC,MAAM,UAAU,GAAG,eAAe,CAAC;AAC1C,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC;AAErC,gFAAgF;AAChF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;IACrC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;IAClC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;IACrC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;IAClC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;IACtC,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC7C,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC/C,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE;IACxC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE;IACrC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE;IACrC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;IACxC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE;CACzB,CAAC;AAEX,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B;QACE,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,YAAY;QAC7B,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,OAAO;gBACb,UAAU,EAAE,uBAAuB;aACpC;YACD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;YACnC,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE;YAC3C,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,EAAE;SACzC;QACD,OAAO,EAAE,EAAE;KACZ;CACO,CAAC;AAEX,+CAA+C;AAC/C,MAAM,CAAC,MAAM,oCAAoC,GAC/C,oEAA6E,CAAC"}