@ampersend_ai/ampersend-sdk 0.0.16 → 0.0.21

package/dist/mcp/proxy/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/mcp/proxy/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAIxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAQrD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,4BAA4B;IAC5B,mBAAmB,EAAE,OAAO,CAAA;IAC5B,0CAA0C;IAC1C,oBAAoB,EAAE,GAAG,CAAA;IACzB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC,CAYxG;AAGD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/mcp/proxy/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAIxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAKrD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,4BAA4B;IAC5B,mBAAmB,EAAE,OAAO,CAAA;IAC5B,0CAA0C;IAC1C,oBAAoB,EAAE,GAAG,CAAA;IACzB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC,CAWxG;AAGD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/mcp/proxy/factory.js

@@ -7,8 +7,6 @@ import { createAmpersendTreasurer } from "../../ampersend/treasurer.js";
 import { initializeProxyServer as initializeProxyServerInternal } from "./server/index.js";
 /** Default Ampersend API URL */
 const DEFAULT_API_URL = "https://api.ampersend.ai";
-/** Default chain ID (Base Sepolia) */
-const DEFAULT_CHAIN_ID = 84532;
 /**
  * Initialize an MCP proxy with minimal configuration.
  *
@@ -37,7 +35,6 @@ export async function createAmpersendProxy(options) {
         smartAccountAddress: options.smartAccountAddress,
         sessionKeyPrivateKey: options.sessionKeyPrivateKey,
         apiUrl: options.apiUrl ?? DEFAULT_API_URL,
-        chainId: options.chainId ?? DEFAULT_CHAIN_ID,
     });
     return initializeProxyServerInternal({
         transport: { type: "http", port: options.port },

package/dist/mcp/proxy/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/mcp/proxy/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAA;AACvE,OAAO,EAAE,qBAAqB,IAAI,6BAA6B,EAAE,MAAM,mBAAmB,CAAA;AAG1F,gCAAgC;AAChC,MAAM,eAAe,GAAG,0BAA0B,CAAA;AAElD,sCAAsC;AACtC,MAAM,gBAAgB,GAAG,KAAK,CAAA;AAmB9B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAA2B;IACpE,MAAM,SAAS,GAAG,wBAAwB,CAAC;QACzC,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;QAChD,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;QAClD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,eAAe;QACzC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,gBAAgB;KAC7C,CAAC,CAAA;IAEF,OAAO,6BAA6B,CAAC;QACnC,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;QAC/C,SAAS;KACV,CAAC,CAAA;AACJ,CAAC;AAED,4CAA4C;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/mcp/proxy/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAA;AACvE,OAAO,EAAE,qBAAqB,IAAI,6BAA6B,EAAE,MAAM,mBAAmB,CAAA;AAG1F,gCAAgC;AAChC,MAAM,eAAe,GAAG,0BAA0B,CAAA;AAiBlD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAA2B;IACpE,MAAM,SAAS,GAAG,wBAAwB,CAAC;QACzC,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;QAChD,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;QAClD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,eAAe;KAC1C,CAAC,CAAA;IAEF,OAAO,6BAA6B,CAAC;QACnC,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;QAC/C,SAAS;KACV,CAAC,CAAA;AACJ,CAAC;AAED,4CAA4C;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/mcp/server/fastmcp/middleware.d.ts

@@ -1,50 +1,30 @@
+import type { PaymentPayloadV1, PaymentRequirementsV1 } from "@x402/core/schemas";
+import type { SettleResponse } from "@x402/core/types";
 import { type AudioContent, type ContentResult, type ImageContent, type ResourceContent, type ResourceLink, type TextContent } from "fastmcp";
-import { type PaymentPayload, type PaymentRequirements, type SettleResponse } from "x402/types";
-/**
- * Callback to determine if payment is required for tool execution
- */
+/** Requirements to advertise, or `null` if payment isn't required. */
 export type OnExecute = (context: {
     args: unknown;
-}) => Promise<PaymentRequirements | null>;
-/**
- * Callback when payment provided
- */
+}) => Promise<PaymentRequirementsV1 | null>;
+/** Return a {@link SettleResponse} to embed in `_meta`, or `void` to accept without settling. */
 export type OnPayment = (context: {
-    payment: PaymentPayload;
-    requirements: PaymentRequirements;
+    payment: PaymentPayloadV1;
+    requirements: PaymentRequirementsV1;
 }) => Promise<SettleResponse | void>;
