@agirails/sdk 4.0.0-beta.9 → 4.1.0

package/dist/receipts/push.js

@@ -0,0 +1,167 @@
+"use strict";
+/**
+ * Buyer-visible settlement receipt — SDK push path.
+ *
+ * On SETTLED state transition, the SDK posts a V2-signed receipt to the
+ * AGIRAILS Platform. The response includes a clickable receipt URL which the
+ * CLI prints to the terminal — the wow moment.
+ *
+ * Integration points (sdk-js team):
+ *   1. Import this module from wherever lifecycle reaches SETTLED
+ *      (likely src/api/level1/Agent.ts or src/runtime/BlockchainRuntime.ts).
+ *   2. After the on-chain state advances to SETTLED, call:
+ *        const { receiptUrl } = await pushReceiptOnSettled({...});
+ *   3. Surface receiptUrl on the public RequestResult and to CLI commands
+ *      (pay, test, serve) so they print it.
+ *
+ * Non-goals:
+ *   - This module does NOT change the lifecycle itself.
+ *   - Failure is non-fatal: settlement already happened on-chain; the Platform
+ *     indexer cron is the backstop for cases where this POST fails.
+ *
+ * Auth: V2 EIP-712 signature, requester wallet (when SDK acts as requester) or
+ *   provider wallet (when SDK acts as provider). The Platform's POST handler
+ *   verifies the signer matches participantRole, AND independently verifies
+ *   on-chain that the tx really exists with claimed values. Forgery is not
+ *   possible without on-chain truth.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatSettledLine = exports.pushReceiptOnSettled = exports.RECEIPT_WRITE_TYPES_V2 = exports.RECEIPT_WRITE_DOMAIN_V2 = void 0;
+// ──────────────────────────────────────────────────────────────────────────
+// EIP-712 V2 — must match Platform/agirails.app/web/lib/receipts/eip712.ts
+// ──────────────────────────────────────────────────────────────────────────
+exports.RECEIPT_WRITE_DOMAIN_V2 = {
+    name: "AGIRAILS Receipts",
+    version: "2",
+};
+exports.RECEIPT_WRITE_TYPES_V2 = {
+    ReceiptWriteV2: [
+        { name: "signerAddress", type: "address" },
+        { name: "participantRole", type: "string" },
+        { name: "providerAddress", type: "address" },
+        { name: "requesterAddress", type: "address" },
+        { name: "kernelAddress", type: "address" },
+        { name: "txId", type: "bytes32" },
+        { name: "network", type: "string" },
+        { name: "amountWei", type: "uint256" },
+        { name: "feeWei", type: "uint256" },
+        { name: "netWei", type: "uint256" },
+        { name: "serviceHash", type: "bytes32" },
+        { name: "nonce", type: "string" },
+        { name: "issuedAt", type: "uint64" },
+    ],
+};
+const ZERO_BYTES32 = "0x" + "0".repeat(64);
+function chainIdForNetwork(network) {
+    return network === "base-mainnet" ? 8453 : 84532;
+}
+async function pushReceiptOnSettled(args) {
+    // Resolution priority: explicit arg > AGIRAILS_BASE_URL env > prod default.
+    // Matches the env-driven origin convention already used by cli/receiptUpload.ts.
+    const apiBase = (args.apiBase ?? process.env.AGIRAILS_BASE_URL ?? "https://agirails.app").replace(/\/+$/, "");
+    const signerAddress = await args.signer.getAddress();
+    try {
+        // 1) Fetch a single-use nonce bound to the signer wallet.
+        const prepRes = await fetch(`${apiBase}/api/v1/receipts/prepare`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ signerAddress }),
+        });
+        if (!prepRes.ok)
+            throw new Error(`prepare_failed:${prepRes.status}`);
+        const { nonce } = (await prepRes.json());
+        const issuedAt = Math.floor(Date.now() / 1000);
+        const payload = {
+            signerAddress,
+            participantRole: args.participantRole,
+            providerAddress: args.providerAddress,
+            requesterAddress: args.requesterAddress,
+            kernelAddress: args.kernelAddress,
+            txId: args.txId,
+            network: args.network,
+            amountWei: args.amountWei,
+            feeWei: args.feeWei,
+            netWei: args.netWei,
+            serviceHash: args.serviceHash ?? ZERO_BYTES32,
+            nonce,
+            issuedAt,
+        };
+        // 2) EIP-712 V2 sign — domain chainId is part of the binding.
+        const domain = {
+            ...exports.RECEIPT_WRITE_DOMAIN_V2,
+            chainId: chainIdForNetwork(args.network),
+        };
+        const signature = await args.signer.signTypedData(domain, exports.RECEIPT_WRITE_TYPES_V2, payload);
+        // 3) POST receipt. Body fields match the payload; server reconstructs
+        //    and verifies them against the signature.
+        const postRes = await fetch(`${apiBase}/api/v1/receipts`, {
+            method: "POST",
+            headers: {
+                "X-Agent-Address": signerAddress,
+                "X-Agent-Signature": signature,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                participantRole: args.participantRole,
+                signerAddress,
+                agentAddress: args.providerAddress,
+                requesterAddress: args.requesterAddress,
+                kernelAddress: args.kernelAddress,
+                txId: args.txId,
+                network: args.network,
+                amountWei: args.amountWei,
+                feeWei: args.feeWei,
+                netWei: args.netWei,
+                serviceHash: args.serviceHash,
+                ethTxHash: args.ethTxHash,
+                blockNumber: args.blockNumber,
+                logIndex: args.logIndex,
+                service: args.service,
+                durationMs: args.durationMs,
+                agentSignature: signature,
+                agentSignatureAlgorithm: "EIP712-ReceiptV2",
+                nonce,
+                issuedAt,
+            }),
+        });
+        if (!postRes.ok) {
+            // Common failure modes documented for SDK error handler:
+            //   401 — signature / signer / nonce invalid (likely SDK bug)
+            //   403 — role / address mismatch (SDK is signing as wrong wallet)
+            //   404 — agent not registered (buyer-side fresh-wallet path; expected,
+            //         caller should still log the txId for indexer fallback)
+            //   422 — on_chain_verification_failed (RPC desync; transient — retry)
+            //   429 — rate limited (back off)
+            throw new Error(`post_failed:${postRes.status}`);
+        }
+        const body = (await postRes.json());
+        return {
+            receiptUrl: body.url ?? null,
+            receiptId: body.id ?? null,
+            verifiedOnChain: !!body.verified_on_chain,
+        };
+    }
+    catch {
+        // Receipt POST failure is non-fatal — settlement already happened on-chain.
+        // Indexer cron at /api/cron/index-stats backfills receipt rows within ~5min.
+        // Surface null so the CLI knows not to print a URL.
+        return { receiptUrl: null, receiptId: null, verifiedOnChain: false };
+    }
+}
+exports.pushReceiptOnSettled = pushReceiptOnSettled;
+/**
+ * Format the one-line CLI summary the buyer or provider sees at SETTLED.
+ * Returns the line as a string; the CLI prints it. URL is omitted if null
+ * (indexer backstop will eventually mint a receipt but we have no PK for it).
+ */
+function formatSettledLine(args) {
+    const action = args.participantRole === "provider"
+        ? `Earned ${args.netDisplay} from ${args.counterpartyDisplay}`
+        : `Paid ${args.grossDisplay} to ${args.counterpartyDisplay}`;
+    if (args.receiptUrl) {
+        return `[SETTLED] ${action}\n           Receipt: ${args.receiptUrl}`;
+    }
+    return `[SETTLED] ${action}`;
+}
+exports.formatSettledLine = formatSettledLine;
+//# sourceMappingURL=push.js.map

