@agirails/sdk 4.0.0 → 4.1.1

package/dist/adapters/BaseAdapter.d.ts

@@ -66,7 +66,7 @@ export declare const MAX_DEADLINE_DAYS = 3650;
  */
 import { ValidationError as ACTPValidationError } from '../errors';
 /**
- * Adapter-layer ValidationError — extends ACTPError-based ValidationError
+ * Adapter-layer ValidationError: extends ACTPError-based ValidationError
  * so that `instanceof` checks work against the public SDK export.
  * Accepts a single message string for convenience in adapter code.
  */

package/dist/adapters/BaseAdapter.js

@@ -73,7 +73,7 @@ exports.MAX_DEADLINE_DAYS = 3650; // 10 years
  */
 const errors_1 = require("../errors");
 /**
- * Adapter-layer ValidationError — extends ACTPError-based ValidationError
+ * Adapter-layer ValidationError: extends ACTPError-based ValidationError
  * so that `instanceof` checks work against the public SDK export.
  * Accepts a single message string for convenience in adapter code.
  */

package/dist/builders/CounterOfferBuilder.d.ts

@@ -20,7 +20,7 @@
 import { Signer } from 'ethers';
 import { NonceManager } from '../utils/NonceManager';
 /**
- * Counter-offer message — the buyer's reply to a provider quote.
+ * Counter-offer message: the buyer's reply to a provider quote.
  *
  * Field shape mirrors QuoteMessage where it makes sense (txId, currency,
  * decimals, chainId, nonce, signature) but flips provider/consumer
@@ -28,7 +28,7 @@ import { NonceManager } from '../utils/NonceManager';
  * a (typically lower) price.
  *
  * `quotedAmount` from the original provider quote is preserved as
- * `quoteAmount` for unambiguous binding — the verifier can confirm this
+ * `quoteAmount` for unambiguous binding, so the verifier can confirm this
  * counter is in response to the exact quote it claims to be.
  */
 export interface CounterOfferMessage {

package/dist/cli/commands/test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAY,MAAM,iBAAiB,CAAC;AAiBnD,wBAAgB,iBAAiB,IAAI,OAAO,CAwE3C;AAMD;;;;;;;GAOG;AACH,iBAAe,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiEpD;AAeD,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAY,MAAM,iBAAiB,CAAC;AAiBnD,wBAAgB,iBAAiB,IAAI,OAAO,CAwE3C;AAMD;;;;;;;GAOG;AACH,iBAAe,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4EpD;AAeD,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/cli/commands/test.js

@@ -120,11 +120,13 @@ async function runTest(output) {
     output.print(`  network: base-sepolia (source: ${sentinel.source})`);
     output.print('');
     // 3. Hit Sentinel via the shared Level 1 requester flow. Sentinel's
-    //    covenant is $0.05 USDC for the onboarding service; PRD §5.6 quote
-    //    timeout default (30s) is generous on Base Sepolia.
+    //    covenant is $10 USDC for the onboarding service ($10–$100 band).
+    //    Picked to clear the 1%/$0.05 fee floor so receipts show a real
+    //    net earning instead of "$0 earned". PRD §5.6 quote timeout
+    //    default (30s) is generous on Base Sepolia.
     const result = await (0, runRequest_1.runRequest)({
         provider: sentinel.address,
-        amount: '0.05',
+        amount: '10',
         service: 'onboarding',
         network: 'testnet',
         autoAccept: true,
@@ -145,6 +147,7 @@ async function runTest(output) {
         settled: result.settled,
         reflection,
         payload: result.payload,
+        receiptUrl: result.receiptUrl,
     }, { quietKey: 'reflection' });
     // Footer wording is conditional on what actually happened. The
     // structured JSON output above always reports `settled`, but human-mode
@@ -165,6 +168,13 @@ async function runTest(output) {
         output.blank();
         output.success(`Settled in ${result.elapsedMs} ms`);
     }
+    // Receipt URL — the wow artifact. Only present when the buyer-side V2
+    // push succeeded (real on-chain network + signer). Silent when null:
+    // either mock, or the push failed (indexer cron is the backstop).
+    if (result.receiptUrl) {
+        output.blank();
+        output.print(`Receipt: ${result.receiptUrl}`);
+    }
 }
 exports.runTest = runTest;
 function extractReflection(payload) {

package/dist/cli/commands/test.js.map

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

package/dist/cli/lib/runRequest.d.ts

@@ -93,6 +93,18 @@ export interface RunRequestResult {
     payload?: unknown;
     /** Whether the requester settled the escrow before returning. */
     settled: boolean;
+    /**
+     * Absolute public receipt URL (https://agirails.app/r/r_...) when the
+     * buyer-side V2 push to the AGIRAILS Platform succeeded after SETTLED.
+     *
+     * null when:
+     *   - settle did not complete (no receipt to share)
+     *   - the push failed (network error, 422 verify, etc.) — the Platform
+     *     indexer cron is the backstop and will mint a row within ~5min,
+     *     just no URL handy for the immediate CLI moment
+     *   - network is 'mock' (no real chain ⇒ no real receipt to publish)
+     */
+    receiptUrl: string | null;
 }
 /**
  * Execute a Level 1 negotiated request end-to-end.

package/dist/cli/lib/runRequest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runRequest.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/runRequest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAKH,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,yCAAyC;IACzC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,KAAK,IAAI,CAAC;CAC1E;AAED,qBAAa,iBAAkB,SAAQ,KAAK;aACd,IAAI,EAAE,MAAM;aAAkB,SAAS,EAAE,MAAM;gBAA/C,IAAI,EAAE,MAAM,EAAkB,SAAS,EAAE,MAAM;CAQ5E;AAED,qBAAa,oBAAqB,SAAQ,KAAK;aAE3B,IAAI,EAAE,MAAM;aACZ,SAAS,EAAE,MAAM;aACjB,SAAS,EAAE,gBAAgB;gBAF3B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,gBAAgB;CAQ9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,UAAU,EAAE,gBAAgB,CAAC;IAC7B,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAC;CAClB;AAKD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsLnF"}
+{"version":3,"file":"runRequest.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/runRequest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAKH,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,yCAAyC;IACzC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,KAAK,IAAI,CAAC;CAC1E;AAED,qBAAa,iBAAkB,SAAQ,KAAK;aACd,IAAI,EAAE,MAAM;aAAkB,SAAS,EAAE,MAAM;gBAA/C,IAAI,EAAE,MAAM,EAAkB,SAAS,EAAE,MAAM;CAQ5E;AAED,qBAAa,oBAAqB,SAAQ,KAAK;aAE3B,IAAI,EAAE,MAAM;aACZ,SAAS,EAAE,MAAM;aACjB,SAAS,EAAE,gBAAgB;gBAF3B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,gBAAgB;CAQ9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,UAAU,EAAE,gBAAgB,CAAC;IAC7B,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;;;;;;OAUG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAKD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+OnF"}

package/dist/cli/lib/runRequest.js

@@ -257,12 +257,67 @@ async function runRequest(opts) {
             });
         }
     }
+    // 12. Buyer-visible settlement receipt push — the wow flow.
+    //
+    // On SETTLED with a real on-chain network and a real signer, post the
+    // requester-side receipt to the AGIRAILS Platform. The Platform verifies
+    // the V2 signature, independently confirms with the kernel that the tx
+    // matches (forgery defense), then mints a row and returns a clickable
+    // public URL.
+    //
+    // Failure is intentionally non-fatal: the settlement already happened
+    // on-chain, and the Platform indexer cron is the backstop. The CLI just
+    // can't print a URL for this specific tx if the push failed.
+    let receiptUrl = null;
+    if (settled && privateKey && (network === 'testnet' || network === 'mainnet')) {
+        try {
+            const { pushReceiptOnSettled } = await Promise.resolve().then(() => __importStar(require('../../receipts/push')));
+            const { computeDisplayFee } = await Promise.resolve().then(() => __importStar(require('../../config/defaults')));
+            const { getNetwork } = await Promise.resolve().then(() => __importStar(require('../../config/networks')));
+            const networkName = network === 'testnet' ? 'base-sepolia' : 'base-mainnet';
+            const kernelAddress = getNetwork(networkName).contracts.actpKernel;
+            const amountWeiBig = BigInt(amountWei);
+            const feeWeiBig = computeDisplayFee(amountWeiBig);
+            // Clamp net to zero for dust amounts where fee >= amount; matches
+            // the Platform-side receipts_net_wei_nonneg CHECK constraint.
+            const netWeiBig = amountWeiBig > feeWeiBig ? amountWeiBig - feeWeiBig : 0n;
+            // The on-chain requester is `client.info.address` — the smart wallet
+            // when AutoWallet is active, or the EOA in Tier 2/3. The local
+            // `requesterAddress` var above is always the EOA when privateKey is
+            // set, so passing it would mismatch on-chain state and fail the
+            // server's assertOnChainMatches check (silently nulling receiptUrl).
+            const push = await pushReceiptOnSettled({
+                signer: new ethers_1.Wallet(privateKey),
+                participantRole: 'requester',
+                providerAddress,
+                requesterAddress: client.info.address,
+                kernelAddress,
+                txId,
+                network: networkName,
+                amountWei: amountWeiBig.toString(),
+                feeWei: feeWeiBig.toString(),
+                netWei: netWeiBig.toString(),
+                serviceHash,
+                service: normalizedService,
+                durationMs: Date.now() - startedAt,
+            });
+            receiptUrl = push.receiptUrl;
+        }
+        catch (err) {
+            // Non-fatal: log and continue. The indexer cron is the backstop.
+            logger.warn('Buyer-side receipt push failed; indexer will backfill', {
+                txId,
+                err: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
     return {
         txId,
         finalState,
         elapsedMs: Date.now() - startedAt,
         payload,
         settled,
+        receiptUrl,
     };
 }
 exports.runRequest = runRequest;

package/dist/cli/lib/runRequest.js.map

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

package/dist/errors/X402Errors.d.ts

@@ -21,6 +21,10 @@ export declare class X402Error extends ACTPError {
  *
  * Most common cause: walletProvider does not implement the optional
  * `signTypedData()` method that x402 v2 requires for EIP-712 signing.
+ *
+ * @cause x402 adapter configuration is missing or invalid (no wallet, no recipient address, malformed scheme).
+ * @fix Read the error `details` for the specific config gap. See /recipes/per-call-api for canonical setup.
+ * @recovery user-action
  */
 export declare class X402ConfigError extends X402Error {
     constructor(message: string, details?: Record<string, unknown>);
@@ -29,6 +33,10 @@ export declare class X402ConfigError extends X402Error {
  * Thrown when paymaster rejects sponsored tx because agent isn't published
  * in AgentRegistry. The one-time Permit2 approve needed to enable Smart Wallet
  * x402 payments requires the agent to pass the paymaster policy gate.
+ *
+ * @cause Attempted x402 settlement before publishing the agent (no AgentID, no AgentRegistry entry).
+ * @fix Run `actp publish` to register the agent. See /recipes/keystore-and-deployment.
+ * @recovery user-action
  */
 export declare class X402PublishRequiredError extends X402Error {
     constructor();
@@ -41,6 +49,10 @@ export declare class X402PublishRequiredError extends X402Error {
  * holder, and it does NOT delegate to ERC-1271 for contract wallets.
  * Smart Wallets must use the Permit2 path, which the server must advertise
  * by setting `extra.assetTransferMethod = "permit2"` in payment requirements.
+ *
+ * @cause Configured wallet provider does not implement the EIP-3009 typed-data signing required by x402, or the server only offers EIP-3009 (not Permit2) and the wallet is a Smart Wallet.
+ * @fix Switch to `wallet=auto` (Coinbase Smart Wallet supports it via Permit2) or use an EOA wallet that implements `signTypedData_v4` per EIP-712. Or ask the server to advertise Permit2.
+ * @recovery user-action
  */
 export declare class X402UnsupportedWalletError extends X402Error {
     constructor(message: string, details?: Record<string, unknown>);
@@ -48,6 +60,10 @@ export declare class X402UnsupportedWalletError extends X402Error {
 /**
  * Thrown when the server's payment-required response offers no network
  * that the client's `allowedNetworks` configuration accepts.
+ *
+ * @cause x402 v2 only supports mainnet on AGIRAILS; attempted use on testnet or mock.
+ * @fix Switch network to `mainnet`, or use ACTP escrow on testnet for development.
+ * @recovery user-action
  */
 export declare class X402NetworkNotAllowedError extends X402Error {
     constructor(message: string, details?: Record<string, unknown>);
@@ -55,6 +71,10 @@ export declare class X402NetworkNotAllowedError extends X402Error {
 /**
  * Thrown when the server's required payment amount exceeds the client's
  * `maxAmountPerTx` safety cap. Default cap is $1 USDC.
+ *
+ * @cause x402 server-issued price exceeds the consumer's max acceptable amount (per `pay()` config or app guard).
+ * @fix Raise `maxAmountPerTx`, or treat the call as too expensive and route to ACTP escrow with negotiated pricing.
+ * @recovery user-action
  */
 export declare class X402AmountExceededError extends X402Error {
     constructor(message: string, details?: Record<string, unknown>);
@@ -62,12 +82,20 @@ export declare class X402AmountExceededError extends X402Error {
 /**
  * Thrown when the one-time Permit2 approve transaction fails for any reason
  * other than paymaster gate (which throws X402PublishRequiredError instead).
+ *
+ * @cause USDC `transferWithAuthorization` (EIP-3009) authorization step failed. Common: signature replay, expired authorization, or insufficient balance.
+ * @fix Re-sign with a fresh nonce; check USDC balance; verify the EIP-3009 typed-data domain matches Base mainnet.
+ * @recovery retry-safe
  */
 export declare class X402ApprovalFailedError extends X402Error {
     constructor(message: string, details?: Record<string, unknown>);
 }
 /**
  * Thrown when walletProvider.signTypedData() fails to produce a signature.
+ *
+ * @cause EIP-712 typed-data signing of the x402 payment authorization failed at the wallet provider level.
+ * @fix Confirm the wallet's chainId matches the network. For `wallet=auto`, ensure the keystore is loaded and the Smart Wallet is registered.
+ * @recovery must-investigate
  */
 export declare class X402SignatureFailedError extends X402Error {
     constructor(message: string, details?: Record<string, unknown>);
@@ -77,9 +105,13 @@ export declare class X402SignatureFailedError extends X402Error {
  * a `payment-response` header confirming on-chain settlement.
  *
  * Per x402 v2 spec, facilitator sets this header ONLY after settlement is
- * mined and confirmed. Absence means the payment is UNCONFIRMED — it may have
+ * mined and confirmed. Absence means the payment is UNCONFIRMED. It may have
  * been lost to a reorg, stuck in mempool, or the facilitator/server may be
  * misbehaving. Do not treat as success.
+ *
+ * @cause x402 settlement attempted but the prior payment authorization proof isn't on file (server lost state, replayed stale request, or facilitator/server misbehavior).
+ * @fix Re-initiate the payment flow from `pay()` with a new authorization. Verify the settlement on-chain via tx hash before treating as final. State is per-request, not persisted across SDK reboots.
+ * @recovery retry-safe
  */
 export declare class X402SettlementProofMissingError extends X402Error {
     constructor(message?: string);
@@ -87,6 +119,10 @@ export declare class X402SettlementProofMissingError extends X402Error {
 /**
  * Thrown when the payment attempt returns a non-2xx HTTP status after
  * signing and submitting the payment payload.
+ *
+ * @cause x402 transfer transaction failed on-chain (revert during USDC transfer step) or server returned non-2xx.
+ * @fix Read the tx hash from error details, inspect on Basescan. Often: balance check failed, recipient invalid, or paymaster rejected sponsorship.
+ * @recovery must-investigate
  */
 export declare class X402PaymentFailedError extends X402Error {
     constructor(message: string, details?: Record<string, unknown>);

package/dist/errors/X402Errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"X402Errors.d.ts","sourceRoot":"","sources":["../../src/errors/X402Errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;GAGG;AACH,qBAAa,SAAU,SAAQ,SAAS;gBAC1B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAK7E;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,SAAS;gBAChC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;;;GAIG;AACH,qBAAa,wBAAyB,SAAQ,SAAS;;CAUtD;AAED;;;;;;;;GAQG;AACH,qBAAa,0BAA2B,SAAQ,SAAS;gBAC3C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;;GAGG;AACH,qBAAa,0BAA2B,SAAQ,SAAS;gBAC3C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,SAAS;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,SAAS;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,SAAS;gBACzC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;;;;;;;GAQG;AACH,qBAAa,+BAAgC,SAAQ,SAAS;gBAChD,OAAO,CAAC,EAAE,MAAM;CAU7B;AAED;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,SAAS;gBACvC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAGxD"}
+{"version":3,"file":"X402Errors.d.ts","sourceRoot":"","sources":["../../src/errors/X402Errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;GAGG;AACH,qBAAa,SAAU,SAAQ,SAAS;gBAC1B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAK7E;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAgB,SAAQ,SAAS;gBAChC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;;;;;;;GAQG;AACH,qBAAa,wBAAyB,SAAQ,SAAS;;CAUtD;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,0BAA2B,SAAQ,SAAS;gBAC3C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;;;;;;GAOG;AACH,qBAAa,0BAA2B,SAAQ,SAAS;gBAC3C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;;;;;;GAOG;AACH,qBAAa,uBAAwB,SAAQ,SAAS;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;;;;;;GAOG;AACH,qBAAa,uBAAwB,SAAQ,SAAS;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;;;;;GAMG;AACH,qBAAa,wBAAyB,SAAQ,SAAS;gBACzC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,+BAAgC,SAAQ,SAAS;gBAChD,OAAO,CAAC,EAAE,MAAM;CAU7B;AAED;;;;;;;GAOG;AACH,qBAAa,sBAAuB,SAAQ,SAAS;gBACvC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAGxD"}

package/dist/errors/X402Errors.js

@@ -29,6 +29,10 @@ exports.X402Error = X402Error;
  *
  * Most common cause: walletProvider does not implement the optional
  * `signTypedData()` method that x402 v2 requires for EIP-712 signing.
+ *
+ * @cause x402 adapter configuration is missing or invalid (no wallet, no recipient address, malformed scheme).
+ * @fix Read the error `details` for the specific config gap. See /recipes/per-call-api for canonical setup.
+ * @recovery user-action
  */
 class X402ConfigError extends X402Error {
     constructor(message, details) {
@@ -41,6 +45,10 @@ exports.X402ConfigError = X402ConfigError;
  * Thrown when paymaster rejects sponsored tx because agent isn't published
  * in AgentRegistry. The one-time Permit2 approve needed to enable Smart Wallet
  * x402 payments requires the agent to pass the paymaster policy gate.
+ *
+ * @cause Attempted x402 settlement before publishing the agent (no AgentID, no AgentRegistry entry).
+ * @fix Run `actp publish` to register the agent. See /recipes/keystore-and-deployment.
+ * @recovery user-action
  */
 class X402PublishRequiredError extends X402Error {
     constructor() {
@@ -59,6 +67,10 @@ exports.X402PublishRequiredError = X402PublishRequiredError;
  * holder, and it does NOT delegate to ERC-1271 for contract wallets.
  * Smart Wallets must use the Permit2 path, which the server must advertise
  * by setting `extra.assetTransferMethod = "permit2"` in payment requirements.
+ *
+ * @cause Configured wallet provider does not implement the EIP-3009 typed-data signing required by x402, or the server only offers EIP-3009 (not Permit2) and the wallet is a Smart Wallet.
+ * @fix Switch to `wallet=auto` (Coinbase Smart Wallet supports it via Permit2) or use an EOA wallet that implements `signTypedData_v4` per EIP-712. Or ask the server to advertise Permit2.
+ * @recovery user-action
  */
 class X402UnsupportedWalletError extends X402Error {
     constructor(message, details) {
@@ -70,6 +82,10 @@ exports.X402UnsupportedWalletError = X402UnsupportedWalletError;
 /**
  * Thrown when the server's payment-required response offers no network
  * that the client's `allowedNetworks` configuration accepts.
+ *
+ * @cause x402 v2 only supports mainnet on AGIRAILS; attempted use on testnet or mock.
+ * @fix Switch network to `mainnet`, or use ACTP escrow on testnet for development.
+ * @recovery user-action
  */
 class X402NetworkNotAllowedError extends X402Error {
     constructor(message, details) {
@@ -81,6 +97,10 @@ exports.X402NetworkNotAllowedError = X402NetworkNotAllowedError;
 /**
  * Thrown when the server's required payment amount exceeds the client's
  * `maxAmountPerTx` safety cap. Default cap is $1 USDC.
+ *
+ * @cause x402 server-issued price exceeds the consumer's max acceptable amount (per `pay()` config or app guard).
+ * @fix Raise `maxAmountPerTx`, or treat the call as too expensive and route to ACTP escrow with negotiated pricing.
+ * @recovery user-action
  */
 class X402AmountExceededError extends X402Error {
     constructor(message, details) {
@@ -92,6 +112,10 @@ exports.X402AmountExceededError = X402AmountExceededError;
 /**
  * Thrown when the one-time Permit2 approve transaction fails for any reason
  * other than paymaster gate (which throws X402PublishRequiredError instead).
+ *
+ * @cause USDC `transferWithAuthorization` (EIP-3009) authorization step failed. Common: signature replay, expired authorization, or insufficient balance.
+ * @fix Re-sign with a fresh nonce; check USDC balance; verify the EIP-3009 typed-data domain matches Base mainnet.
+ * @recovery retry-safe
  */
 class X402ApprovalFailedError extends X402Error {
     constructor(message, details) {
@@ -102,6 +126,10 @@ class X402ApprovalFailedError extends X402Error {
 exports.X402ApprovalFailedError = X402ApprovalFailedError;
 /**
  * Thrown when walletProvider.signTypedData() fails to produce a signature.
+ *
+ * @cause EIP-712 typed-data signing of the x402 payment authorization failed at the wallet provider level.
+ * @fix Confirm the wallet's chainId matches the network. For `wallet=auto`, ensure the keystore is loaded and the Smart Wallet is registered.
+ * @recovery must-investigate
  */
 class X402SignatureFailedError extends X402Error {
     constructor(message, details) {
@@ -115,9 +143,13 @@ exports.X402SignatureFailedError = X402SignatureFailedError;
  * a `payment-response` header confirming on-chain settlement.
  *
  * Per x402 v2 spec, facilitator sets this header ONLY after settlement is
- * mined and confirmed. Absence means the payment is UNCONFIRMED — it may have
+ * mined and confirmed. Absence means the payment is UNCONFIRMED. It may have
  * been lost to a reorg, stuck in mempool, or the facilitator/server may be
  * misbehaving. Do not treat as success.
+ *
+ * @cause x402 settlement attempted but the prior payment authorization proof isn't on file (server lost state, replayed stale request, or facilitator/server misbehavior).
+ * @fix Re-initiate the payment flow from `pay()` with a new authorization. Verify the settlement on-chain via tx hash before treating as final. State is per-request, not persisted across SDK reboots.
+ * @recovery retry-safe
  */
 class X402SettlementProofMissingError extends X402Error {
     constructor(message) {
@@ -132,6 +164,10 @@ exports.X402SettlementProofMissingError = X402SettlementProofMissingError;
 /**
  * Thrown when the payment attempt returns a non-2xx HTTP status after
  * signing and submitting the payment payload.
+ *
+ * @cause x402 transfer transaction failed on-chain (revert during USDC transfer step) or server returned non-2xx.
+ * @fix Read the tx hash from error details, inspect on Basescan. Often: balance check failed, recipient invalid, or paymaster rejected sponsorship.
+ * @recovery must-investigate
  */
 class X402PaymentFailedError extends X402Error {
     constructor(message, details) {

package/dist/errors/X402Errors.js.map

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