-/**
- * Options for the x402 payment middleware
- */
 export interface WithX402PaymentOptions {
     onExecute: OnExecute;
     onPayment: OnPayment;
 }
-/**
- * FastMCP context with request metadata
- */
 interface FastMCPContext {
     requestMetadata?: {
-        "x402/payment"?: PaymentPayload;
+        "x402/payment"?: PaymentPayloadV1;
         [key: string]: unknown;
     };
     [key: string]: unknown;
 }
-/**
- * The execute function signature from FastMCP
- */
 type ExecuteFunction<TArgs = any, TResult = any> = (args: TArgs, context: FastMCPContext) => Promise<TResult>;
 export type ToolExecuteReturn = AudioContent | ContentResult | ImageContent | ResourceContent | ResourceLink | string | TextContent | void;
-/**
- * Middleware that wraps a FastMCP execute function to handle x402 payments
- *
- * Extracts payment from requestMetadata["x402/payment"] field and adds settlement
- * response to result _meta["x402/payment-response"] according to official MCP x402 spec.
- */
+/** Wrap a FastMCP `execute` with x402 payment handling per the MCP x402 spec. */
 export declare function withX402Payment<TArgs = any, TResult = any>(options: WithX402PaymentOptions): (execute: ExecuteFunction<TArgs, TResult>) => ExecuteFunction<TArgs, TResult>;
-/**
- * Convenience function that directly wraps an execute function
- */
 export declare function createX402Execute<TArgs = any, TResult = any>(options: WithX402PaymentOptions, execute: ExecuteFunction<TArgs, TResult>): ExecuteFunction<TArgs, TResult>;
 export {};
 //# sourceMappingURL=middleware.d.ts.map

package/dist/mcp/server/fastmcp/middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../../src/mcp/server/fastmcp/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAA;AAE/F;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,KAAK,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAA;AAE3F;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE;IAChC,OAAO,EAAE,cAAc,CAAA;IACvB,YAAY,EAAE,mBAAmB,CAAA;CAClC,KAAK,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;AAEpC;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,SAAS,CAAA;IACpB,SAAS,EAAE,SAAS,CAAA;CACrB;AAcD;;GAEG;AACH,UAAU,cAAc;IACtB,eAAe,CAAC,EAAE;QAChB,cAAc,CAAC,EAAE,cAAc,CAAA;QAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KACvB,CAAA;IACD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED;;GAEG;AACH,KAAK,eAAe,CAAC,KAAK,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AA8B7G,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,eAAe,GACf,YAAY,GACZ,MAAM,GACN,WAAW,GACX,IAAI,CAAA;AAoBR;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EACxD,OAAO,EAAE,sBAAsB,GAC9B,CAAC,OAAO,EAAE,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAuD/E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EAC1D,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,GACvC,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAEjC"}
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../../src/mcp/server/fastmcp/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,SAAS,CAAA;AAEhB,sEAAsE;AACtE,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,KAAK,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAA;AAE7F,iGAAiG;AACjG,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE;IAChC,OAAO,EAAE,gBAAgB,CAAA;IACzB,YAAY,EAAE,qBAAqB,CAAA;CACpC,KAAK,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;AAEpC,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,SAAS,CAAA;IACpB,SAAS,EAAE,SAAS,CAAA;CACrB;AAWD,UAAU,cAAc;IACtB,eAAe,CAAC,EAAE;QAChB,cAAc,CAAC,EAAE,gBAAgB,CAAA;QACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KACvB,CAAA;IACD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,KAAK,eAAe,CAAC,KAAK,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAsB7G,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,eAAe,GACf,YAAY,GACZ,MAAM,GACN,WAAW,GACX,IAAI,CAAA;AAkBR,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,KAAK,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EACxD,OAAO,EAAE,sBAAsB,GAC9B,CAAC,OAAO,EAAE,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAuC/E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EAC1D,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,GACvC,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAEjC"}

package/dist/mcp/server/fastmcp/middleware.js

