@nevermined-io/payments 1.1.18 → 1.4.0

package/dist/payments.js

@@ -14,8 +14,6 @@ import { OrganizationsAPI } from './api/organizations-api/organizations-api.js';
 import { FacilitatorAPI } from './x402/facilitator-api.js';
 import { X402TokenAPI } from './x402/token.js';
 import { DelegationAPI } from './x402/delegation-api.js';
-import { VisaFacilitatorAPI } from './x402/visa-facilitator-api.js';
-import { VisaTokenAPI } from './x402/visa-token-api.js';
 /**
  * Main class that interacts with the Nevermined payments API.
  * Use `Payments.getInstance` for server-side usage or `Payments.getBrowserInstance` for browser usage.
@@ -154,14 +152,8 @@ export class Payments extends BasePaymentsAPI {
         this.organizations = OrganizationsAPI.getInstance(options);
         this.query = AIQueryApi.getInstance();
         this.contracts = new ContractsAPI(options);
-        if (options.scheme === 'visa') {
-            this.facilitator = VisaFacilitatorAPI.getInstance(options);
-            this.x402 = VisaTokenAPI.getInstance(options);
-        }
-        else {
-            this.facilitator = FacilitatorAPI.getInstance(options);
-            this.x402 = X402TokenAPI.getInstance(options);
-        }
+        this.facilitator = FacilitatorAPI.getInstance(options);
+        this.x402 = X402TokenAPI.getInstance(options);
     }
     /**
      * Initiates the connect flow. The user's browser will be redirected to

package/dist/payments.js.map

@@ -1 +1 @@
-{"version":3,"file":"payments.js","sourceRoot":"","sources":["../src/payments.ts"],"names":[],"mappings":"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","sourcesContent":["import { AIQueryApi } from './api/query-api.js'\nimport { PaymentsError } from './common/payments.error.js'\nimport { PaymentOptions } from './common/types.js'\nimport { BasePaymentsAPI } from './api/base-payments.js'\nimport { PlansAPI } from './api/plans-api.js'\nimport { ContractsAPI } from './api/contracts-api.js'\nimport { AgentsAPI } from './api/agents-api.js'\nimport { AgentRequestsAPI } from './api/requests-api.js'\nimport { ObservabilityAPI } from './api/observability-api/observability-api.js'\nimport { ClientRegistry } from './a2a/clientRegistry.js'\nimport type { PaymentsA2AServerOptions, PaymentsA2AServerResult } from './a2a/server.js'\nimport { PaymentsA2AServer } from './a2a/server.js'\nimport { buildPaymentAgentCard } from './a2a/agent-card.js'\nimport * as mcpModule from './mcp/index.js'\nimport { OrganizationsAPI } from './api/organizations-api/organizations-api.js'\nimport { FacilitatorAPI } from './x402/facilitator-api.js'\nimport { X402TokenAPI } from './x402/token.js'\nimport { DelegationAPI } from './x402/delegation-api.js'\nimport { VisaFacilitatorAPI } from './x402/visa-facilitator-api.js'\nimport { VisaTokenAPI } from './x402/visa-token-api.js'\n\n/**\n * Main class that interacts with the Nevermined payments API.\n * Use `Payments.getInstance` for server-side usage or `Payments.getBrowserInstance` for browser usage.\n * @remarks This API requires a Nevermined API Key, which can be obtained by logging in to the Nevermined App.\n *\n * The library provides methods to manage AI Agents, Plans & process AI Agent Requests.\n *\n * Each of these functionalities is encapsulated in its own API class:\n * - `plans`: Manages AI Plans, including registration and ordering and retrieving plan details.\n * - `agents`: Handles AI Agents, including registration of AI Agents and access token generation.\n * - `requests`: Manages requests received by AI Agents, including validation and tracking.\n * - `observability`: Provides observability and logging utilities for AI Agents with Helicone integration\n */\nexport class Payments extends BasePaymentsAPI {\n  public query!: AIQueryApi\n  public plans!: PlansAPI\n  public agents!: AgentsAPI\n  public requests!: AgentRequestsAPI\n  public observability!: ObservabilityAPI\n  public organizations!: OrganizationsAPI\n  public contracts!: ContractsAPI\n  public facilitator!: FacilitatorAPI\n  public x402!: X402TokenAPI\n  private _a2aRegistry?: ClientRegistry\n  private _delegation?: DelegationAPI\n\n  /**\n   * Cached MCP integration to preserve configuration (e.g., agentId, serverName)\n   * across multiple getter accesses. This ensures callers do not need to retain\n   * a reference to a previously configured instance.\n   */\n  private _mcpIntegration?: ReturnType<typeof mcpModule.buildMcpIntegration>\n\n  /**\n   * Exposes A2A server and client registry methods.\n   * The client registry is initialized only if getClient is called.\n   */\n  public get a2a() {\n    return {\n      /**\n       * Starts the A2A server with payment integration.\n       * @param options - Server options.\n       */\n      start: (\n        options: Omit<PaymentsA2AServerOptions, 'paymentsService'>,\n      ): PaymentsA2AServerResult => PaymentsA2AServer.start({ ...options, paymentsService: this }),\n\n      /**\n       * Gets (or creates) a RegisteredPaymentsClient for the given alias.\n       * The registry is initialized only on first use.\n       * @param options - ClientRegistryOptions.\n       */\n      getClient: async (options: any) => {\n        if (!this._a2aRegistry) {\n          this._a2aRegistry = new ClientRegistry(this)\n        }\n        return await this._a2aRegistry.getClient(options)\n      },\n    }\n  }\n\n  /**\n   * Returns the MCP integration API. The instance is memoized so that configuration\n   * set via `configure({ agentId, serverName })` persists across calls.\n   */\n  public get mcp() {\n    if (!this._mcpIntegration) {\n      this._mcpIntegration = mcpModule.buildMcpIntegration(this)\n    }\n    return this._mcpIntegration\n  }\n\n  /**\n   * Returns the Delegation API for listing enrolled payment methods.\n   * The instance is lazily initialized on first access.\n   */\n  public get delegation(): DelegationAPI {\n    if (!this._delegation) {\n      this._delegation = DelegationAPI.getInstance({\n        nvmApiKey: this.nvmApiKey,\n        environment: this.environmentName,\n      })\n    }\n    return this._delegation\n  }\n\n  /**\n   * Static A2A helpers and utilities.\n   * Example: Payments.a2a.buildPaymentAgentCard(...)\n   */\n  static a2a = { buildPaymentAgentCard }\n\n  /**\n   * Get an instance of the Payments class for server-side usage.\n   *\n   * @param options - The options to initialize the payments class.\n   * @example\n   * ```\n   * const payments = Payments.getInstance({\n   *   nvmApiKey: 'your-nvm-api-key',\n   *   environment: 'sandbox'\n   * })\n   * ```\n   * @returns An instance of {@link Payments}\n   * @throws PaymentsError if nvmApiKey is missing.\n   */\n  static getInstance(options: PaymentOptions) {\n    if (!options.nvmApiKey) {\n      throw new PaymentsError('Nevermined API Key is required')\n    }\n    return new Payments(options, false)\n  }\n\n  /**\n   * Get an instance of the Payments class for browser usage.\n   *\n   * @remarks\n   * This is a browser-only function.\n   *\n   * @param options - The options to initialize the payments class.\n   * @example\n   * ```\n   * const payments = Payments.getBrowserInstance({\n   *   returnUrl: 'https://mysite.example',\n   *   environment: 'sandbox',\n   *   appId: 'my-app-id',\n   *   version: '1.0.0'\n   * })\n   * ```\n   * @returns An instance of {@link Payments}\n   * @throws PaymentsError if returnUrl is missing.\n   */\n  static getBrowserInstance(options: PaymentOptions) {\n    if (!options.returnUrl) {\n      throw new PaymentsError('returnUrl is required')\n    }\n    const url = new URL(window.location.href)\n    const urlNvmApiKey = url.searchParams.get('nvmApiKey') as string\n    if (urlNvmApiKey) {\n      url.searchParams.delete('nvmApiKey')\n    }\n\n    const urlAccountAddress = url.searchParams.get('accountAddress') as string\n    if (urlAccountAddress) {\n      url.searchParams.delete('accountAddress')\n    }\n\n    history.replaceState(history.state, '', url.toString())\n\n    return new Payments(options, true)\n  }\n\n  /**\n   * Initializes the Payments class.\n   *\n   * @param options - The options to initialize the payments class.\n   * @param isBrowserInstance - Whether this instance is for browser usage.\n   */\n  private constructor(options: PaymentOptions, isBrowserInstance = true) {\n    super(options)\n\n    this.isBrowserInstance = isBrowserInstance\n    this.initializeApi(options)\n  }\n\n  /**\n   * Initializes the AI Query Protocol API.\n   */\n  private initializeApi(options: PaymentOptions) {\n    this.plans = PlansAPI.getInstance(options)\n    this.agents = AgentsAPI.getInstance(options)\n    this.requests = AgentRequestsAPI.getInstance(options)\n    this.observability = ObservabilityAPI.getInstance(options)\n    this.organizations = OrganizationsAPI.getInstance(options)\n    this.query = AIQueryApi.getInstance()\n    this.contracts = new ContractsAPI(options)\n    if (options.scheme === 'visa') {\n      this.facilitator = VisaFacilitatorAPI.getInstance(options)\n      this.x402 = VisaTokenAPI.getInstance(options)\n    } else {\n      this.facilitator = FacilitatorAPI.getInstance(options)\n      this.x402 = X402TokenAPI.getInstance(options)\n    }\n  }\n\n  /**\n   * Initiates the connect flow. The user's browser will be redirected to\n   * the Nevermined App login page.\n   *\n   * @remarks\n   * This is a browser-only function.\n   * @example\n   * ```\n   * payments.connect()\n   * ```\n   */\n  public connect() {\n    if (!this.isBrowserInstance) return\n    const url = new URL(`/login?returnUrl=${this.returnUrl}`, this.environment.frontend)\n    window.location.href = url.toString()\n  }\n\n  /**\n   * Logs out the user by removing the NVM API key.\n   *\n   * @remarks\n   * This is a browser-only function.\n   * @example\n   * ```\n   * payments.logout()\n   * ```\n   */\n  public logout() {\n    this.nvmApiKey = ''\n  }\n\n  /**\n   * Checks if a user is logged in.\n   * @example\n   * ```\n   * payments.isLoggedIn\n   * ```\n   * @returns True if the user is logged in.\n   */\n  get isLoggedIn(): boolean {\n    return this.nvmApiKey.length > 0\n  }\n}\n"]}
+{"version":3,"file":"payments.js","sourceRoot":"","sources":["../src/payments.ts"],"names":[],"mappings":"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","sourcesContent":["import { AIQueryApi } from './api/query-api.js'\nimport { PaymentsError } from './common/payments.error.js'\nimport { PaymentOptions } from './common/types.js'\nimport { BasePaymentsAPI } from './api/base-payments.js'\nimport { PlansAPI } from './api/plans-api.js'\nimport { ContractsAPI } from './api/contracts-api.js'\nimport { AgentsAPI } from './api/agents-api.js'\nimport { AgentRequestsAPI } from './api/requests-api.js'\nimport { ObservabilityAPI } from './api/observability-api/observability-api.js'\nimport { ClientRegistry } from './a2a/clientRegistry.js'\nimport type { PaymentsA2AServerOptions, PaymentsA2AServerResult } from './a2a/server.js'\nimport { PaymentsA2AServer } from './a2a/server.js'\nimport { buildPaymentAgentCard } from './a2a/agent-card.js'\nimport * as mcpModule from './mcp/index.js'\nimport { OrganizationsAPI } from './api/organizations-api/organizations-api.js'\nimport { FacilitatorAPI } from './x402/facilitator-api.js'\nimport { X402TokenAPI } from './x402/token.js'\nimport { DelegationAPI } from './x402/delegation-api.js'\n\n/**\n * Main class that interacts with the Nevermined payments API.\n * Use `Payments.getInstance` for server-side usage or `Payments.getBrowserInstance` for browser usage.\n * @remarks This API requires a Nevermined API Key, which can be obtained by logging in to the Nevermined App.\n *\n * The library provides methods to manage AI Agents, Plans & process AI Agent Requests.\n *\n * Each of these functionalities is encapsulated in its own API class:\n * - `plans`: Manages AI Plans, including registration and ordering and retrieving plan details.\n * - `agents`: Handles AI Agents, including registration of AI Agents and access token generation.\n * - `requests`: Manages requests received by AI Agents, including validation and tracking.\n * - `observability`: Provides observability and logging utilities for AI Agents with Helicone integration\n */\nexport class Payments extends BasePaymentsAPI {\n  public query!: AIQueryApi\n  public plans!: PlansAPI\n  public agents!: AgentsAPI\n  public requests!: AgentRequestsAPI\n  public observability!: ObservabilityAPI\n  public organizations!: OrganizationsAPI\n  public contracts!: ContractsAPI\n  public facilitator!: FacilitatorAPI\n  public x402!: X402TokenAPI\n  private _a2aRegistry?: ClientRegistry\n  private _delegation?: DelegationAPI\n\n  /**\n   * Cached MCP integration to preserve configuration (e.g., agentId, serverName)\n   * across multiple getter accesses. This ensures callers do not need to retain\n   * a reference to a previously configured instance.\n   */\n  private _mcpIntegration?: ReturnType<typeof mcpModule.buildMcpIntegration>\n\n  /**\n   * Exposes A2A server and client registry methods.\n   * The client registry is initialized only if getClient is called.\n   */\n  public get a2a() {\n    return {\n      /**\n       * Starts the A2A server with payment integration.\n       * @param options - Server options.\n       */\n      start: (\n        options: Omit<PaymentsA2AServerOptions, 'paymentsService'>,\n      ): PaymentsA2AServerResult => PaymentsA2AServer.start({ ...options, paymentsService: this }),\n\n      /**\n       * Gets (or creates) a RegisteredPaymentsClient for the given alias.\n       * The registry is initialized only on first use.\n       * @param options - ClientRegistryOptions.\n       */\n      getClient: async (options: any) => {\n        if (!this._a2aRegistry) {\n          this._a2aRegistry = new ClientRegistry(this)\n        }\n        return await this._a2aRegistry.getClient(options)\n      },\n    }\n  }\n\n  /**\n   * Returns the MCP integration API. The instance is memoized so that configuration\n   * set via `configure({ agentId, serverName })` persists across calls.\n   */\n  public get mcp() {\n    if (!this._mcpIntegration) {\n      this._mcpIntegration = mcpModule.buildMcpIntegration(this)\n    }\n    return this._mcpIntegration\n  }\n\n  /**\n   * Returns the Delegation API for listing enrolled payment methods.\n   * The instance is lazily initialized on first access.\n   */\n  public get delegation(): DelegationAPI {\n    if (!this._delegation) {\n      this._delegation = DelegationAPI.getInstance({\n        nvmApiKey: this.nvmApiKey,\n        environment: this.environmentName,\n      })\n    }\n    return this._delegation\n  }\n\n  /**\n   * Static A2A helpers and utilities.\n   * Example: Payments.a2a.buildPaymentAgentCard(...)\n   */\n  static a2a = { buildPaymentAgentCard }\n\n  /**\n   * Get an instance of the Payments class for server-side usage.\n   *\n   * @param options - The options to initialize the payments class.\n   * @example\n   * ```\n   * const payments = Payments.getInstance({\n   *   nvmApiKey: 'your-nvm-api-key',\n   *   environment: 'sandbox'\n   * })\n   * ```\n   * @returns An instance of {@link Payments}\n   * @throws PaymentsError if nvmApiKey is missing.\n   */\n  static getInstance(options: PaymentOptions) {\n    if (!options.nvmApiKey) {\n      throw new PaymentsError('Nevermined API Key is required')\n    }\n    return new Payments(options, false)\n  }\n\n  /**\n   * Get an instance of the Payments class for browser usage.\n   *\n   * @remarks\n   * This is a browser-only function.\n   *\n   * @param options - The options to initialize the payments class.\n   * @example\n   * ```\n   * const payments = Payments.getBrowserInstance({\n   *   returnUrl: 'https://mysite.example',\n   *   environment: 'sandbox',\n   *   appId: 'my-app-id',\n   *   version: '1.0.0'\n   * })\n   * ```\n   * @returns An instance of {@link Payments}\n   * @throws PaymentsError if returnUrl is missing.\n   */\n  static getBrowserInstance(options: PaymentOptions) {\n    if (!options.returnUrl) {\n      throw new PaymentsError('returnUrl is required')\n    }\n    const url = new URL(window.location.href)\n    const urlNvmApiKey = url.searchParams.get('nvmApiKey') as string\n    if (urlNvmApiKey) {\n      url.searchParams.delete('nvmApiKey')\n    }\n\n    const urlAccountAddress = url.searchParams.get('accountAddress') as string\n    if (urlAccountAddress) {\n      url.searchParams.delete('accountAddress')\n    }\n\n    history.replaceState(history.state, '', url.toString())\n\n    return new Payments(options, true)\n  }\n\n  /**\n   * Initializes the Payments class.\n   *\n   * @param options - The options to initialize the payments class.\n   * @param isBrowserInstance - Whether this instance is for browser usage.\n   */\n  private constructor(options: PaymentOptions, isBrowserInstance = true) {\n    super(options)\n\n    this.isBrowserInstance = isBrowserInstance\n    this.initializeApi(options)\n  }\n\n  /**\n   * Initializes the AI Query Protocol API.\n   */\n  private initializeApi(options: PaymentOptions) {\n    this.plans = PlansAPI.getInstance(options)\n    this.agents = AgentsAPI.getInstance(options)\n    this.requests = AgentRequestsAPI.getInstance(options)\n    this.observability = ObservabilityAPI.getInstance(options)\n    this.organizations = OrganizationsAPI.getInstance(options)\n    this.query = AIQueryApi.getInstance()\n    this.contracts = new ContractsAPI(options)\n    this.facilitator = FacilitatorAPI.getInstance(options)\n    this.x402 = X402TokenAPI.getInstance(options)\n  }\n\n  /**\n   * Initiates the connect flow. The user's browser will be redirected to\n   * the Nevermined App login page.\n   *\n   * @remarks\n   * This is a browser-only function.\n   * @example\n   * ```\n   * payments.connect()\n   * ```\n   */\n  public connect() {\n    if (!this.isBrowserInstance) return\n    const url = new URL(`/login?returnUrl=${this.returnUrl}`, this.environment.frontend)\n    window.location.href = url.toString()\n  }\n\n  /**\n   * Logs out the user by removing the NVM API key.\n   *\n   * @remarks\n   * This is a browser-only function.\n   * @example\n   * ```\n   * payments.logout()\n   * ```\n   */\n  public logout() {\n    this.nvmApiKey = ''\n  }\n\n  /**\n   * Checks if a user is logged in.\n   * @example\n   * ```\n   * payments.isLoggedIn\n   * ```\n   * @returns True if the user is logged in.\n   */\n  get isLoggedIn(): boolean {\n    return this.nvmApiKey.length > 0\n  }\n}\n"]}