package/dist/receipts/push.js.map

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

package/dist/wallet/IWalletProvider.d.ts

@@ -29,7 +29,7 @@ export interface TransactionReceipt {
     success: boolean;
 }
 /**
- * Wallet tier — determines gas behavior.
+ * Wallet tier: determines gas behavior.
  */
 export type WalletTier = 'auto' | 'eoa';
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agirails/sdk",
-  "version": "4.0.0-beta.9",
+  "version": "4.1.0",
   "description": "AGIRAILS SDK for the ACTP (Agent Commerce Transaction Protocol) - Unified mock + blockchain support",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -46,6 +46,10 @@
     "README.md",
     "LICENSE"
   ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
   "scripts": {
     "build": "tsc",
     "test": "jest --runInBand",
@@ -84,7 +88,7 @@
   "homepage": "https://github.com/agirails/sdk-js#readme",
   "dependencies": {
     "@aws-sdk/client-s3": "^3.1030.0",
-    "@ethereum-attestation-service/eas-sdk": "1.6.1",
+    "@ethereum-attestation-service/eas-sdk": "^2.9.0",
     "@irys/sdk": "0.2.11",
     "@x402/core": "~2.9.0",
     "@x402/evm": "~2.9.0",
@@ -125,6 +129,10 @@
   },
   "overrides": {
     "axios": "^1.15.0",
-    "fast-xml-parser": "^5.3.5"
+    "fast-xml-parser": "^5.3.5",
+    "undici": "^6.25.0",
+    "serialize-javascript": "^7.0.5",
+    "mocha": "^11.0.0",
+    "uuid": "^9.0.1"
   }
 }