@@ -1,13 +1,5 @@
 import { CustomMcpError, } from "fastmcp";
-import {} from "x402/types";
-/**
- * Creates a payment error with x402 requirements
- *
- * Workaround: Embeds x402 data as JSON in the error message for when FastMCP
- * doesn't properly propagate the data field. This allows the client to fall back
- * to parsing the data from the message.
- */
-function createPaymentError(requirements, errorReason = null, paymentResponse = null) {
+function createPaymentError(requirements, errorReason = null, settlement = null) {
     const data = {
         message: "Payment required for tool execution",
         code: 402,
@@ -17,8 +9,8 @@ function createPaymentError(requirements, errorReason = null, paymentResponse =
     if (errorReason) {
         data.error = errorReason;
     }
-    if (paymentResponse) {
-        data["x402/payment-response"] = paymentResponse;
+    if (settlement) {
+        data["x402/payment-response"] = settlement;
     }
     return new CustomMcpError(402, data.message, data);
 }
@@ -29,71 +21,47 @@ function normalizeToolResult(result) {
     if (typeof result === "string") {
         return { content: [{ text: result, type: "text" }] };
     }
-    // Check if it's an individual content type (has 'type' property)
     if ("type" in result) {
         return { content: [result] };
     }
-    // Already a ContentResult
     return result;
 }
-/**
- * Middleware that wraps a FastMCP execute function to handle x402 payments
- *
- * Extracts payment from requestMetadata["x402/payment"] field and adds settlement
- * response to result _meta["x402/payment-response"] according to official MCP x402 spec.
- */
+/** Wrap a FastMCP `execute` with x402 payment handling per the MCP x402 spec. */
 export function withX402Payment(options) {
     return (execute) => {
         return async (args, context) => {
-            // Extract payment from MCP request metadata (via FastMCP context)
             const payment = context.requestMetadata?.["x402/payment"];
-            // Check if payment is required
             const requirements = await options.onExecute({ args });
-            // No payment required - execute normally
             if (!requirements) {
                 return execute(args, context);
             }
-            // Payment is required
             if (!payment) {
-                // No payment provided - return error with requirements
                 throw createPaymentError(requirements);
             }
-            // Payment provided
-            let onPaymentResp;
+            let settlement;
             try {
-                onPaymentResp = await options.onPayment({
-                    payment,
-                    requirements,
-                });
+                settlement = await options.onPayment({ payment, requirements });
             }
             catch (error) {
-                // Payment invalid - extract reason from error
                 const reason = error instanceof Error ? error.message : String(error);
                 throw createPaymentError(requirements, reason);
             }
-            if (onPaymentResp && !onPaymentResp.success) {
-                // Payment rejected - return error with reason
-                throw createPaymentError(requirements, onPaymentResp.errorReason, onPaymentResp);
+            if (settlement && !settlement.success) {
+                throw createPaymentError(requirements, settlement.errorReason ?? null, settlement);
             }
-            // Payment valid - proceed with execution
             const result = await execute(args, context);
-            // Did not settle
-            if (!onPaymentResp) {
+            if (!settlement) {
                 return result;
             }
             const normalizedResult = normalizeToolResult(result);
-            // Add settlement response to result _meta (official spec)
             normalizedResult._meta = {
                 ...normalizedResult._meta,
-                "x402/payment-response": onPaymentResp,
+                "x402/payment-response": settlement,
             };
             return normalizedResult;
         };
     };
 }
-/**
- * Convenience function that directly wraps an execute function
- */
 export function createX402Execute(options, execute) {
     return withX402Payment(options)(execute);
 }

package/dist/mcp/server/fastmcp/middleware.js.map

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

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 /** SDK version - keep in sync with package.json */
-export declare const VERSION = "0.0.16";
+export declare const VERSION = "0.0.21";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,3 +1,3 @@
 /** SDK version - keep in sync with package.json */
-export const VERSION = "0.0.16";
+export const VERSION = "0.0.21";
 //# sourceMappingURL=version.js.map

package/dist/x402/envelopes.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Ampersend protocol envelopes: `{ protocol, data }` wrappers where `data` is
+ * the byte-exact upstream payload (no re-serialization).
+ *
+ *   PaymentRequest        (seller's 402)
+ *        ↓ treasurer picks accepts[i]
+ *   PaymentInstruction    (request + index; wallet input)
+ *        ↓ wallet signs
+ *   PaymentAuthorization  (signed, ready to submit)
+ *        ↓ facilitator settles
+ *   SettlementResult
+ *
+ * `PaymentInstruction` keeps the full request by reference so v2's
+ * `deepEqual(accepts[i], …)` check (spec §5.1.3) can't drift.
+ */
+import type { PaymentPayloadV1, PaymentPayloadV2, PaymentRequiredV1, PaymentRequiredV2, PaymentRequirementsV1, PaymentRequirementsV2 } from "@x402/core/schemas";
+import type { SettleResponse } from "@x402/core/types";
+export type Protocol = "x402-v1" | "x402-v2";
+/** The seller's full 402 body. Treasurers pick one `data.accepts[i]` (or none). */
+export type PaymentRequest = {
+    readonly protocol: "x402-v1";
+    readonly data: PaymentRequiredV1;
+} | {
+    readonly protocol: "x402-v2";
+    readonly data: PaymentRequiredV2;
+};
+/** Request + `acceptsIndex`. Full request rides along so v2 echo is byte-exact. */
+export type PaymentInstruction = {
+    readonly protocol: "x402-v1";
+    readonly request: PaymentRequiredV1;
+    readonly acceptsIndex: number;
+} | {
+    readonly protocol: "x402-v2";
+    readonly request: PaymentRequiredV2;
+    readonly acceptsIndex: number;
+};
+export type PaymentAuthorization = {
+    readonly protocol: "x402-v1";
+    readonly data: PaymentPayloadV1;
+} | {
+    readonly protocol: "x402-v2";
+    readonly data: PaymentPayloadV2;
+};
+/** Upstream ships one `SettleResponse` for both versions. */
+export type SettlementResult = {
+    readonly protocol: "x402-v1";
+    readonly data: SettleResponse;
+} | {
+    readonly protocol: "x402-v2";
+    readonly data: SettleResponse;
+};
+export declare function acceptedOf(instruction: PaymentInstruction): PaymentRequirementsV1 | PaymentRequirementsV2;
+/** Payment amount in atomic units (stringified bigint). */
+export declare function amountOf(instruction: PaymentInstruction): string;
+export declare function resourceUrlOf(instruction: PaymentInstruction): string;
+/** Wrap a request at `acceptsIndex: 0`. Upstream `accepts.min(1)` guarantees non-empty. */
+export declare function firstInstructionOf(request: PaymentRequest): PaymentInstruction;
+/** Scheme-specific signed body. exact-EVM: `{ signature, authorization }`. */
+export type SchemeSpecificPayload = Record<string, unknown>;
+/** Wrap a signed payload into a `PaymentAuthorization`. v2 echoes `resource`, `accepted`, `extensions` verbatim. */
+export declare function buildAuthorization(instruction: PaymentInstruction, signedPayload: SchemeSpecificPayload): PaymentAuthorization;
+//# sourceMappingURL=envelopes.d.ts.map

package/dist/x402/envelopes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelopes.d.ts","sourceRoot":"","sources":["../../src/x402/envelopes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEtD,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAA;AAE5C,mFAAmF;AACnF,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAClE;IAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,CAAA;AAEtE,mFAAmF;AACnF,MAAM,MAAM,kBAAkB,GAC1B;IACE,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAA;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B,GACD;IACE,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAA;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B,CAAA;AAEL,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,GACjE;IAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAA;AAErE,6DAA6D;AAC7D,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GAC/D;IAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;CAAE,CAAA;AAEnE,wBAAgB,UAAU,CAAC,WAAW,EAAE,kBAAkB,GAAG,qBAAqB,GAAG,qBAAqB,CAQzG;AAED,2DAA2D;AAC3D,wBAAgB,QAAQ,CAAC,WAAW,EAAE,kBAAkB,GAAG,MAAM,CAIhE;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,kBAAkB,GAAG,MAAM,CAIrE;AAED,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,kBAAkB,CAI9E;AAED,8EAA8E;AAC9E,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE3D,oHAAoH;AACpH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,kBAAkB,EAC/B,aAAa,EAAE,qBAAqB,GACnC,oBAAoB,CA+BtB"}

package/dist/x402/envelopes.js

@@ -0,0 +1,73 @@
+/**
+ * Ampersend protocol envelopes: `{ protocol, data }` wrappers where `data` is
+ * the byte-exact upstream payload (no re-serialization).
+ *
+ *   PaymentRequest        (seller's 402)
+ *        ↓ treasurer picks accepts[i]
+ *   PaymentInstruction    (request + index; wallet input)
+ *        ↓ wallet signs
+ *   PaymentAuthorization  (signed, ready to submit)
+ *        ↓ facilitator settles
+ *   SettlementResult
+ *
+ * `PaymentInstruction` keeps the full request by reference so v2's
+ * `deepEqual(accepts[i], …)` check (spec §5.1.3) can't drift.
+ */
+export function acceptedOf(instruction) {
+    const accepted = instruction.request.accepts[instruction.acceptsIndex];
+    if (!accepted) {
+        throw new Error(`PaymentInstruction.acceptsIndex ${instruction.acceptsIndex} out of bounds (accepts.length=${instruction.request.accepts.length})`);
+    }
+    return accepted;
+}
+/** Payment amount in atomic units (stringified bigint). */
+export function amountOf(instruction) {
+    return instruction.protocol === "x402-v1"
+        ? instruction.request.accepts[instruction.acceptsIndex].maxAmountRequired
+        : instruction.request.accepts[instruction.acceptsIndex].amount;
+}
+export function resourceUrlOf(instruction) {
+    return instruction.protocol === "x402-v1"
+        ? instruction.request.accepts[instruction.acceptsIndex].resource
+        : instruction.request.resource.url;
+}
+/** Wrap a request at `acceptsIndex: 0`. Upstream `accepts.min(1)` guarantees non-empty. */
+export function firstInstructionOf(request) {
+    return request.protocol === "x402-v1"
+        ? { protocol: "x402-v1", request: request.data, acceptsIndex: 0 }
+        : { protocol: "x402-v2", request: request.data, acceptsIndex: 0 };
+}
+/** Wrap a signed payload into a `PaymentAuthorization`. v2 echoes `resource`, `accepted`, `extensions` verbatim. */
+export function buildAuthorization(instruction, signedPayload) {
+    if (instruction.protocol === "x402-v1") {
+        const accepted = instruction.request.accepts[instruction.acceptsIndex];
+        if (!accepted) {
+            throw new Error(`PaymentInstruction.acceptsIndex ${instruction.acceptsIndex} out of bounds`);
+        }
+        return {
+            protocol: "x402-v1",
+            data: {
+                x402Version: 1,
+                scheme: accepted.scheme,
+                network: accepted.network,
+                payload: signedPayload,
+            },
+        };
+    }
+    const accepted = instruction.request.accepts[instruction.acceptsIndex];
+    if (!accepted) {
+        throw new Error(`PaymentInstruction.acceptsIndex ${instruction.acceptsIndex} out of bounds`);
+    }
+    return {
+        protocol: "x402-v2",
+        data: {
+            x402Version: 2,
+            resource: instruction.request.resource,
+            accepted,
+            payload: signedPayload,
+            ...(instruction.request.extensions !== undefined &&
+                instruction.request.extensions !== null && { extensions: instruction.request.extensions }),
+        },
+    };
+}
+//# sourceMappingURL=envelopes.js.map

package/dist/x402/envelopes.js.map

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

package/dist/x402/http/client.d.ts

@@ -0,0 +1,37 @@
+import { x402Client } from "@x402/core/client";
+import type { PaymentPayload as V2PaymentPayload, PaymentRequired as V2PaymentRequired } from "@x402/core/types";
+import type { X402Treasurer } from "../treasurer.ts";
+/**
+ * v1 uses network names (`"base"`), v2 uses CAIP-2 (`"eip155:8453"`) or
+ * wildcards (`"eip155:*"`). Register whichever protocols you want to accept.
+ */
+export interface AmpersendNetworks {
+    v1?: ReadonlyArray<string>;
+    v2?: ReadonlyArray<string>;
+}
+export declare class PaymentDeclinedError extends Error {
+    constructor();
+}
+export declare class UnsupportedProtocolError extends Error {
+    readonly x402Version: number;
+    constructor(x402Version: number);
+}
+/**
+ * `x402Client` whose `accepts[i]` selection is driven by an async treasurer.
+ *
+ * Upstream's selector is sync, so we override `createPaymentPayload` to run
+ * the treasurer first, stash `{ accepted → authorization }` in a WeakMap,
+ * and delegate to `super`. The installed selector returns the stashed entry
+ * by reference equality; our scheme client hands back the pre-signed payload.
+ * Hooks, policies, extensions, and failure recovery stay upstream's.
+ *
+ * Reference equality on `Authorization.accepted` is load-bearing — the
+ * treasurer must return the original `accepts[i]`, not a clone.
+ */
+export declare class AmpersendX402Client extends x402Client {
+    #private;
+    constructor(treasurer: X402Treasurer);
+    withNetworks(networks: AmpersendNetworks): this;
+    createPaymentPayload(paymentRequired: V2PaymentRequired): Promise<V2PaymentPayload>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/x402/http/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/x402/http/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAQ9C,OAAO,KAAK,EAGV,cAAc,IAAI,gBAAgB,EAClC,eAAe,IAAI,iBAAiB,EAErC,MAAM,kBAAkB,CAAA;AAGzB,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEnE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC1B,EAAE,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAC3B;AAED,qBAAa,oBAAqB,SAAQ,KAAK;;CAK9C;AAED,qBAAa,wBAAyB,SAAQ,KAAK;aACrB,WAAW,EAAE,MAAM;gBAAnB,WAAW,EAAE,MAAM;CAOhD;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;;gBAKrC,SAAS,EAAE,aAAa;IAmBpC,YAAY,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAehC,oBAAoB,CAAC,eAAe,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAwCnG"}

package/dist/x402/http/client.js

@@ -0,0 +1,159 @@
+import { x402Client } from "@x402/core/client";
+import { PaymentRequiredV1Schema, PaymentRequiredV2Schema, } from "@x402/core/schemas";
+export class PaymentDeclinedError extends Error {
+    constructor() {
+        super("Payment declined by treasurer");
+        this.name = "PaymentDeclinedError";
+    }
+}
+export class UnsupportedProtocolError extends Error {
+    x402Version;
+    constructor(x402Version) {
+        super(`No scheme registered for x402 version ${x402Version}. ` +
+            `Register at least one network for this version via \`.withNetworks({ v${x402Version}: [...] })\`.`);
+        this.x402Version = x402Version;
+        this.name = "UnsupportedProtocolError";
+    }
+}
+/**
+ * `x402Client` whose `accepts[i]` selection is driven by an async treasurer.
+ *
+ * Upstream's selector is sync, so we override `createPaymentPayload` to run
+ * the treasurer first, stash `{ accepted → authorization }` in a WeakMap,
+ * and delegate to `super`. The installed selector returns the stashed entry
+ * by reference equality; our scheme client hands back the pre-signed payload.
+ * Hooks, policies, extensions, and failure recovery stay upstream's.
+ *
+ * Reference equality on `Authorization.accepted` is load-bearing — the
+ * treasurer must return the original `accepts[i]`, not a clone.
+ */
+export class AmpersendX402Client extends x402Client {
+    #treasurer;
+    #authByAccepted;
+    #supportedVersions = new Set();
+    constructor(treasurer) {
+        const authByAccepted = new WeakMap();
+        super((_x402Version, accepts) => {
+            for (const accept of accepts) {
+                if (authByAccepted.has(accept))
+                    return accept;
+            }
+            throw new Error("AmpersendX402Client: the treasurer's pick is not present in the filtered " +
+                "accepts[]. It was either filtered out by a registered policy or the scheme/" +
+                "network is not registered. Register the network with `.withNetworks()` or " +
+                "relax the policy so the treasurer's pick survives.");
+        });
+        this.#treasurer = treasurer;
+        this.#authByAccepted = authByAccepted;
+    }
+    withNetworks(networks) {
+        const schemeClient = new TreasurerSchemeClient(this.#authByAccepted);
+        if (networks.v1?.length)
+            this.#supportedVersions.add(1);
+        if (networks.v2?.length)
+            this.#supportedVersions.add(2);
+        for (const network of networks.v1 ?? []) {
+            this.registerV1(network, schemeClient);
+        }
+        for (const network of networks.v2 ?? []) {
+            // Upstream pattern-matches networks (including wildcards), but types
+            // them as CAIP-2 template literals.
+            this.register(network, schemeClient);
+        }
+        return this;
+    }
+    async createPaymentPayload(paymentRequired) {
+        // Fail before calling the treasurer — avoids wasting an API round-trip on an unsignable request.
+        if (!this.#supportedVersions.has(paymentRequired.x402Version)) {
+            throw new UnsupportedProtocolError(paymentRequired.x402Version);
+        }
+        const request = toPaymentRequest(paymentRequired);
+        let authorization;
+        try {
+            authorization = await this.#treasurer.onPaymentRequired(request, { method: "http" });
+        }
+        catch (error) {
+            throw new Error(`Treasurer failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        if (!authorization)
+            throw new PaymentDeclinedError();
+        const accepted = authorization.accepted;
+        if (!paymentRequired.accepts.includes(authorization.accepted)) {
+            throw new Error("AmpersendX402Client: Authorization.accepted is not an element of " +
+                "paymentRequired.accepts (reference equality required). The treasurer must " +
+                "return the original accepts[i] reference, not a clone.");
+        }
+        this.#authByAccepted.set(accepted, authorization);
+        try {
+            const payload = await super.createPaymentPayload(paymentRequired);
+            await this.#treasurer.onStatus("sending", authorization, { method: "http" });
+            return payload;
+        }
+        catch (error) {
+            await this.#treasurer.onStatus("error", authorization, {
+                method: "http",
+                params: { error: error instanceof Error ? error.message : String(error) },
+            });
+            throw error;
+        }
+        finally {
+            this.#authByAccepted.delete(accepted);
+        }
+    }
+}
+/** Does not sign — returns the treasurer's pre-signed payload, looked up by `accepts[i]` reference. */
+class TreasurerSchemeClient {
+    store;
+    scheme = "exact";
+    constructor(store) {
+        this.store = store;
+    }
+    async createPaymentPayload(x402Version, requirements) {
+        const authorization = this.store.get(requirements);
+        if (!authorization) {
+            throw new Error("TreasurerSchemeClient invoked without a stashed authorization. This " +
+                "indicates a call path that bypassed AmpersendX402Client.createPaymentPayload.");
+        }
+        const payment = authorization.payment;
+        if (x402Version === 1) {
+            if (payment.protocol !== "x402-v1") {
+                throw new Error(`Expected v1 authorization; got ${payment.protocol}`);
+            }
+            return payment.data;
+        }
+        if (payment.protocol !== "x402-v2") {
+            throw new Error(`Expected v2 authorization; got ${payment.protocol}`);
+        }
+        // Upstream reconstructs `resource` and `accepted` from paymentRequired,
+        // so we only return x402Version + payload + optional extensions.
+        const result = {
+            x402Version: payment.data.x402Version,
+            payload: payment.data.payload,
+        };
+        if (payment.data.extensions != null) {
+            result.extensions = payment.data.extensions;
+        }
+        return result;
+    }
+}
+// `data` keeps the original reference (not `r.data`) — reference-equality on
+// `accepts[i]` is load-bearing for the WeakMap dispatch above.
+function toPaymentRequest(paymentRequired) {
+    switch (paymentRequired.x402Version) {
+        case 1: {
+            const r = PaymentRequiredV1Schema.safeParse(paymentRequired);
+            if (!r.success)
+                throw new Error(`Invalid x402 v1 PaymentRequired: ${r.error.message}`);
+            return { protocol: "x402-v1", data: paymentRequired };
+        }
+        case 2: {
+            const r = PaymentRequiredV2Schema.safeParse(paymentRequired);
+            if (!r.success)
+                throw new Error(`Invalid x402 v2 PaymentRequired: ${r.error.message}`);
+            return { protocol: "x402-v2", data: paymentRequired };
+        }
+        default:
+            throw new Error(`Unsupported x402 version: ${paymentRequired.x402Version}`);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/x402/http/client.js.map

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