package/dist/plans.d.ts

@@ -1,11 +1,22 @@
-import { Address, PlanCreditsConfig, PlanPriceConfig, PlanRedemptionType } from './common/types.js';
+import { Address, Currency, PlanCreditsConfig, PlanPriceConfig, PlanRedemptionType } from './common/types.js';
 export declare const ONE_DAY_DURATION = 86400n;
 export declare const ONE_WEEK_DURATION = 604800n;
 export declare const ONE_MONTH_DURATION = 2629746n;
 export declare const ONE_YEAR_DURATION = 31557600n;
-export declare const getFiatPriceConfig: (amount: bigint, receiver: Address) => PlanPriceConfig;
+export declare const getFiatPriceConfig: (amount: bigint, receiver: Address, currency?: Currency | string) => PlanPriceConfig;
 export declare const getCryptoPriceConfig: (amount: bigint, receiver: Address, tokenAddress?: Address) => PlanPriceConfig;
 export declare const getERC20PriceConfig: (amount: bigint, tokenAddress: Address, receiver: Address) => PlanPriceConfig;
+/**
+ * Builds a price configuration for EURC (Euro stablecoin) payments.
+ *
+ * EURC uses 6 decimal places. To charge €29.00, pass `29_000_000n`.
+ *
+ * @param amount - Amount in the token's smallest unit (6 decimals for EURC).
+ * @param receiver - Wallet address that will receive the payment.
+ * @param eurcAddress - Optional EURC token address. Defaults to Base Mainnet EURC.
+ * @returns The PlanPriceConfig representing an EURC price.
+ */
+export declare const getEURCPriceConfig: (amount: bigint, receiver: Address, eurcAddress?: Address) => PlanPriceConfig;
 export declare const getFreePriceConfig: () => PlanPriceConfig;
 export declare const getNativeTokenPriceConfig: (amount: bigint, receiver: Address) => PlanPriceConfig;
 export declare const getExpirableDurationConfig: (durationOfPlan: bigint) => PlanCreditsConfig;