package/dist/__tests__/helpers/mockX402Server.d.ts

@@ -1,67 +0,0 @@
-/**
- * Raw node:http mock x402 v2 server for unit/integration tests.
- *
- * Returns a 402 `payment-required` response, verifies that the retry carries
- * a `payment-signature` header, and replies with a mock `payment-response`
- * header so tests can validate the buyer-side parse/sign/retry/map loop end
- * to end without touching a real facilitator or on-chain settlement.
- *
- * Design notes:
- * - Raw `node:http`, no Express dependency. Keeps the test surface small and
- *   isolates "what we're testing" (our X402Adapter) from upstream middleware.
- * - Payload is Base64-encoded JSON matching the x402 v2 wire format.
- * - Factory signature supports both EIP-3009 (`extra.assetTransferMethod` omitted)
- *   and Permit2 (`extra.assetTransferMethod = "permit2"`) scenarios via options.
- * - Server listens on a random port (port 0) so multiple tests can run in parallel.
- *
- * @module __tests__/helpers/mockX402Server
- */
-export interface MockX402ServerOptions {
-    /** CAIP-2 network. Default: "eip155:84532" (Base Sepolia) */
-    network?: string;
-    /** USDC amount as string (6 decimals). Default: "10000" (0.01 USDC) */
-    amount?: string;
-    /** Token contract address. Default: Base Sepolia USDC */
-    asset?: string;
-    /** Payment destination. Default: test provider address */
-    payTo?: string;
-    /** Set Permit2 transfer method. Default: EIP-3009 */
-    permit2?: boolean;
-    /** maxTimeoutSeconds advertised in requirements. Default: 300 */
-    maxTimeoutSeconds?: number;
-    /** Settlement tx hash returned in payment-response. Default: "0xmockhash" */
-    settlementTxHash?: string;
-    /**
-     * When true, the retry request will receive HTTP 200 but NO payment-response
-     * header. Used to test X402SettlementProofMissingError handling.
-     */
-    omitPaymentResponse?: boolean;
-}
-export interface MockX402ServerHandle {
-    url: string;
-    port: number;
-    close: () => Promise<void>;
-    /** Count of initial 402 hits (useful for retry verification) */
-    getInitialRequestCount: () => number;
-    /** Count of retry requests (carrying payment-signature) */
-    getRetryRequestCount: () => number;
-}
-/**
- * Start a mock x402 v2 server on a random localhost port.
- *
- * Returns a handle with `.url` (e.g., `http://localhost:54321`), `.close()`
- * to tear down, and counters for asserting the number of round-trips.
- *
- * @example
- * ```ts
- * const server = await startMockX402Server({ permit2: true });
- * try {
- *   const res = await fetch(server.url);
- *   expect(res.status).toBe(402);
- * } finally {
- *   await server.close();
- * }
- * ```
- */
-export declare function startMockX402Server(options?: MockX402ServerOptions): Promise<MockX402ServerHandle>;
-//# sourceMappingURL=mockX402Server.d.ts.map

package/dist/__tests__/helpers/mockX402Server.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mockX402Server.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/mockX402Server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,MAAM,WAAW,qBAAqB;IACpC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,gEAAgE;IAChE,sBAAsB,EAAE,MAAM,MAAM,CAAC;IACrC,2DAA2D;IAC3D,oBAAoB,EAAE,MAAM,MAAM,CAAC;CACpC;AAKD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,oBAAoB,CAAC,CA6D/B"}

package/dist/__tests__/helpers/mockX402Server.js