@@ -13,7 +24,7 @@ export declare const getNonExpirableDurationConfig: () => PlanCreditsConfig;
 export declare const getFixedCreditsConfig: (creditsGranted: bigint, creditsPerRequest?: bigint) => PlanCreditsConfig;
 export declare const getDynamicCreditsConfig: (creditsGranted: bigint, minCreditsPerRequest?: bigint, maxCreditsPerRequest?: bigint) => PlanCreditsConfig;
 export declare const setRedemptionType: (creditsConfig: PlanCreditsConfig, redemptionType: PlanRedemptionType) => PlanCreditsConfig;
-export declare const setProofRequired: (creditsConfig: PlanCreditsConfig, proofRequired?: boolean) => PlanCreditsConfig;
+export declare const setOnchainMirror: (creditsConfig: PlanCreditsConfig, onchainMirror?: boolean) => PlanCreditsConfig;
 /**
  * Build a pay-as-you-go price configuration.
  *

package/dist/plans.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plans.d.ts","sourceRoot":"","sources":["../src/plans.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAInG,eAAO,MAAM,gBAAgB,SAAU,CAAA;AACvC,eAAO,MAAM,iBAAiB,UAAW,CAAA;AACzC,eAAO,MAAM,kBAAkB,WAAa,CAAA;AAC5C,eAAO,MAAM,iBAAiB,YAAc,CAAA;AAE5C,eAAO,MAAM,kBAAkB,GAAI,QAAQ,MAAM,EAAE,UAAU,OAAO,KAAG,eAatE,CAAA;AAED,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,MAAM,EACd,UAAU,OAAO,EACjB,eAAc,OAAqB,KAClC,eAaF,CAAA;AAED,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,MAAM,EACd,cAAc,OAAO,EACrB,UAAU,OAAO,KAChB,eAEF,CAAA;AAED,eAAO,MAAM,kBAAkB,QAAO,eAWrC,CAAA;AAED,eAAO,MAAM,yBAAyB,GAAI,QAAQ,MAAM,EAAE,UAAU,OAAO,KAAG,eAE7E,CAAA;AAED,eAAO,MAAM,0BAA0B,GAAI,gBAAgB,MAAM,KAAG,iBAUnE,CAAA;AAED,eAAO,MAAM,6BAA6B,QAAO,iBAEhD,CAAA;AAED,eAAO,MAAM,qBAAqB,GAChC,gBAAgB,MAAM,EACtB,0BAAsB,KACrB,iBAUF,CAAA;AAED,eAAO,MAAM,uBAAuB,GAClC,gBAAgB,MAAM,EACtB,6BAAyB,EACzB,6BAAyB,KACxB,iBAUF,CAAA;AAED,eAAO,MAAM,iBAAiB,GAC5B,eAAe,iBAAiB,EAChC,gBAAgB,kBAAkB,KACjC,iBAKF,CAAA;AAED,eAAO,MAAM,gBAAgB,GAC3B,eAAe,iBAAiB,EAChC,uBAAoB,KACnB,iBAKF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GACnC,QAAQ,MAAM,EACd,UAAU,OAAO,EACjB,eAAc,OAAqB,EACnC,kBAAkB,OAAO,KACxB,eAoBF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,QAAO,iBAU7C,CAAA"}
+{"version":3,"file":"plans.d.ts","sourceRoot":"","sources":["../src/plans.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,QAAQ,EAER,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EACnB,MAAM,mBAAmB,CAAA;AAI1B,eAAO,MAAM,gBAAgB,SAAU,CAAA;AACvC,eAAO,MAAM,iBAAiB,UAAW,CAAA;AACzC,eAAO,MAAM,kBAAkB,WAAa,CAAA;AAC5C,eAAO,MAAM,iBAAiB,YAAc,CAAA;AAE5C,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,MAAM,EACd,UAAU,OAAO,EACjB,WAAU,QAAQ,GAAG,MAAqB,KACzC,eAcF,CAAA;AAED,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,MAAM,EACd,UAAU,OAAO,EACjB,eAAc,OAAqB,KAClC,eAaF,CAAA;AAED,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,MAAM,EACd,cAAc,OAAO,EACrB,UAAU,OAAO,KAChB,eAEF,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,MAAM,EACd,UAAU,OAAO,EACjB,cAAa,OAA4B,KACxC,eAKF,CAAA;AAED,eAAO,MAAM,kBAAkB,QAAO,eAWrC,CAAA;AAED,eAAO,MAAM,yBAAyB,GAAI,QAAQ,MAAM,EAAE,UAAU,OAAO,KAAG,eAE7E,CAAA;AAED,eAAO,MAAM,0BAA0B,GAAI,gBAAgB,MAAM,KAAG,iBAUnE,CAAA;AAED,eAAO,MAAM,6BAA6B,QAAO,iBAEhD,CAAA;AAED,eAAO,MAAM,qBAAqB,GAChC,gBAAgB,MAAM,EACtB,0BAAsB,KACrB,iBAUF,CAAA;AAED,eAAO,MAAM,uBAAuB,GAClC,gBAAgB,MAAM,EACtB,6BAAyB,EACzB,6BAAyB,KACxB,iBAUF,CAAA;AAED,eAAO,MAAM,iBAAiB,GAC5B,eAAe,iBAAiB,EAChC,gBAAgB,kBAAkB,KACjC,iBAKF,CAAA;AAED,eAAO,MAAM,gBAAgB,GAC3B,eAAe,iBAAiB,EAChC,uBAAoB,KACnB,iBAKF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GACnC,QAAQ,MAAM,EACd,UAAU,OAAO,EACjB,eAAc,OAAqB,EACnC,kBAAkB,OAAO,KACxB,eAoBF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,QAAO,iBAU7C,CAAA"}

package/dist/plans.js

@@ -1,11 +1,11 @@
-import { PlanRedemptionType } from './common/types.js';
+import { Currency, EURC_TOKEN_ADDRESS, PlanRedemptionType, } from './common/types.js';
 import { ZeroAddress } from './environments.js';
 import { isEthereumAddress } from './utils.js';
 export const ONE_DAY_DURATION = 86400n; // 24 * 60 * 60 seconds
 export const ONE_WEEK_DURATION = 604800n; // 7 * 24 * 60 * 60 seconds
 export const ONE_MONTH_DURATION = 2629746n; // (365.25 days/year ÷ 12 months/year) × 24 × 60 × 60 ≈ 2,629,746 seconds
 export const ONE_YEAR_DURATION = 31557600n; // 365.25 * 24 * 60 * 60 seconds
-export const getFiatPriceConfig = (amount, receiver) => {
+export const getFiatPriceConfig = (amount, receiver, currency = Currency.USD) => {
     if (!isEthereumAddress(receiver))
         throw new Error(`Receiver address ${receiver} is not a valid Ethereum address`);
     return {
@@ -17,6 +17,7 @@ export const getFiatPriceConfig = (amount, receiver) => {
         externalPriceAddress: ZeroAddress,
         templateAddress: ZeroAddress,
         isCrypto: false,
+        currency,
     };
 };
 export const getCryptoPriceConfig = (amount, receiver, tokenAddress = ZeroAddress) => {
@@ -36,6 +37,22 @@ export const getCryptoPriceConfig = (amount, receiver, tokenAddress = ZeroAddres
 export const getERC20PriceConfig = (amount, tokenAddress, receiver) => {
     return getCryptoPriceConfig(amount, receiver, tokenAddress);
 };
+/**
+ * Builds a price configuration for EURC (Euro stablecoin) payments.
+ *
+ * EURC uses 6 decimal places. To charge €29.00, pass `29_000_000n`.
+ *
+ * @param amount - Amount in the token's smallest unit (6 decimals for EURC).
+ * @param receiver - Wallet address that will receive the payment.
+ * @param eurcAddress - Optional EURC token address. Defaults to Base Mainnet EURC.
+ * @returns The PlanPriceConfig representing an EURC price.
+ */
+export const getEURCPriceConfig = (amount, receiver, eurcAddress = EURC_TOKEN_ADDRESS) => {
+    return {
+        ...getERC20PriceConfig(amount, eurcAddress, receiver),
+        currency: Currency.EURC,
+    };
+};
 export const getFreePriceConfig = () => {
     return {
         tokenAddress: ZeroAddress,
@@ -55,7 +72,7 @@ export const getExpirableDurationConfig = (durationOfPlan) => {
     return {
         isRedemptionAmountFixed: false,
         redemptionType: PlanRedemptionType.ONLY_SUBSCRIBER,
-        proofRequired: false,
+        onchainMirror: false,
         durationSecs: durationOfPlan,
         amount: 1n,
         minAmount: 1n,
@@ -69,7 +86,7 @@ export const getFixedCreditsConfig = (creditsGranted, creditsPerRequest = 1n) =>
     return {
         isRedemptionAmountFixed: true,
         redemptionType: PlanRedemptionType.ONLY_SUBSCRIBER,
-        proofRequired: false,
+        onchainMirror: false,
         durationSecs: 0n,
         amount: creditsGranted,
         minAmount: creditsPerRequest,
@@ -80,7 +97,7 @@ export const getDynamicCreditsConfig = (creditsGranted, minCreditsPerRequest = 1
     return {
         isRedemptionAmountFixed: false,
         redemptionType: PlanRedemptionType.ONLY_SUBSCRIBER,
-        proofRequired: false,
+        onchainMirror: false,
         durationSecs: 0n,
         amount: creditsGranted,
         minAmount: minCreditsPerRequest,
@@ -93,10 +110,10 @@ export const setRedemptionType = (creditsConfig, redemptionType) => {
         redemptionType,
     };
 };
-export const setProofRequired = (creditsConfig, proofRequired = true) => {
+export const setOnchainMirror = (creditsConfig, onchainMirror = true) => {
     return {
         ...creditsConfig,
-        proofRequired,
+        onchainMirror,
     };
 };
 /**
@@ -130,7 +147,7 @@ export const getPayAsYouGoCreditsConfig = () => {
     return {
         isRedemptionAmountFixed: false,
         redemptionType: PlanRedemptionType.ONLY_SUBSCRIBER,
-        proofRequired: false,
+        onchainMirror: false,
         durationSecs: 0n,
         amount: 1n,
         minAmount: 1n,

package/dist/plans.js.map

@@ -1 +1 @@
-{"version":3,"file":"plans.js","sourceRoot":"","sources":["../src/plans.ts"],"names":[],"mappings":"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","sourcesContent":["import { Address, PlanCreditsConfig, PlanPriceConfig, PlanRedemptionType } from './common/types.js'\nimport { ZeroAddress } from './environments.js'\nimport { isEthereumAddress } from './utils.js'\n\nexport const ONE_DAY_DURATION = 86_400n // 24 * 60 * 60 seconds\nexport const ONE_WEEK_DURATION = 604_800n // 7 * 24 * 60 * 60 seconds\nexport const ONE_MONTH_DURATION = 2_629_746n // (365.25 days/year ÷ 12 months/year) × 24 × 60 × 60 ≈ 2,629,746 seconds\nexport const ONE_YEAR_DURATION = 31_557_600n // 365.25 * 24 * 60 * 60 seconds\n\nexport const getFiatPriceConfig = (amount: bigint, receiver: Address): PlanPriceConfig => {\n  if (!isEthereumAddress(receiver))\n    throw new Error(`Receiver address ${receiver} is not a valid Ethereum address`)\n  return {\n    tokenAddress: ZeroAddress,\n    amounts: [amount],\n    receivers: [receiver],\n    contractAddress: ZeroAddress,\n    feeController: ZeroAddress,\n    externalPriceAddress: ZeroAddress,\n    templateAddress: ZeroAddress,\n    isCrypto: false,\n  }\n}\n\nexport const getCryptoPriceConfig = (\n  amount: bigint,\n  receiver: Address,\n  tokenAddress: Address = ZeroAddress,\n): PlanPriceConfig => {\n  if (!isEthereumAddress(receiver))\n    throw new Error(`Receiver address ${receiver} is not a valid Ethereum address`)\n  return {\n    tokenAddress,\n    amounts: [amount],\n    receivers: [receiver],\n    contractAddress: ZeroAddress,\n    feeController: ZeroAddress,\n    externalPriceAddress: ZeroAddress,\n    templateAddress: ZeroAddress,\n    isCrypto: true,\n  }\n}\n\nexport const getERC20PriceConfig = (\n  amount: bigint,\n  tokenAddress: Address,\n  receiver: Address,\n): PlanPriceConfig => {\n  return getCryptoPriceConfig(amount, receiver, tokenAddress)\n}\n\nexport const getFreePriceConfig = (): PlanPriceConfig => {\n  return {\n    tokenAddress: ZeroAddress,\n    amounts: [],\n    receivers: [],\n    contractAddress: ZeroAddress,\n    feeController: ZeroAddress,\n    externalPriceAddress: ZeroAddress,\n    templateAddress: ZeroAddress,\n    isCrypto: true,\n  }\n}\n\nexport const getNativeTokenPriceConfig = (amount: bigint, receiver: Address): PlanPriceConfig => {\n  return getCryptoPriceConfig(amount, receiver, ZeroAddress)\n}\n\nexport const getExpirableDurationConfig = (durationOfPlan: bigint): PlanCreditsConfig => {\n  return {\n    isRedemptionAmountFixed: false,\n    redemptionType: PlanRedemptionType.ONLY_SUBSCRIBER,\n    proofRequired: false,\n    durationSecs: durationOfPlan,\n    amount: 1n,\n    minAmount: 1n,\n    maxAmount: 1n,\n  }\n}\n\nexport const getNonExpirableDurationConfig = (): PlanCreditsConfig => {\n  return getExpirableDurationConfig(0n)\n}\n\nexport const getFixedCreditsConfig = (\n  creditsGranted: bigint,\n  creditsPerRequest = 1n,\n): PlanCreditsConfig => {\n  return {\n    isRedemptionAmountFixed: true,\n    redemptionType: PlanRedemptionType.ONLY_SUBSCRIBER,\n    proofRequired: false,\n    durationSecs: 0n,\n    amount: creditsGranted,\n    minAmount: creditsPerRequest,\n    maxAmount: creditsPerRequest,\n  }\n}\n\nexport const getDynamicCreditsConfig = (\n  creditsGranted: bigint,\n  minCreditsPerRequest = 1n,\n  maxCreditsPerRequest = 1n,\n): PlanCreditsConfig => {\n  return {\n    isRedemptionAmountFixed: false,\n    redemptionType: PlanRedemptionType.ONLY_SUBSCRIBER,\n    proofRequired: false,\n    durationSecs: 0n,\n    amount: creditsGranted,\n    minAmount: minCreditsPerRequest,\n    maxAmount: maxCreditsPerRequest,\n  }\n}\n\nexport const setRedemptionType = (\n  creditsConfig: PlanCreditsConfig,\n  redemptionType: PlanRedemptionType,\n): PlanCreditsConfig => {\n  return {\n    ...creditsConfig,\n    redemptionType,\n  }\n}\n\nexport const setProofRequired = (\n  creditsConfig: PlanCreditsConfig,\n  proofRequired = true,\n): PlanCreditsConfig => {\n  return {\n    ...creditsConfig,\n    proofRequired,\n  }\n}\n\n/**\n * Build a pay-as-you-go price configuration.\n *\n * For pay-as-you-go plans, the template address must come from the API deployment info.\n */\nexport const getPayAsYouGoPriceConfig = (\n  amount: bigint,\n  receiver: Address,\n  tokenAddress: Address = ZeroAddress,\n  templateAddress?: Address,\n): PlanPriceConfig => {\n  if (!isEthereumAddress(receiver))\n    throw new Error(`Receiver address ${receiver} is not a valid Ethereum address`)\n\n  if (!templateAddress) {\n    throw new Error(\n      'templateAddress is required. Use ContractsAPI.getPayAsYouGoTemplateAddress() or Payments.plans.getPayAsYouGoPriceConfig()',\n    )\n  }\n\n  return {\n    tokenAddress,\n    amounts: [amount],\n    receivers: [receiver],\n    contractAddress: ZeroAddress,\n    feeController: ZeroAddress,\n    externalPriceAddress: ZeroAddress,\n    templateAddress,\n    isCrypto: true,\n  }\n}\n\n/**\n * Build a pay-as-you-go credits configuration.\n *\n * Credits are not minted upfront; these values are required for validation only.\n */\nexport const getPayAsYouGoCreditsConfig = (): PlanCreditsConfig => {\n  return {\n    isRedemptionAmountFixed: false,\n    redemptionType: PlanRedemptionType.ONLY_SUBSCRIBER,\n    proofRequired: false,\n    durationSecs: 0n,\n    amount: 1n,\n    minAmount: 1n,\n    maxAmount: 1n,\n  }\n}\n"]}
+{"version":3,"file":"plans.js","sourceRoot":"","sources":["../src/plans.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Address,\n  Currency,\n  EURC_TOKEN_ADDRESS,\n  PlanCreditsConfig,\n  PlanPriceConfig,\n  PlanRedemptionType,\n} from './common/types.js'\nimport { ZeroAddress } from './environments.js'\nimport { isEthereumAddress } from './utils.js'\n\nexport const ONE_DAY_DURATION = 86_400n // 24 * 60 * 60 seconds\nexport const ONE_WEEK_DURATION = 604_800n // 7 * 24 * 60 * 60 seconds\nexport const ONE_MONTH_DURATION = 2_629_746n // (365.25 days/year ÷ 12 months/year) × 24 × 60 × 60 ≈ 2,629,746 seconds\nexport const ONE_YEAR_DURATION = 31_557_600n // 365.25 * 24 * 60 * 60 seconds\n\nexport const getFiatPriceConfig = (\n  amount: bigint,\n  receiver: Address,\n  currency: Currency | string = Currency.USD,\n): PlanPriceConfig => {\n  if (!isEthereumAddress(receiver))\n    throw new Error(`Receiver address ${receiver} is not a valid Ethereum address`)\n  return {\n    tokenAddress: ZeroAddress,\n    amounts: [amount],\n    receivers: [receiver],\n    contractAddress: ZeroAddress,\n    feeController: ZeroAddress,\n    externalPriceAddress: ZeroAddress,\n    templateAddress: ZeroAddress,\n    isCrypto: false,\n    currency,\n  }\n}\n\nexport const getCryptoPriceConfig = (\n  amount: bigint,\n  receiver: Address,\n  tokenAddress: Address = ZeroAddress,\n): PlanPriceConfig => {\n  if (!isEthereumAddress(receiver))\n    throw new Error(`Receiver address ${receiver} is not a valid Ethereum address`)\n  return {\n    tokenAddress,\n    amounts: [amount],\n    receivers: [receiver],\n    contractAddress: ZeroAddress,\n    feeController: ZeroAddress,\n    externalPriceAddress: ZeroAddress,\n    templateAddress: ZeroAddress,\n    isCrypto: true,\n  }\n}\n\nexport const getERC20PriceConfig = (\n  amount: bigint,\n  tokenAddress: Address,\n  receiver: Address,\n): PlanPriceConfig => {\n  return getCryptoPriceConfig(amount, receiver, tokenAddress)\n}\n\n/**\n * Builds a price configuration for EURC (Euro stablecoin) payments.\n *\n * EURC uses 6 decimal places. To charge €29.00, pass `29_000_000n`.\n *\n * @param amount - Amount in the token's smallest unit (6 decimals for EURC).\n * @param receiver - Wallet address that will receive the payment.\n * @param eurcAddress - Optional EURC token address. Defaults to Base Mainnet EURC.\n * @returns The PlanPriceConfig representing an EURC price.\n */\nexport const getEURCPriceConfig = (\n  amount: bigint,\n  receiver: Address,\n  eurcAddress: Address = EURC_TOKEN_ADDRESS,\n): PlanPriceConfig => {\n  return {\n    ...getERC20PriceConfig(amount, eurcAddress, receiver),\n    currency: Currency.EURC,\n  }\n}\n\nexport const getFreePriceConfig = (): PlanPriceConfig => {\n  return {\n    tokenAddress: ZeroAddress,\n    amounts: [],\n    receivers: [],\n    contractAddress: ZeroAddress,\n    feeController: ZeroAddress,\n    externalPriceAddress: ZeroAddress,\n    templateAddress: ZeroAddress,\n    isCrypto: true,\n  }\n}\n\nexport const getNativeTokenPriceConfig = (amount: bigint, receiver: Address): PlanPriceConfig => {\n  return getCryptoPriceConfig(amount, receiver, ZeroAddress)\n}\n\nexport const getExpirableDurationConfig = (durationOfPlan: bigint): PlanCreditsConfig => {\n  return {\n    isRedemptionAmountFixed: false,\n    redemptionType: PlanRedemptionType.ONLY_SUBSCRIBER,\n    onchainMirror: false,\n    durationSecs: durationOfPlan,\n    amount: 1n,\n    minAmount: 1n,\n    maxAmount: 1n,\n  }\n}\n\nexport const getNonExpirableDurationConfig = (): PlanCreditsConfig => {\n  return getExpirableDurationConfig(0n)\n}\n\nexport const getFixedCreditsConfig = (\n  creditsGranted: bigint,\n  creditsPerRequest = 1n,\n): PlanCreditsConfig => {\n  return {\n    isRedemptionAmountFixed: true,\n    redemptionType: PlanRedemptionType.ONLY_SUBSCRIBER,\n    onchainMirror: false,\n    durationSecs: 0n,\n    amount: creditsGranted,\n    minAmount: creditsPerRequest,\n    maxAmount: creditsPerRequest,\n  }\n}\n\nexport const getDynamicCreditsConfig = (\n  creditsGranted: bigint,\n  minCreditsPerRequest = 1n,\n  maxCreditsPerRequest = 1n,\n): PlanCreditsConfig => {\n  return {\n    isRedemptionAmountFixed: false,\n    redemptionType: PlanRedemptionType.ONLY_SUBSCRIBER,\n    onchainMirror: false,\n    durationSecs: 0n,\n    amount: creditsGranted,\n    minAmount: minCreditsPerRequest,\n    maxAmount: maxCreditsPerRequest,\n  }\n}\n\nexport const setRedemptionType = (\n  creditsConfig: PlanCreditsConfig,\n  redemptionType: PlanRedemptionType,\n): PlanCreditsConfig => {\n  return {\n    ...creditsConfig,\n    redemptionType,\n  }\n}\n\nexport const setOnchainMirror = (\n  creditsConfig: PlanCreditsConfig,\n  onchainMirror = true,\n): PlanCreditsConfig => {\n  return {\n    ...creditsConfig,\n    onchainMirror,\n  }\n}\n\n/**\n * Build a pay-as-you-go price configuration.\n *\n * For pay-as-you-go plans, the template address must come from the API deployment info.\n */\nexport const getPayAsYouGoPriceConfig = (\n  amount: bigint,\n  receiver: Address,\n  tokenAddress: Address = ZeroAddress,\n  templateAddress?: Address,\n): PlanPriceConfig => {\n  if (!isEthereumAddress(receiver))\n    throw new Error(`Receiver address ${receiver} is not a valid Ethereum address`)\n\n  if (!templateAddress) {\n    throw new Error(\n      'templateAddress is required. Use ContractsAPI.getPayAsYouGoTemplateAddress() or Payments.plans.getPayAsYouGoPriceConfig()',\n    )\n  }\n\n  return {\n    tokenAddress,\n    amounts: [amount],\n    receivers: [receiver],\n    contractAddress: ZeroAddress,\n    feeController: ZeroAddress,\n    externalPriceAddress: ZeroAddress,\n    templateAddress,\n    isCrypto: true,\n  }\n}\n\n/**\n * Build a pay-as-you-go credits configuration.\n *\n * Credits are not minted upfront; these values are required for validation only.\n */\nexport const getPayAsYouGoCreditsConfig = (): PlanCreditsConfig => {\n  return {\n    isRedemptionAmountFixed: false,\n    redemptionType: PlanRedemptionType.ONLY_SUBSCRIBER,\n    onchainMirror: false,\n    durationSecs: 0n,\n    amount: 1n,\n    minAmount: 1n,\n    maxAmount: 1n,\n  }\n}\n"]}

package/dist/x402/delegation-api.d.ts

@@ -1,43 +1,143 @@
 /**
- * Delegation API for managing card-delegation payment methods.
+ * Delegation API for managing payment delegations (crypto and card schemes).
  *
- * Provides access to the user's enrolled Stripe payment methods
- * for use with the nvm:card-delegation x402 scheme.
+ * Provides access to the user's enrolled payment methods and delegations
+ * for use with the nvm:erc4337 and nvm:card-delegation x402 schemes.
  */
 import { BasePaymentsAPI } from '../api/base-payments.js';
-import { PaymentOptions } from '../common/types.js';
+import { CreateDelegationPayload, CreateDelegationResponse, PaymentOptions } from '../common/types.js';
+/**
+ * Card-delegation providers exposed by the SDK. Use this when you want to
+ * restrict to card-shape entries only (e.g., filtering the heterogeneous
+ * list returned by {@link DelegationAPI.listPaymentMethods}).
+ */
+export type CardProvider = 'stripe' | 'braintree' | 'visa';
+/**
+ * All delegation providers, including the crypto path. Matches the
+ * server-side union and aligns with {@link CreateDelegationPayload.provider}.
+ */
+export type DelegationProvider = CardProvider | 'erc4337';
 /**
  * Summary of a user's enrolled payment method.
+ *
+ * The list returned by {@link DelegationAPI.listPaymentMethods} is
+ * heterogeneous: it includes enrolled cards (`provider` in
+ * `stripe` / `braintree` / `visa`) AND, when the user has a smart account
+ * configured, an entry for the user's ERC-4337 wallet
+ * (`provider: 'erc4337'`, `type: 'crypto_wallet'`, `brand: 'ethereum'`).
+ * Filter on `provider` when callers only want one shape.
  */
 export interface PaymentMethodSummary {
-    /** Payment method ID (e.g., 'pm_...') */
+    /** Payment method ID (Stripe 'pm_...', Braintree vault token, Visa Agentic
+     *  token id, or — for the erc4337 entry — the smart-account address) */
     id: string;
-    /** Card brand (e.g., 'visa', 'mastercard') */
+    /** Payment method type ('card' | 'crypto_wallet' | 'paypal' | …) */
+    type: string;
+    /** Card brand (e.g., 'visa', 'mastercard'), 'ethereum' for the erc4337
+     *  entry, or payment method type ('paypal', 'venmo') */
     brand: string;
-    /** Last 4 digits of the card number */
+    /** Last 4 digits (cards), trailing 4 chars of the wallet address
+     *  (erc4337), or email/username (PayPal/Venmo) */
     last4: string;
-    /** Card expiration month */
+    /** Expiration month (0 for non-card methods) */
     expMonth: number;
-    /** Card expiration year */
+    /** Expiration year (0 for non-card methods) */
     expYear: number;
+    /** Human-readable alias, if set */
+    alias?: string | null;
+    /** One of 'stripe' | 'braintree' | 'visa' | 'erc4337' */
+    provider?: DelegationProvider;
+    /** Current status ('Active' or 'Revoked') */
+    status?: string;
+    /** NVM API Key IDs allowed to use this payment method, or null if unrestricted */
+    allowedApiKeyIds?: string[] | null;
+}
+/**
+ * Summary of a delegation (card or crypto spending).
+ */
+export interface DelegationSummary {
+    delegationId: string;
+    provider: string;
+    providerPaymentMethodId: string;
+    status: string;
+    spendingLimitCents: string;
+    amountSpentCents: string;
+    remainingBudgetCents: string;
+    currency: string;
+    transactionCount: number;
+    expiresAt: string;
+    createdAt: string;
+    apiKeyId: string | null;
+}
+/**
+ * Paginated list of delegations returned by the API.
+ */
+export interface DelegationListResponse {
+    delegations: DelegationSummary[];
+    totalResults: number;
+    page: number;
+    offset: number;
+}
+/**
+ * Summary of an agent's purchasing power via card delegations.
+ */
+export interface PurchasingPower {
+    cards: PaymentMethodSummary[];
+    delegations: DelegationSummary[];
+    totalRemainingBudgetCents: number;
+    currency: string;
+}
+/**
+ * DTO for updating a payment method's alias and allowed API keys.
+ */
+export interface UpdatePaymentMethodDto {
+    alias?: string;
+    allowedApiKeyIds?: string[] | null;
+}
+/**
+ * Options for listing payment methods or delegations.
+ */
+export interface ListOptions {
+    /** When true, return only items accessible to the requesting API key */
+    accessible?: boolean;
 }
 /**
- * API for listing enrolled payment methods for card delegation.
+ * API for managing payment methods and delegations (card and crypto).
  */
 export declare class DelegationAPI extends BasePaymentsAPI {
-    /**
-     * Get an instance of the DelegationAPI class.
-     *
-     * @param options - The options to initialize the API
-     * @returns The instance of the DelegationAPI class
-     */
     static getInstance(options: PaymentOptions): DelegationAPI;
     /**
      * List the user's enrolled payment methods for card delegation.
+     * When `accessible: true`, only cards accessible to the requesting API key are returned.
+     */
+    listPaymentMethods(options?: ListOptions): Promise<PaymentMethodSummary[]>;
+    /**
+     * List the user's existing delegations.
+     * When `accessible: true`, only usable delegations (Active, non-expired, with budget) are returned.
+     */
+    listDelegations(options?: ListOptions): Promise<DelegationListResponse>;
+    /**
+     * Get the agent's purchasing power — accessible cards, active delegations,
+     * and combined remaining budget.
+     */
+    getPurchasingPower(): Promise<PurchasingPower>;
+    /**
+     * Create a new delegation for any supported provider (stripe, braintree,
+     * visa, or erc4337).
+     *
+     * Note: Visa delegations require a per-delegation device-binding ceremony
+     * (FIDO/passkey + assuranceData) that must be performed in the browser
+     * via the Nevermined webapp. The SDK can list and consume an already-
+     * created Visa delegation but cannot create one programmatically.
      *
-     * @returns A promise that resolves to an array of payment method summaries
-     * @throws PaymentsError if the request fails
+     * @param payload - The delegation creation parameters
+     * @returns The created delegation ID (and token for card delegations)
+     */
+    createDelegation(payload: CreateDelegationPayload): Promise<CreateDelegationResponse>;
+    /**
+     * Update a payment method's alias and/or allowed API keys.
      */
-    listPaymentMethods(): Promise<PaymentMethodSummary[]>;
+    updatePaymentMethod(paymentMethodId: string, dto: UpdatePaymentMethodDto): Promise<PaymentMethodSummary>;
+    private fetchJSON;
 }
 //# sourceMappingURL=delegation-api.d.ts.map

package/dist/x402/delegation-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delegation-api.d.ts","sourceRoot":"","sources":["../../src/x402/delegation-api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEnD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAA;IACV,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAA;IACb,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAA;IACb,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,eAAe;IAChD;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa;IAI1D;;;;;OAKG;IACG,kBAAkB,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;CA0B5D"}
+{"version":3,"file":"delegation-api.d.ts","sourceRoot":"","sources":["../../src/x402/delegation-api.ts"],"names":[],"mappings":"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"}

package/dist/x402/delegation-api.js

@@ -1,53 +1,107 @@
 /**
- * Delegation API for managing card-delegation payment methods.
+ * Delegation API for managing payment delegations (crypto and card schemes).
  *
- * Provides access to the user's enrolled Stripe payment methods
- * for use with the nvm:card-delegation x402 scheme.
+ * Provides access to the user's enrolled payment methods and delegations
+ * for use with the nvm:erc4337 and nvm:card-delegation x402 schemes.
  */
 import { BasePaymentsAPI } from '../api/base-payments.js';
 import { PaymentsError } from '../common/payments.error.js';
 /**
- * API for listing enrolled payment methods for card delegation.
+ * API for managing payment methods and delegations (card and crypto).
  */
 export class DelegationAPI extends BasePaymentsAPI {
-    /**
-     * Get an instance of the DelegationAPI class.
-     *
-     * @param options - The options to initialize the API
-     * @returns The instance of the DelegationAPI class
-     */
     static getInstance(options) {
         return new DelegationAPI(options);
     }
     /**
      * List the user's enrolled payment methods for card delegation.
+     * When `accessible: true`, only cards accessible to the requesting API key are returned.
+     */
+    async listPaymentMethods(options) {
+        const url = new URL('/api/v1/payment-methods', this.environment.backend);
+        if (options?.accessible)
+            url.searchParams.set('accessible', 'true');
+        return this.fetchJSON(url, 'GET', 'list payment methods');
+    }
+    /**
+     * List the user's existing delegations.
+     * When `accessible: true`, only usable delegations (Active, non-expired, with budget) are returned.
+     */
+    async listDelegations(options) {
+        const url = new URL('/api/v1/delegation', this.environment.backend);
+        if (options?.accessible)
+            url.searchParams.set('accessible', 'true');
+        return this.fetchJSON(url, 'GET', 'list delegations');
+    }
+    /**
+     * Get the agent's purchasing power — accessible cards, active delegations,
+     * and combined remaining budget.
+     */
+    async getPurchasingPower() {
+        const accessible = { accessible: true };
+        const [cards, { delegations }] = await Promise.all([
+            this.listPaymentMethods(accessible),
+            this.listDelegations(accessible),
+        ]);
+        const totalRemainingBudgetCents = delegations.reduce((sum, d) => sum + (parseInt(d.remainingBudgetCents, 10) || 0), 0);
+        return {
+            cards,
+            delegations,
+            totalRemainingBudgetCents,
+            currency: delegations[0]?.currency ?? 'usd',
+        };
+    }
+    /**
+     * Create a new delegation for any supported provider (stripe, braintree,
+     * visa, or erc4337).
      *
-     * @returns A promise that resolves to an array of payment method summaries
-     * @throws PaymentsError if the request fails
+     * Note: Visa delegations require a per-delegation device-binding ceremony
+     * (FIDO/passkey + assuranceData) that must be performed in the browser
+     * via the Nevermined webapp. The SDK can list and consume an already-
+     * created Visa delegation but cannot create one programmatically.
+     *
+     * @param payload - The delegation creation parameters
+     * @returns The created delegation ID (and token for card delegations)
      */
-    async listPaymentMethods() {
-        const url = new URL('/api/v1/delegation/payment-methods', this.environment.backend);
-        const options = this.getBackendHTTPOptions('GET');
+    async createDelegation(payload) {
+        const url = new URL('/api/v1/delegation/create', this.environment.backend);
+        return this.fetchJSON(url, 'POST', 'create delegation', payload);
+    }
+    /**
+     * Update a payment method's alias and/or allowed API keys.
+     */
+    async updatePaymentMethod(paymentMethodId, dto) {
+        const url = new URL(`/api/v1/payment-methods/${paymentMethodId}`, this.environment.backend);
+        return this.fetchJSON(url, 'PATCH', 'update payment method', dto);
+    }
+    // --- Private helpers ---
+    async fetchJSON(url, method, action, body) {
+        const options = this.getBackendHTTPOptions(method, body);
         try {
             const response = await fetch(url, options);
             if (!response.ok) {
-                let errorMessage = 'Failed to list payment methods';
+                let msg = `Failed to ${action}`;
+                let code = `http_${response.status}`;
                 try {
-                    const errorData = await response.json();
-                    errorMessage = errorData.message || errorMessage;
+                    const err = await response.json();
+                    if (err.message)
+                        msg = err.message;
+                    if (err.code)
+                        code = err.code;
+                    if (err.hint)
+                        msg = `${msg} — ${err.hint}`;
                 }
                 catch {
-                    // Use default error message
+                    // use default
                 }
-                throw PaymentsError.internal(`${errorMessage} (HTTP ${response.status})`);
+                throw new PaymentsError(`${msg} (HTTP ${response.status})`, code);
             }
             return await response.json();
         }
         catch (error) {
-            if (error instanceof PaymentsError) {
+            if (error instanceof PaymentsError)
                 throw error;
-            }
-            throw PaymentsError.internal(`Network error while listing payment methods: ${error instanceof Error ? error.message : String(error)}`);
+            throw PaymentsError.internal(`Network error while ${action}: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
 }

package/dist/x402/delegation-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"delegation-api.js","sourceRoot":"","sources":["../../src/x402/delegation-api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAmB3D;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,eAAe;IAChD;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,OAAuB;QACxC,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAA;IACnC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,kBAAkB;QACtB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,oCAAoC,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;QACnF,MAAM,OAAO,GAAG,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAA;QAEjD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;YAC1C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,IAAI,YAAY,GAAG,gCAAgC,CAAA;gBACnD,IAAI,CAAC;oBACH,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;oBACvC,YAAY,GAAG,SAAS,CAAC,OAAO,IAAI,YAAY,CAAA;gBAClD,CAAC;gBAAC,MAAM,CAAC;oBACP,4BAA4B;gBAC9B,CAAC;gBACD,MAAM,aAAa,CAAC,QAAQ,CAAC,GAAG,YAAY,UAAU,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;YAC3E,CAAC;YACD,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;gBACnC,MAAM,KAAK,CAAA;YACb,CAAC;YACD,MAAM,aAAa,CAAC,QAAQ,CAC1B,gDAAgD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACzG,CAAA;QACH,CAAC;IACH,CAAC;CACF","sourcesContent":["/**\n * Delegation API for managing card-delegation payment methods.\n *\n * Provides access to the user's enrolled Stripe payment methods\n * for use with the nvm:card-delegation x402 scheme.\n */\n\nimport { BasePaymentsAPI } from '../api/base-payments.js'\nimport { PaymentsError } from '../common/payments.error.js'\nimport { PaymentOptions } from '../common/types.js'\n\n/**\n * Summary of a user's enrolled payment method.\n */\nexport interface PaymentMethodSummary {\n  /** Payment method ID (e.g., 'pm_...') */\n  id: string\n  /** Card brand (e.g., 'visa', 'mastercard') */\n  brand: string\n  /** Last 4 digits of the card number */\n  last4: string\n  /** Card expiration month */\n  expMonth: number\n  /** Card expiration year */\n  expYear: number\n}\n\n/**\n * API for listing enrolled payment methods for card delegation.\n */\nexport class DelegationAPI extends BasePaymentsAPI {\n  /**\n   * Get an instance of the DelegationAPI class.\n   *\n   * @param options - The options to initialize the API\n   * @returns The instance of the DelegationAPI class\n   */\n  static getInstance(options: PaymentOptions): DelegationAPI {\n    return new DelegationAPI(options)\n  }\n\n  /**\n   * List the user's enrolled payment methods for card delegation.\n   *\n   * @returns A promise that resolves to an array of payment method summaries\n   * @throws PaymentsError if the request fails\n   */\n  async listPaymentMethods(): Promise<PaymentMethodSummary[]> {\n    const url = new URL('/api/v1/delegation/payment-methods', this.environment.backend)\n    const options = this.getBackendHTTPOptions('GET')\n\n    try {\n      const response = await fetch(url, options)\n      if (!response.ok) {\n        let errorMessage = 'Failed to list payment methods'\n        try {\n          const errorData = await response.json()\n          errorMessage = errorData.message || errorMessage\n        } catch {\n          // Use default error message\n        }\n        throw PaymentsError.internal(`${errorMessage} (HTTP ${response.status})`)\n      }\n      return await response.json()\n    } catch (error) {\n      if (error instanceof PaymentsError) {\n        throw error\n      }\n      throw PaymentsError.internal(\n        `Network error while listing payment methods: ${error instanceof Error ? error.message : String(error)}`,\n      )\n    }\n  }\n}\n"]}
+{"version":3,"file":"delegation-api.js","sourceRoot":"","sources":["../../src/x402/delegation-api.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Delegation API for managing payment delegations (crypto and card schemes).\n *\n * Provides access to the user's enrolled payment methods and delegations\n * for use with the nvm:erc4337 and nvm:card-delegation x402 schemes.\n */\n\nimport { BasePaymentsAPI } from '../api/base-payments.js'\nimport { PaymentsError } from '../common/payments.error.js'\nimport {\n  CreateDelegationPayload,\n  CreateDelegationResponse,\n  PaymentOptions,\n} from '../common/types.js'\n\n/**\n * Card-delegation providers exposed by the SDK. Use this when you want to\n * restrict to card-shape entries only (e.g., filtering the heterogeneous\n * list returned by {@link DelegationAPI.listPaymentMethods}).\n */\nexport type CardProvider = 'stripe' | 'braintree' | 'visa'\n\n/**\n * All delegation providers, including the crypto path. Matches the\n * server-side union and aligns with {@link CreateDelegationPayload.provider}.\n */\nexport type DelegationProvider = CardProvider | 'erc4337'\n\n/**\n * Summary of a user's enrolled payment method.\n *\n * The list returned by {@link DelegationAPI.listPaymentMethods} is\n * heterogeneous: it includes enrolled cards (`provider` in\n * `stripe` / `braintree` / `visa`) AND, when the user has a smart account\n * configured, an entry for the user's ERC-4337 wallet\n * (`provider: 'erc4337'`, `type: 'crypto_wallet'`, `brand: 'ethereum'`).\n * Filter on `provider` when callers only want one shape.\n */\nexport interface PaymentMethodSummary {\n  /** Payment method ID (Stripe 'pm_...', Braintree vault token, Visa Agentic\n   *  token id, or — for the erc4337 entry — the smart-account address) */\n  id: string\n  /** Payment method type ('card' | 'crypto_wallet' | 'paypal' | …) */\n  type: string\n  /** Card brand (e.g., 'visa', 'mastercard'), 'ethereum' for the erc4337\n   *  entry, or payment method type ('paypal', 'venmo') */\n  brand: string\n  /** Last 4 digits (cards), trailing 4 chars of the wallet address\n   *  (erc4337), or email/username (PayPal/Venmo) */\n  last4: string\n  /** Expiration month (0 for non-card methods) */\n  expMonth: number\n  /** Expiration year (0 for non-card methods) */\n  expYear: number\n  /** Human-readable alias, if set */\n  alias?: string | null\n  /** One of 'stripe' | 'braintree' | 'visa' | 'erc4337' */\n  provider?: DelegationProvider\n  /** Current status ('Active' or 'Revoked') */\n  status?: string\n  /** NVM API Key IDs allowed to use this payment method, or null if unrestricted */\n  allowedApiKeyIds?: string[] | null\n}\n\n/**\n * Summary of a delegation (card or crypto spending).\n */\nexport interface DelegationSummary {\n  delegationId: string\n  provider: string\n  providerPaymentMethodId: string\n  status: string\n  spendingLimitCents: string\n  amountSpentCents: string\n  remainingBudgetCents: string\n  currency: string\n  transactionCount: number\n  expiresAt: string\n  createdAt: string\n  apiKeyId: string | null\n}\n\n/**\n * Paginated list of delegations returned by the API.\n */\nexport interface DelegationListResponse {\n  delegations: DelegationSummary[]\n  totalResults: number\n  page: number\n  offset: number\n}\n\n/**\n * Summary of an agent's purchasing power via card delegations.\n */\nexport interface PurchasingPower {\n  cards: PaymentMethodSummary[]\n  delegations: DelegationSummary[]\n  totalRemainingBudgetCents: number\n  currency: string\n}\n\n/**\n * DTO for updating a payment method's alias and allowed API keys.\n */\nexport interface UpdatePaymentMethodDto {\n  alias?: string\n  allowedApiKeyIds?: string[] | null\n}\n\n/**\n * Options for listing payment methods or delegations.\n */\nexport interface ListOptions {\n  /** When true, return only items accessible to the requesting API key */\n  accessible?: boolean\n}\n\n/**\n * API for managing payment methods and delegations (card and crypto).\n */\nexport class DelegationAPI extends BasePaymentsAPI {\n  static getInstance(options: PaymentOptions): DelegationAPI {\n    return new DelegationAPI(options)\n  }\n\n  /**\n   * List the user's enrolled payment methods for card delegation.\n   * When `accessible: true`, only cards accessible to the requesting API key are returned.\n   */\n  async listPaymentMethods(options?: ListOptions): Promise<PaymentMethodSummary[]> {\n    const url = new URL('/api/v1/payment-methods', this.environment.backend)\n    if (options?.accessible) url.searchParams.set('accessible', 'true')\n    return this.fetchJSON(url, 'GET', 'list payment methods')\n  }\n\n  /**\n   * List the user's existing delegations.\n   * When `accessible: true`, only usable delegations (Active, non-expired, with budget) are returned.\n   */\n  async listDelegations(options?: ListOptions): Promise<DelegationListResponse> {\n    const url = new URL('/api/v1/delegation', this.environment.backend)\n    if (options?.accessible) url.searchParams.set('accessible', 'true')\n    return this.fetchJSON(url, 'GET', 'list delegations')\n  }\n\n  /**\n   * Get the agent's purchasing power — accessible cards, active delegations,\n   * and combined remaining budget.\n   */\n  async getPurchasingPower(): Promise<PurchasingPower> {\n    const accessible = { accessible: true } satisfies ListOptions\n    const [cards, { delegations }] = await Promise.all([\n      this.listPaymentMethods(accessible),\n      this.listDelegations(accessible),\n    ])\n\n    const totalRemainingBudgetCents = delegations.reduce(\n      (sum, d) => sum + (parseInt(d.remainingBudgetCents, 10) || 0),\n      0,\n    )\n\n    return {\n      cards,\n      delegations,\n      totalRemainingBudgetCents,\n      currency: delegations[0]?.currency ?? 'usd',\n    }\n  }\n\n  /**\n   * Create a new delegation for any supported provider (stripe, braintree,\n   * visa, or erc4337).\n   *\n   * Note: Visa delegations require a per-delegation device-binding ceremony\n   * (FIDO/passkey + assuranceData) that must be performed in the browser\n   * via the Nevermined webapp. The SDK can list and consume an already-\n   * created Visa delegation but cannot create one programmatically.\n   *\n   * @param payload - The delegation creation parameters\n   * @returns The created delegation ID (and token for card delegations)\n   */\n  async createDelegation(payload: CreateDelegationPayload): Promise<CreateDelegationResponse> {\n    const url = new URL('/api/v1/delegation/create', this.environment.backend)\n    return this.fetchJSON(url, 'POST', 'create delegation', payload)\n  }\n\n  /**\n   * Update a payment method's alias and/or allowed API keys.\n   */\n  async updatePaymentMethod(\n    paymentMethodId: string,\n    dto: UpdatePaymentMethodDto,\n  ): Promise<PaymentMethodSummary> {\n    const url = new URL(`/api/v1/payment-methods/${paymentMethodId}`, this.environment.backend)\n    return this.fetchJSON(url, 'PATCH', 'update payment method', dto)\n  }\n\n  // --- Private helpers ---\n\n  private async fetchJSON<T>(url: URL, method: string, action: string, body?: unknown): Promise<T> {\n    const options = this.getBackendHTTPOptions(method, body)\n    try {\n      const response = await fetch(url, options)\n      if (!response.ok) {\n        let msg = `Failed to ${action}`\n        let code = `http_${response.status}`\n        try {\n          const err = await response.json()\n          if (err.message) msg = err.message\n          if (err.code) code = err.code\n          if (err.hint) msg = `${msg} — ${err.hint}`\n        } catch {\n          // use default\n        }\n        throw new PaymentsError(`${msg} (HTTP ${response.status})`, code)\n      }\n      return await response.json()\n    } catch (error) {\n      if (error instanceof PaymentsError) throw error\n      throw PaymentsError.internal(\n        `Network error while ${action}: ${error instanceof Error ? error.message : String(error)}`,\n      )\n    }\n  }\n}\n"]}

package/dist/x402/express/middleware.d.ts

@@ -69,6 +69,10 @@ export interface RouteConfig {
     network?: string;
     /** x402 scheme override (auto-detected from plan metadata if omitted) */
     scheme?: X402SchemeType;
+    /** Human-readable description of the protected resource */
+    description?: string;
+    /** Expected response MIME type (e.g., "application/json") */
+    mimeType?: string;
 }
 /**
  * Route configuration map: "METHOD \/path" -> RouteConfig