@@ -1,121 +0,0 @@
-"use strict";
-/**
- * Raw node:http mock x402 v2 server for unit/integration tests.
- *
- * Returns a 402 `payment-required` response, verifies that the retry carries
- * a `payment-signature` header, and replies with a mock `payment-response`
- * header so tests can validate the buyer-side parse/sign/retry/map loop end
- * to end without touching a real facilitator or on-chain settlement.
- *
- * Design notes:
- * - Raw `node:http`, no Express dependency. Keeps the test surface small and
- *   isolates "what we're testing" (our X402Adapter) from upstream middleware.
- * - Payload is Base64-encoded JSON matching the x402 v2 wire format.
- * - Factory signature supports both EIP-3009 (`extra.assetTransferMethod` omitted)
- *   and Permit2 (`extra.assetTransferMethod = "permit2"`) scenarios via options.
- * - Server listens on a random port (port 0) so multiple tests can run in parallel.
- *
- * @module __tests__/helpers/mockX402Server
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.startMockX402Server = void 0;
-const node_http_1 = require("node:http");
-const BASE_SEPOLIA_USDC = '0x036CbD53842c5426634e7929541eC2318f3dCF7e';
-const DEFAULT_PAY_TO = '0x0000000000000000000000000000000000000001';
-/**
- * Start a mock x402 v2 server on a random localhost port.
- *
- * Returns a handle with `.url` (e.g., `http://localhost:54321`), `.close()`
- * to tear down, and counters for asserting the number of round-trips.
- *
- * @example
- * ```ts
- * const server = await startMockX402Server({ permit2: true });
- * try {
- *   const res = await fetch(server.url);
- *   expect(res.status).toBe(402);
- * } finally {
- *   await server.close();
- * }
- * ```
- */
-function startMockX402Server(options = {}) {
-    const payload = buildPaymentRequiredPayload(options);
-    const encodedPayload = Buffer.from(JSON.stringify(payload)).toString('base64');
-    const settlementResponse = {
-        transaction: options.settlementTxHash ?? '0xmockhash',
-        network: options.network ?? 'eip155:84532',
-        amount: options.amount ?? '10000',
-        payer: '0xmockbuyer',
-        payTo: options.payTo ?? DEFAULT_PAY_TO,
-    };
-    const encodedResponse = Buffer.from(JSON.stringify(settlementResponse)).toString('base64');
-    let initialRequestCount = 0;
-    let retryRequestCount = 0;
-    return new Promise((resolve, reject) => {
-        const server = (0, node_http_1.createServer)((req, res) => {
-            const hasPaymentSignature = Boolean(req.headers['payment-signature']) ||
-                Boolean(req.headers['x-payment']) ||
-                Boolean(req.headers['PAYMENT-SIGNATURE']);
-            if (!hasPaymentSignature) {
-                // First hit — return 402 with payment-required
-                initialRequestCount++;
-                res.statusCode = 402;
-                res.setHeader('content-type', 'application/json');
-                res.setHeader('payment-required', encodedPayload);
-                res.end('{}');
-                return;
-            }
-            // Retry with signed payment — accept and return settlement proof
-            retryRequestCount++;
-            res.statusCode = 200;
-            res.setHeader('content-type', 'application/json');
-            if (!options.omitPaymentResponse) {
-                res.setHeader('payment-response', encodedResponse);
-            }
-            res.end(JSON.stringify({ ok: true }));
-        });
-        server.on('error', (err) => reject(err));
-        server.listen(0, '127.0.0.1', () => {
-            const address = server.address();
-            resolve({
-                url: `http://127.0.0.1:${address.port}`,
-                port: address.port,
-                close: () => new Promise((r) => {
-                    server.close(() => r());
-                }),
-                getInitialRequestCount: () => initialRequestCount,
-                getRetryRequestCount: () => retryRequestCount,
-            });
-        });
-    });
-}
-exports.startMockX402Server = startMockX402Server;
-function buildPaymentRequiredPayload(options) {
-    const network = options.network ?? 'eip155:84532';
-    const extra = { name: 'USDC', version: '2' };
-    if (options.permit2) {
-        extra.assetTransferMethod = 'permit2';
-    }
-    return {
-        x402Version: 2,
-        error: 'Payment required',
-        resource: {
-            url: 'http://mock/x402',
-            description: 'Mock x402 v2 test endpoint',
-            mimeType: 'application/json',
-        },
-        accepts: [
-            {
-                scheme: 'exact',
-                network,
-                amount: options.amount ?? '10000',
-                asset: options.asset ?? BASE_SEPOLIA_USDC,
-                payTo: options.payTo ?? DEFAULT_PAY_TO,
-                maxTimeoutSeconds: options.maxTimeoutSeconds ?? 300,
-                extra,
-            },
-        ],
-    };
-}
-//# sourceMappingURL=mockX402Server.js.map

package/dist/__tests__/helpers/mockX402Server.js.map

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