@t402/core 2.3.1 → 2.5.0

package/dist/esm/types/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/types/schemes/upto.ts"],"sourcesContent":["/**\n * Up-To Scheme Types\n *\n * The `upto` scheme authorizes transfer of up to a maximum amount,\n * enabling usage-based billing where the final settlement amount\n * is determined by actual usage.\n *\n * @example\n * ```typescript\n * // Client authorizes up to $1.00\n * const requirements: UptoPaymentRequirements = {\n *   scheme: 'upto',\n *   network: 'eip155:8453',\n *   maxAmount: '1000000',  // $1.00 in USDC\n *   minAmount: '10000',    // $0.01 minimum\n *   asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',\n *   payTo: '0x...',\n *   maxTimeoutSeconds: 300,\n *   extra: {\n *     unit: 'token',\n *     unitPrice: '100',\n *   },\n * };\n *\n * // Server settles for actual usage ($0.15)\n * const settlement: UptoSettlement = {\n *   settleAmount: '150000',\n *   usageDetails: {\n *     tokensGenerated: 1500,\n *     unitPrice: '100',\n *   },\n * };\n * ```\n */\n\nimport type { Network, PaymentRequirements } from \"../\";\n\n/**\n * Extended payment requirements for the upto scheme.\n */\nexport interface UptoPaymentRequirements extends Omit<PaymentRequirements, \"scheme\" | \"amount\"> {\n  /** Scheme identifier - always 'upto' */\n  scheme: \"upto\";\n\n  /** Network identifier (CAIP-2 format) */\n  network: Network;\n\n  /** Maximum amount the client authorizes (in smallest denomination) */\n  maxAmount: string;\n\n  /** Minimum settlement amount (prevents dust payments) */\n  minAmount?: string;\n\n  /** Asset contract address or identifier */\n  asset: string;\n\n  /** Recipient address */\n  payTo: string;\n\n  /** Maximum time in seconds before payment expires */\n  maxTimeoutSeconds: number;\n\n  /** Additional scheme-specific data */\n  extra: UptoExtra;\n}\n\n/**\n * Extra fields specific to the upto scheme.\n */\nexport interface UptoExtra extends Record<string, unknown> {\n  /** Billing unit (e.g., 'token', 'request', 'second', 'byte') */\n  unit?: string;\n\n  /** Price per unit in smallest denomination */\n  unitPrice?: string;\n\n  /** EIP-712 domain name (for EVM) */\n  name?: string;\n\n  /** EIP-712 domain version (for EVM) */\n  version?: string;\n\n  /** Router contract address (for EVM) */\n  routerAddress?: string;\n}\n\n/**\n * Base payload structure for upto scheme.\n */\nexport interface UptoPayloadBase {\n  /** Unique nonce to prevent replay attacks */\n  nonce: string;\n}\n\n/**\n * EVM-specific upto payload using EIP-2612 Permit.\n */\nexport interface UptoEvmPayload extends UptoPayloadBase {\n  /** EIP-2612 permit signature components */\n  signature: {\n    v: number;\n    r: `0x${string}`;\n    s: `0x${string}`;\n  };\n\n  /** Permit authorization parameters */\n  authorization: {\n    /** Token owner address */\n    owner: `0x${string}`;\n\n    /** Spender address (router contract) */\n    spender: `0x${string}`;\n\n    /** Maximum authorized value */\n    value: string;\n\n    /** Permit deadline (unix timestamp) */\n    deadline: string;\n\n    /** Permit nonce (from token contract) */\n    nonce: number;\n  };\n}\n\n/**\n * Alternative EVM payload with combined signature.\n */\nexport interface UptoEvmPayloadCompact extends UptoPayloadBase {\n  /** Combined EIP-2612 permit signature */\n  signature: `0x${string}`;\n\n  /** Permit authorization parameters */\n  authorization: {\n    owner: `0x${string}`;\n    spender: `0x${string}`;\n    value: string;\n    deadline: string;\n    nonce: number;\n  };\n}\n\n/**\n * Settlement request for upto scheme.\n */\nexport interface UptoSettlement {\n  /** Actual amount to settle (must be <= maxAmount) */\n  settleAmount: string;\n\n  /** Optional usage details for auditing */\n  usageDetails?: UptoUsageDetails;\n}\n\n/**\n * Usage details for settlement auditing.\n */\nexport interface UptoUsageDetails {\n  /** Number of units consumed */\n  unitsConsumed?: number;\n\n  /** Price per unit used */\n  unitPrice?: string;\n\n  /** Type of unit */\n  unitType?: string;\n\n  /** Start timestamp of usage period */\n  startTime?: number;\n\n  /** End timestamp of usage period */\n  endTime?: number;\n\n  /** Additional metadata */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Settlement response for upto scheme.\n */\nexport interface UptoSettlementResponse {\n  /** Whether settlement was successful */\n  success: boolean;\n\n  /** Transaction hash (if on-chain) */\n  transactionHash?: string;\n\n  /** Actual amount settled */\n  settledAmount: string;\n\n  /** Maximum amount that was authorized */\n  maxAmount: string;\n\n  /** Block number (if on-chain) */\n  blockNumber?: number;\n\n  /** Gas used (if on-chain) */\n  gasUsed?: string;\n\n  /** Error message if failed */\n  error?: string;\n}\n\n/**\n * Validation result for upto payment.\n */\nexport interface UptoValidationResult {\n  /** Whether the payment is valid */\n  isValid: boolean;\n\n  /** Reason if invalid */\n  invalidReason?: string;\n\n  /** Validated maximum amount */\n  validatedMaxAmount?: string;\n\n  /** Payer address */\n  payer?: string;\n\n  /** Expiration timestamp */\n  expiresAt?: number;\n}\n\n/**\n * Type guard for UptoPaymentRequirements.\n *\n * @param requirements - The value to check\n * @returns True if the value is UptoPaymentRequirements\n */\nexport function isUptoPaymentRequirements(\n  requirements: unknown,\n): requirements is UptoPaymentRequirements {\n  if (typeof requirements !== \"object\" || requirements === null) return false;\n  const req = requirements as Record<string, unknown>;\n  return req.scheme === \"upto\" && \"maxAmount\" in req;\n}\n\n/**\n * Type guard for UptoEvmPayload.\n *\n * @param payload - The value to check\n * @returns True if the value is UptoEvmPayload\n */\nexport function isUptoEvmPayload(payload: unknown): payload is UptoEvmPayload {\n  if (typeof payload !== \"object\" || payload === null) return false;\n  const p = payload as Record<string, unknown>;\n  return (\n    \"signature\" in p &&\n    \"authorization\" in p &&\n    typeof p.authorization === \"object\" &&\n    p.authorization !== null &&\n    \"owner\" in (p.authorization as Record<string, unknown>) &&\n    \"spender\" in (p.authorization as Record<string, unknown>) &&\n    \"value\" in (p.authorization as Record<string, unknown>) &&\n    \"deadline\" in (p.authorization as Record<string, unknown>)\n  );\n}\n\n/**\n * Constants for upto scheme.\n */\nexport const UPTO_SCHEME = \"upto\" as const;\n\nexport const UPTO_DEFAULTS = {\n  /** Default minimum settlement amount (prevents dust) */\n  MIN_AMOUNT: \"1000\",\n\n  /** Default maximum timeout in seconds (5 minutes) */\n  MAX_TIMEOUT_SECONDS: 300,\n\n  /** Supported billing units */\n  UNITS: [\"token\", \"request\", \"second\", \"minute\", \"byte\", \"kb\", \"mb\"] as const,\n} as const;\n\nexport type UptoUnit = (typeof UPTO_DEFAULTS.UNITS)[number];\n"],"mappings":";;;AAmOO,SAAS,0BACd,cACyC;AACzC,MAAI,OAAO,iBAAiB,YAAY,iBAAiB,KAAM,QAAO;AACtE,QAAM,MAAM;AACZ,SAAO,IAAI,WAAW,UAAU,eAAe;AACjD;AAQO,SAAS,iBAAiB,SAA6C;AAC5E,MAAI,OAAO,YAAY,YAAY,YAAY,KAAM,QAAO;AAC5D,QAAM,IAAI;AACV,SACE,eAAe,KACf,mBAAmB,KACnB,OAAO,EAAE,kBAAkB,YAC3B,EAAE,kBAAkB,QACpB,WAAY,EAAE,iBACd,aAAc,EAAE,iBAChB,WAAY,EAAE,iBACd,cAAe,EAAE;AAErB;AAKO,IAAM,cAAc;AAEpB,IAAM,gBAAgB;AAAA;AAAA,EAE3B,YAAY;AAAA;AAAA,EAGZ,qBAAqB;AAAA;AAAA,EAGrB,OAAO,CAAC,SAAS,WAAW,UAAU,UAAU,QAAQ,MAAM,IAAI;AACpE;","names":[]}
+{"version":3,"sources":["../../../src/types/a2a.ts","../../../src/types/schemes/upto.ts","../../../src/types/errors.ts"],"sourcesContent":["/**\n * A2A (Agent-to-Agent) Transport Types\n *\n * Implements t402 payment flows over the Agent-to-Agent protocol\n * using JSON-RPC messages and task-based state management.\n *\n * @see https://github.com/google-a2a/a2a-t402/v0.1\n */\n\nimport type { PaymentPayload, PaymentRequired } from \"./payments\";\nimport type { SettleResponse } from \"./facilitator\";\n\n// ============================================================================\n// A2A Payment Status\n// ============================================================================\n\n/**\n * Payment status values used in A2A metadata\n */\nexport type A2APaymentStatus =\n  | \"payment-required\" // Payment requirements sent to client\n  | \"payment-rejected\" // Client rejected payment requirements\n  | \"payment-submitted\" // Payment payload received by server\n  | \"payment-verified\" // Payment payload verified by server\n  | \"payment-completed\" // Payment settled on-chain successfully\n  | \"payment-failed\"; // Payment verification or settlement failed\n\n/**\n * A2A task states that correspond to payment states\n */\nexport type A2ATaskState =\n  | \"submitted\"\n  | \"working\"\n  | \"input-required\"\n  | \"completed\"\n  | \"canceled\"\n  | \"failed\"\n  | \"unknown\";\n\n// ============================================================================\n// A2A Message Types\n// ============================================================================\n\n/**\n * A2A message part - text content\n */\nexport interface A2ATextPart {\n  kind: \"text\";\n  text: string;\n}\n\n/**\n * A2A message part - file content\n */\nexport interface A2AFilePart {\n  kind: \"file\";\n  file: {\n    name?: string;\n    mimeType?: string;\n    bytes?: string; // base64 encoded\n    uri?: string;\n  };\n}\n\n/**\n * A2A message part - data content\n */\nexport interface A2ADataPart {\n  kind: \"data\";\n  data: Record<string, unknown>;\n}\n\nexport type A2AMessagePart = A2ATextPart | A2AFilePart | A2ADataPart;\n\n/**\n * A2A payment metadata fields\n */\nexport interface A2APaymentMetadata {\n  /** Current payment status */\n  \"t402.payment.status\"?: A2APaymentStatus;\n\n  /** Payment requirements (when status is payment-required) */\n  \"t402.payment.required\"?: PaymentRequired;\n\n  /** Payment payload (when status is payment-submitted) */\n  \"t402.payment.payload\"?: PaymentPayload;\n\n  /** Settlement receipts (when status is payment-completed or payment-failed) */\n  \"t402.payment.receipts\"?: SettleResponse[];\n\n  /** Error code (when status is payment-failed) */\n  \"t402.payment.error\"?: string;\n}\n\n/**\n * A2A message with payment metadata\n */\nexport interface A2AMessage {\n  kind: \"message\";\n  messageId?: string;\n  role: \"user\" | \"agent\";\n  parts: A2AMessagePart[];\n  metadata?: A2APaymentMetadata & Record<string, unknown>;\n}\n\n// ============================================================================\n// A2A Task Types\n// ============================================================================\n\n/**\n * A2A artifact (output from completed task)\n */\nexport interface A2AArtifact {\n  kind: string;\n  name?: string;\n  mimeType?: string;\n  data?: string; // base64 encoded\n  uri?: string;\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * A2A task status\n */\nexport interface A2ATaskStatus {\n  state: A2ATaskState;\n  message?: A2AMessage;\n  timestamp?: string;\n}\n\n/**\n * A2A task\n */\nexport interface A2ATask {\n  kind: \"task\";\n  id: string;\n  sessionId?: string;\n  status: A2ATaskStatus;\n  artifacts?: A2AArtifact[];\n  history?: A2AMessage[];\n  metadata?: Record<string, unknown>;\n}\n\n// ============================================================================\n// A2A JSON-RPC Types\n// ============================================================================\n\n/**\n * A2A JSON-RPC request\n */\nexport interface A2ARequest<T = unknown> {\n  jsonrpc: \"2.0\";\n  method: string;\n  id: string | number;\n  params?: T;\n}\n\n/**\n * A2A JSON-RPC response\n */\nexport interface A2AResponse<T = unknown> {\n  jsonrpc: \"2.0\";\n  id: string | number;\n  result?: T;\n  error?: A2AError;\n}\n\n/**\n * A2A JSON-RPC error\n */\nexport interface A2AError {\n  code: number;\n  message: string;\n  data?: unknown;\n}\n\n// ============================================================================\n// A2A Extension Types\n// ============================================================================\n\n/**\n * A2A extension declaration\n */\nexport interface A2AExtension {\n  uri: string;\n  description?: string;\n  required?: boolean;\n}\n\n/**\n * A2A agent capabilities\n */\nexport interface A2ACapabilities {\n  streaming?: boolean;\n  pushNotifications?: boolean;\n  stateTransitionHistory?: boolean;\n  extensions?: A2AExtension[];\n}\n\n/**\n * A2A agent card (service advertisement)\n */\nexport interface A2AAgentCard {\n  name: string;\n  description?: string;\n  url: string;\n  provider?: {\n    organization?: string;\n    url?: string;\n  };\n  version?: string;\n  documentationUrl?: string;\n  capabilities?: A2ACapabilities;\n  authentication?: {\n    schemes: string[];\n    credentials?: string;\n  };\n  defaultInputModes?: string[];\n  defaultOutputModes?: string[];\n  skills?: A2ASkill[];\n}\n\n/**\n * A2A skill definition\n */\nexport interface A2ASkill {\n  id: string;\n  name: string;\n  description?: string;\n  tags?: string[];\n  examples?: string[];\n  inputModes?: string[];\n  outputModes?: string[];\n}\n\n// ============================================================================\n// T402-A2A Constants\n// ============================================================================\n\n/**\n * T402 A2A extension URI\n */\nexport const T402_A2A_EXTENSION_URI = \"https://github.com/google-a2a/a2a-t402/v0.1\";\n\n/**\n * HTTP header for A2A extension activation\n */\nexport const A2A_EXTENSIONS_HEADER = \"X-A2A-Extensions\";\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Check if a task is in a payment-required state\n *\n * @param task - The A2A task to check\n * @returns Whether the task requires payment\n */\nexport function isPaymentRequired(task: A2ATask): boolean {\n  return (\n    task.status.state === \"input-required\" &&\n    task.status.message?.metadata?.[\"t402.payment.status\"] === \"payment-required\"\n  );\n}\n\n/**\n * Check if a task has completed payment\n *\n * @param task - The A2A task to check\n * @returns Whether the task has completed payment\n */\nexport function isPaymentCompleted(task: A2ATask): boolean {\n  return (\n    task.status.state === \"completed\" &&\n    task.status.message?.metadata?.[\"t402.payment.status\"] === \"payment-completed\"\n  );\n}\n\n/**\n * Check if a task has failed payment\n *\n * @param task - The A2A task to check\n * @returns Whether the task has failed payment\n */\nexport function isPaymentFailed(task: A2ATask): boolean {\n  return (\n    task.status.state === \"failed\" &&\n    task.status.message?.metadata?.[\"t402.payment.status\"] === \"payment-failed\"\n  );\n}\n\n/**\n * Extract payment requirements from a task\n *\n * @param task - The A2A task to extract requirements from\n * @returns The payment requirements if the task requires payment\n */\nexport function getPaymentRequired(task: A2ATask): PaymentRequired | undefined {\n  if (isPaymentRequired(task)) {\n    return task.status.message?.metadata?.[\"t402.payment.required\"];\n  }\n  return undefined;\n}\n\n/**\n * Extract payment receipts from a task\n *\n * @param task - The A2A task to extract receipts from\n * @returns The settlement receipts if available\n */\nexport function getPaymentReceipts(task: A2ATask): SettleResponse[] | undefined {\n  return task.status.message?.metadata?.[\"t402.payment.receipts\"];\n}\n\n/**\n * Create a payment-required message\n *\n * @param paymentRequired - The payment requirements\n * @param text - Optional message text\n * @returns An A2A message with payment-required metadata\n */\nexport function createPaymentRequiredMessage(\n  paymentRequired: PaymentRequired,\n  text: string = \"Payment is required to complete this request.\",\n): A2AMessage {\n  return {\n    kind: \"message\",\n    role: \"agent\",\n    parts: [{ kind: \"text\", text }],\n    metadata: {\n      \"t402.payment.status\": \"payment-required\",\n      \"t402.payment.required\": paymentRequired,\n    },\n  };\n}\n\n/**\n * Create a payment submission message\n *\n * @param paymentPayload - The payment payload to submit\n * @param text - Optional message text\n * @returns An A2A message with payment-submitted metadata\n */\nexport function createPaymentSubmissionMessage(\n  paymentPayload: PaymentPayload,\n  text: string = \"Here is the payment authorization.\",\n): A2AMessage {\n  return {\n    kind: \"message\",\n    role: \"user\",\n    parts: [{ kind: \"text\", text }],\n    metadata: {\n      \"t402.payment.status\": \"payment-submitted\",\n      \"t402.payment.payload\": paymentPayload,\n    },\n  };\n}\n\n/**\n * Create a payment completed message\n *\n * @param receipts - The settlement receipts\n * @param text - Optional message text\n * @returns An A2A message with payment-completed metadata\n */\nexport function createPaymentCompletedMessage(\n  receipts: SettleResponse[],\n  text: string = \"Payment successful.\",\n): A2AMessage {\n  return {\n    kind: \"message\",\n    role: \"agent\",\n    parts: [{ kind: \"text\", text }],\n    metadata: {\n      \"t402.payment.status\": \"payment-completed\",\n      \"t402.payment.receipts\": receipts,\n    },\n  };\n}\n\n/**\n * Create a payment failed message\n *\n * @param receipts - The settlement receipts\n * @param errorCode - The error code\n * @param text - Optional message text\n * @returns An A2A message with payment-failed metadata\n */\nexport function createPaymentFailedMessage(\n  receipts: SettleResponse[],\n  errorCode: string,\n  text: string = \"Payment failed.\",\n): A2AMessage {\n  return {\n    kind: \"message\",\n    role: \"agent\",\n    parts: [{ kind: \"text\", text }],\n    metadata: {\n      \"t402.payment.status\": \"payment-failed\",\n      \"t402.payment.error\": errorCode,\n      \"t402.payment.receipts\": receipts,\n    },\n  };\n}\n\n/**\n * Create a T402 extension declaration for agent cards\n *\n * @param required - Whether the extension is required\n * @returns An A2A extension declaration\n */\nexport function createT402Extension(required: boolean = false): A2AExtension {\n  return {\n    uri: T402_A2A_EXTENSION_URI,\n    description: \"Supports payments using the t402 protocol for on-chain settlement.\",\n    required,\n  };\n}\n","/**\n * Up-To Scheme Types\n *\n * The `upto` scheme authorizes transfer of up to a maximum amount,\n * enabling usage-based billing where the final settlement amount\n * is determined by actual usage.\n *\n * @example\n * ```typescript\n * // Client authorizes up to $1.00\n * const requirements: UptoPaymentRequirements = {\n *   scheme: 'upto',\n *   network: 'eip155:8453',\n *   maxAmount: '1000000',  // $1.00 in USDC\n *   minAmount: '10000',    // $0.01 minimum\n *   asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',\n *   payTo: '0x...',\n *   maxTimeoutSeconds: 300,\n *   extra: {\n *     unit: 'token',\n *     unitPrice: '100',\n *   },\n * };\n *\n * // Server settles for actual usage ($0.15)\n * const settlement: UptoSettlement = {\n *   settleAmount: '150000',\n *   usageDetails: {\n *     tokensGenerated: 1500,\n *     unitPrice: '100',\n *   },\n * };\n * ```\n */\n\nimport type { Network, PaymentRequirements } from \"../\";\n\n/**\n * Extended payment requirements for the upto scheme.\n */\nexport interface UptoPaymentRequirements extends Omit<PaymentRequirements, \"scheme\" | \"amount\"> {\n  /** Scheme identifier - always 'upto' */\n  scheme: \"upto\";\n\n  /** Network identifier (CAIP-2 format) */\n  network: Network;\n\n  /** Maximum amount the client authorizes (in smallest denomination) */\n  maxAmount: string;\n\n  /** Minimum settlement amount (prevents dust payments) */\n  minAmount?: string;\n\n  /** Asset contract address or identifier */\n  asset: string;\n\n  /** Recipient address */\n  payTo: string;\n\n  /** Maximum time in seconds before payment expires */\n  maxTimeoutSeconds: number;\n\n  /** Additional scheme-specific data */\n  extra: UptoExtra;\n}\n\n/**\n * Extra fields specific to the upto scheme.\n */\nexport interface UptoExtra extends Record<string, unknown> {\n  /** Billing unit (e.g., 'token', 'request', 'second', 'byte') */\n  unit?: string;\n\n  /** Price per unit in smallest denomination */\n  unitPrice?: string;\n\n  /** EIP-712 domain name (for EVM) */\n  name?: string;\n\n  /** EIP-712 domain version (for EVM) */\n  version?: string;\n\n  /** Router contract address (for EVM) */\n  routerAddress?: string;\n}\n\n/**\n * Base payload structure for upto scheme.\n */\nexport interface UptoPayloadBase {\n  /** Unique nonce to prevent replay attacks */\n  nonce: string;\n}\n\n/**\n * EVM-specific upto payload using EIP-2612 Permit.\n */\nexport interface UptoEvmPayload extends UptoPayloadBase {\n  /** EIP-2612 permit signature components */\n  signature: {\n    v: number;\n    r: `0x${string}`;\n    s: `0x${string}`;\n  };\n\n  /** Permit authorization parameters */\n  authorization: {\n    /** Token owner address */\n    owner: `0x${string}`;\n\n    /** Spender address (router contract) */\n    spender: `0x${string}`;\n\n    /** Maximum authorized value */\n    value: string;\n\n    /** Permit deadline (unix timestamp) */\n    deadline: string;\n\n    /** Permit nonce (from token contract) */\n    nonce: number;\n  };\n}\n\n/**\n * Alternative EVM payload with combined signature.\n */\nexport interface UptoEvmPayloadCompact extends UptoPayloadBase {\n  /** Combined EIP-2612 permit signature */\n  signature: `0x${string}`;\n\n  /** Permit authorization parameters */\n  authorization: {\n    owner: `0x${string}`;\n    spender: `0x${string}`;\n    value: string;\n    deadline: string;\n    nonce: number;\n  };\n}\n\n/**\n * Settlement request for upto scheme.\n */\nexport interface UptoSettlement {\n  /** Actual amount to settle (must be <= maxAmount) */\n  settleAmount: string;\n\n  /** Optional usage details for auditing */\n  usageDetails?: UptoUsageDetails;\n}\n\n/**\n * Usage details for settlement auditing.\n */\nexport interface UptoUsageDetails {\n  /** Number of units consumed */\n  unitsConsumed?: number;\n\n  /** Price per unit used */\n  unitPrice?: string;\n\n  /** Type of unit */\n  unitType?: string;\n\n  /** Start timestamp of usage period */\n  startTime?: number;\n\n  /** End timestamp of usage period */\n  endTime?: number;\n\n  /** Additional metadata */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Settlement response for upto scheme.\n */\nexport interface UptoSettlementResponse {\n  /** Whether settlement was successful */\n  success: boolean;\n\n  /** Transaction hash (if on-chain) */\n  transactionHash?: string;\n\n  /** Actual amount settled */\n  settledAmount: string;\n\n  /** Maximum amount that was authorized */\n  maxAmount: string;\n\n  /** Block number (if on-chain) */\n  blockNumber?: number;\n\n  /** Gas used (if on-chain) */\n  gasUsed?: string;\n\n  /** Error message if failed */\n  error?: string;\n}\n\n/**\n * Validation result for upto payment.\n */\nexport interface UptoValidationResult {\n  /** Whether the payment is valid */\n  isValid: boolean;\n\n  /** Reason if invalid */\n  invalidReason?: string;\n\n  /** Validated maximum amount */\n  validatedMaxAmount?: string;\n\n  /** Payer address */\n  payer?: string;\n\n  /** Expiration timestamp */\n  expiresAt?: number;\n}\n\n/**\n * Type guard for UptoPaymentRequirements.\n *\n * @param requirements - The value to check\n * @returns True if the value is UptoPaymentRequirements\n */\nexport function isUptoPaymentRequirements(\n  requirements: unknown,\n): requirements is UptoPaymentRequirements {\n  if (typeof requirements !== \"object\" || requirements === null) return false;\n  const req = requirements as Record<string, unknown>;\n  return req.scheme === \"upto\" && \"maxAmount\" in req;\n}\n\n/**\n * Type guard for UptoEvmPayload.\n *\n * @param payload - The value to check\n * @returns True if the value is UptoEvmPayload\n */\nexport function isUptoEvmPayload(payload: unknown): payload is UptoEvmPayload {\n  if (typeof payload !== \"object\" || payload === null) return false;\n  const p = payload as Record<string, unknown>;\n  return (\n    \"signature\" in p &&\n    \"authorization\" in p &&\n    typeof p.authorization === \"object\" &&\n    p.authorization !== null &&\n    \"owner\" in (p.authorization as Record<string, unknown>) &&\n    \"spender\" in (p.authorization as Record<string, unknown>) &&\n    \"value\" in (p.authorization as Record<string, unknown>) &&\n    \"deadline\" in (p.authorization as Record<string, unknown>)\n  );\n}\n\n/**\n * Constants for upto scheme.\n */\nexport const UPTO_SCHEME = \"upto\" as const;\n\nexport const UPTO_DEFAULTS = {\n  /** Default minimum settlement amount (prevents dust) */\n  MIN_AMOUNT: \"1000\",\n\n  /** Default maximum timeout in seconds (5 minutes) */\n  MAX_TIMEOUT_SECONDS: 300,\n\n  /** Supported billing units */\n  UNITS: [\"token\", \"request\", \"second\", \"minute\", \"byte\", \"kb\", \"mb\"] as const,\n} as const;\n\nexport type UptoUnit = (typeof UPTO_DEFAULTS.UNITS)[number];\n","/**\n * Standardized T402 error codes returned by the facilitator API.\n * Error codes follow the format T402-XYYY where X is the category (1-8)\n * and YYY is the specific error within that category.\n */\n\n// Client Errors (T402-1xxx): Invalid input, malformed requests\nexport const ERR_INVALID_REQUEST = \"T402-1001\" as const;\nexport const ERR_MISSING_PAYLOAD = \"T402-1002\" as const;\nexport const ERR_MISSING_REQUIREMENTS = \"T402-1003\" as const;\nexport const ERR_INVALID_PAYLOAD = \"T402-1004\" as const;\nexport const ERR_INVALID_REQUIREMENTS = \"T402-1005\" as const;\nexport const ERR_INVALID_SIGNATURE = \"T402-1006\" as const;\nexport const ERR_INVALID_NETWORK = \"T402-1007\" as const;\nexport const ERR_INVALID_SCHEME = \"T402-1008\" as const;\nexport const ERR_INVALID_AMOUNT = \"T402-1009\" as const;\nexport const ERR_INVALID_ADDRESS = \"T402-1010\" as const;\nexport const ERR_EXPIRED_PAYMENT = \"T402-1011\" as const;\nexport const ERR_INVALID_NONCE = \"T402-1012\" as const;\nexport const ERR_INSUFFICIENT_AMOUNT = \"T402-1013\" as const;\nexport const ERR_INVALID_IDEMPOTENCY_KEY = \"T402-1014\" as const;\nexport const ERR_SIGNATURE_EXPIRED = \"T402-1015\" as const;\n\n// Server Errors (T402-2xxx): Internal failures, dependency issues\nexport const ERR_INTERNAL = \"T402-2001\" as const;\nexport const ERR_DATABASE_UNAVAILABLE = \"T402-2002\" as const;\nexport const ERR_CACHE_UNAVAILABLE = \"T402-2003\" as const;\nexport const ERR_RPC_UNAVAILABLE = \"T402-2004\" as const;\nexport const ERR_RATE_LIMITED = \"T402-2005\" as const;\nexport const ERR_SERVICE_UNAVAILABLE = \"T402-2006\" as const;\n\n// Facilitator Errors (T402-3xxx): Verification and settlement failures\nexport const ERR_VERIFICATION_FAILED = \"T402-3001\" as const;\nexport const ERR_SETTLEMENT_FAILED = \"T402-3002\" as const;\nexport const ERR_INSUFFICIENT_BALANCE = \"T402-3003\" as const;\nexport const ERR_ALLOWANCE_INSUFFICIENT = \"T402-3004\" as const;\nexport const ERR_PAYMENT_MISMATCH = \"T402-3005\" as const;\nexport const ERR_DUPLICATE_PAYMENT = \"T402-3006\" as const;\nexport const ERR_SETTLEMENT_PENDING = \"T402-3007\" as const;\nexport const ERR_SETTLEMENT_TIMEOUT = \"T402-3008\" as const;\nexport const ERR_NONCE_REPLAY = \"T402-3009\" as const;\nexport const ERR_IDEMPOTENCY_CONFLICT = \"T402-3010\" as const;\nexport const ERR_IDEMPOTENCY_UNAVAILABLE = \"T402-3011\" as const;\nexport const ERR_PREVIOUS_REQUEST_FAILED = \"T402-3012\" as const;\nexport const ERR_REQUEST_IN_PROGRESS = \"T402-3013\" as const;\n\n// Chain-Specific Errors (T402-4xxx): Network and transaction issues\nexport const ERR_CHAIN_UNAVAILABLE = \"T402-4001\" as const;\nexport const ERR_TRANSACTION_FAILED = \"T402-4002\" as const;\nexport const ERR_TRANSACTION_REVERTED = \"T402-4003\" as const;\nexport const ERR_GAS_ESTIMATION_FAILED = \"T402-4004\" as const;\nexport const ERR_NONCE_CONFLICT = \"T402-4005\" as const;\nexport const ERR_CHAIN_CONGESTED = \"T402-4006\" as const;\nexport const ERR_CONTRACT_ERROR = \"T402-4007\" as const;\n\n// Bridge Errors (T402-5xxx): Cross-chain operation failures\nexport const ERR_BRIDGE_UNAVAILABLE = \"T402-5001\" as const;\nexport const ERR_BRIDGE_QUOTE_FAILED = \"T402-5002\" as const;\nexport const ERR_BRIDGE_TRANSFER_FAILED = \"T402-5003\" as const;\nexport const ERR_BRIDGE_TIMEOUT = \"T402-5004\" as const;\nexport const ERR_UNSUPPORTED_ROUTE = \"T402-5005\" as const;\n\n// Streaming Errors (T402-6xxx): Payment stream issues\nexport const ERR_STREAM_NOT_FOUND = \"T402-6001\" as const;\nexport const ERR_STREAM_ALREADY_CLOSED = \"T402-6002\" as const;\nexport const ERR_STREAM_ALREADY_PAUSED = \"T402-6003\" as const;\nexport const ERR_STREAM_NOT_PAUSED = \"T402-6004\" as const;\nexport const ERR_STREAM_AMOUNT_EXCEEDED = \"T402-6005\" as const;\nexport const ERR_STREAM_EXPIRED = \"T402-6006\" as const;\nexport const ERR_STREAM_INVALID_STATE = \"T402-6007\" as const;\nexport const ERR_STREAM_RATE_LIMITED = \"T402-6008\" as const;\n\n// Intent Errors (T402-7xxx): Payment intent issues\nexport const ERR_INTENT_NOT_FOUND = \"T402-7001\" as const;\nexport const ERR_INTENT_ALREADY_EXECUTED = \"T402-7002\" as const;\nexport const ERR_INTENT_CANCELLED = \"T402-7003\" as const;\nexport const ERR_INTENT_EXPIRED = \"T402-7004\" as const;\nexport const ERR_NO_ROUTES_AVAILABLE = \"T402-7005\" as const;\nexport const ERR_ROUTE_EXPIRED = \"T402-7006\" as const;\nexport const ERR_ROUTE_NOT_SELECTED = \"T402-7007\" as const;\nexport const ERR_INTENT_INVALID_STATE = \"T402-7008\" as const;\n\n// Discovery Errors (T402-8xxx): Resource marketplace issues\nexport const ERR_RESOURCE_NOT_FOUND = \"T402-8001\" as const;\nexport const ERR_RESOURCE_ALREADY_EXISTS = \"T402-8002\" as const;\nexport const ERR_INVALID_PARAMETERS = \"T402-8003\" as const;\nexport const ERR_NOT_AUTHORIZED = \"T402-8004\" as const;\n\n/** Union type of all T402 error codes */\nexport type ErrorCode =\n  | typeof ERR_INVALID_REQUEST\n  | typeof ERR_MISSING_PAYLOAD\n  | typeof ERR_MISSING_REQUIREMENTS\n  | typeof ERR_INVALID_PAYLOAD\n  | typeof ERR_INVALID_REQUIREMENTS\n  | typeof ERR_INVALID_SIGNATURE\n  | typeof ERR_INVALID_NETWORK\n  | typeof ERR_INVALID_SCHEME\n  | typeof ERR_INVALID_AMOUNT\n  | typeof ERR_INVALID_ADDRESS\n  | typeof ERR_EXPIRED_PAYMENT\n  | typeof ERR_INVALID_NONCE\n  | typeof ERR_INSUFFICIENT_AMOUNT\n  | typeof ERR_INVALID_IDEMPOTENCY_KEY\n  | typeof ERR_SIGNATURE_EXPIRED\n  | typeof ERR_INTERNAL\n  | typeof ERR_DATABASE_UNAVAILABLE\n  | typeof ERR_CACHE_UNAVAILABLE\n  | typeof ERR_RPC_UNAVAILABLE\n  | typeof ERR_RATE_LIMITED\n  | typeof ERR_SERVICE_UNAVAILABLE\n  | typeof ERR_VERIFICATION_FAILED\n  | typeof ERR_SETTLEMENT_FAILED\n  | typeof ERR_INSUFFICIENT_BALANCE\n  | typeof ERR_ALLOWANCE_INSUFFICIENT\n  | typeof ERR_PAYMENT_MISMATCH\n  | typeof ERR_DUPLICATE_PAYMENT\n  | typeof ERR_SETTLEMENT_PENDING\n  | typeof ERR_SETTLEMENT_TIMEOUT\n  | typeof ERR_NONCE_REPLAY\n  | typeof ERR_IDEMPOTENCY_CONFLICT\n  | typeof ERR_IDEMPOTENCY_UNAVAILABLE\n  | typeof ERR_PREVIOUS_REQUEST_FAILED\n  | typeof ERR_REQUEST_IN_PROGRESS\n  | typeof ERR_CHAIN_UNAVAILABLE\n  | typeof ERR_TRANSACTION_FAILED\n  | typeof ERR_TRANSACTION_REVERTED\n  | typeof ERR_GAS_ESTIMATION_FAILED\n  | typeof ERR_NONCE_CONFLICT\n  | typeof ERR_CHAIN_CONGESTED\n  | typeof ERR_CONTRACT_ERROR\n  | typeof ERR_BRIDGE_UNAVAILABLE\n  | typeof ERR_BRIDGE_QUOTE_FAILED\n  | typeof ERR_BRIDGE_TRANSFER_FAILED\n  | typeof ERR_BRIDGE_TIMEOUT\n  | typeof ERR_UNSUPPORTED_ROUTE\n  | typeof ERR_STREAM_NOT_FOUND\n  | typeof ERR_STREAM_ALREADY_CLOSED\n  | typeof ERR_STREAM_ALREADY_PAUSED\n  | typeof ERR_STREAM_NOT_PAUSED\n  | typeof ERR_STREAM_AMOUNT_EXCEEDED\n  | typeof ERR_STREAM_EXPIRED\n  | typeof ERR_STREAM_INVALID_STATE\n  | typeof ERR_STREAM_RATE_LIMITED\n  | typeof ERR_INTENT_NOT_FOUND\n  | typeof ERR_INTENT_ALREADY_EXECUTED\n  | typeof ERR_INTENT_CANCELLED\n  | typeof ERR_INTENT_EXPIRED\n  | typeof ERR_NO_ROUTES_AVAILABLE\n  | typeof ERR_ROUTE_EXPIRED\n  | typeof ERR_ROUTE_NOT_SELECTED\n  | typeof ERR_INTENT_INVALID_STATE\n  | typeof ERR_RESOURCE_NOT_FOUND\n  | typeof ERR_RESOURCE_ALREADY_EXISTS\n  | typeof ERR_INVALID_PARAMETERS\n  | typeof ERR_NOT_AUTHORIZED;\n\n/** Structured error response from the facilitator API */\nexport interface APIError {\n  code: ErrorCode;\n  message: string;\n  details?: string;\n  retry?: boolean;\n}\n\n/**\n * Returns the HTTP status code for a given error code\n *\n * @param code - The T402 error code\n * @returns The corresponding HTTP status code\n */\nexport function httpStatusForCode(code: ErrorCode): number {\n  const category = code.charAt(5);\n  switch (category) {\n    case \"1\":\n      return 400;\n    case \"2\":\n      if (code === ERR_RATE_LIMITED) return 429;\n      return 500;\n    case \"3\":\n      if (code === ERR_VERIFICATION_FAILED || code === ERR_PAYMENT_MISMATCH) return 422;\n      return 500;\n    case \"4\":\n      return 502;\n    case \"5\":\n      return 502;\n    case \"6\":\n      if (code === ERR_STREAM_NOT_FOUND) return 404;\n      return 400;\n    case \"7\":\n      if (code === ERR_INTENT_NOT_FOUND) return 404;\n      return 400;\n    case \"8\":\n      if (code === ERR_RESOURCE_NOT_FOUND) return 404;\n      if (code === ERR_RESOURCE_ALREADY_EXISTS) return 409;\n      if (code === ERR_NOT_AUTHORIZED) return 403;\n      return 400;\n    default:\n      return 500;\n  }\n}\n\n/**\n * Returns true if the error code is a client error (T402-1xxx)\n *\n * @param code - The T402 error code\n * @returns Whether the error is a client error\n */\nexport function isClientError(code: ErrorCode): boolean {\n  return code.charAt(5) === \"1\";\n}\n\n/**\n * Returns true if the error code is a server error (T402-2xxx)\n *\n * @param code - The T402 error code\n * @returns Whether the error is a server error\n */\nexport function isServerError(code: ErrorCode): boolean {\n  return code.charAt(5) === \"2\";\n}\n\n/**\n * Returns true if the error code is a facilitator error (T402-3xxx)\n *\n * @param code - The T402 error code\n * @returns Whether the error is a facilitator error\n */\nexport function isFacilitatorError(code: ErrorCode): boolean {\n  return code.charAt(5) === \"3\";\n}\n\n/**\n * Returns true if the error code is a chain error (T402-4xxx)\n *\n * @param code - The T402 error code\n * @returns Whether the error is a chain error\n */\nexport function isChainError(code: ErrorCode): boolean {\n  return code.charAt(5) === \"4\";\n}\n\n/**\n * Returns true if the error code is a bridge error (T402-5xxx)\n *\n * @param code - The T402 error code\n * @returns Whether the error is a bridge error\n */\nexport function isBridgeError(code: ErrorCode): boolean {\n  return code.charAt(5) === \"5\";\n}\n"],"mappings":"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","names":[]}

package/dist/esm/types/v1/index.d.mts

@@ -1 +1,2 @@
-export { k as PaymentPayloadV1, j as PaymentRequiredV1, i as PaymentRequirementsV1, m as SettleRequestV1, n as SettleResponseV1, o as SupportedResponseV1, l as VerifyRequestV1 } from '../../mechanisms-B-vz5yOj.mjs';
+export { i as PaymentPayloadV1, j as PaymentRequiredV1, k as PaymentRequirementsV1, l as SettleRequestV1, m as SettleResponseV1, n as SupportedResponseV1, o as VerifyRequestV1 } from '../../mechanisms-dYCiYgko.mjs';
+import 'zod';

package/dist/esm/utils/index.d.mts

@@ -1,5 +1,32 @@
-import { N as Network } from '../mechanisms-B-vz5yOj.mjs';
+import { N as Network } from '../mechanisms-dYCiYgko.mjs';
+import 'zod';
 
+/**
+ * Generate a cryptographically secure random integer in range [0, max)
+ *
+ * Uses rejection sampling to ensure uniform distribution.
+ *
+ * @param max - Exclusive upper bound (must be > 0 and <= 2^32)
+ * @returns Random integer in [0, max)
+ * @throws Error if max is invalid or crypto unavailable
+ */
+declare function cryptoRandomInt(max: number): number;
+/**
+ * Generate a cryptographically secure random BigInt
+ *
+ * @param bits - Number of bits (default 64, max 256)
+ * @returns Random BigInt with specified number of bits
+ * @throws Error if bits is invalid or crypto unavailable
+ */
+declare function cryptoRandomBigInt(bits?: number): bigint;
+/**
+ * Generate a cryptographically secure random hex string
+ *
+ * @param bytes - Number of random bytes (default 16)
+ * @returns Hex-encoded random string
+ * @throws Error if bytes is invalid or crypto unavailable
+ */
+declare function cryptoRandomHex(bytes?: number): string;
 /**
  * Scheme data structure for facilitator storage
  */
@@ -45,4 +72,4 @@ declare function safeBase64Decode(data: string): string;
  */
 declare function deepEqual(obj1: unknown, obj2: unknown): boolean;
 
-export { Base64EncodedRegex, type SchemeData, deepEqual, findByNetworkAndScheme, findFacilitatorBySchemeAndNetwork, findSchemesByNetwork, safeBase64Decode, safeBase64Encode };
+export { Base64EncodedRegex, type SchemeData, cryptoRandomBigInt, cryptoRandomHex, cryptoRandomInt, deepEqual, findByNetworkAndScheme, findFacilitatorBySchemeAndNetwork, findSchemesByNetwork, safeBase64Decode, safeBase64Encode };

package/dist/esm/utils/index.mjs

@@ -1,15 +1,21 @@
 import {
   Base64EncodedRegex,
+  cryptoRandomBigInt,
+  cryptoRandomHex,
+  cryptoRandomInt,
   deepEqual,
   findByNetworkAndScheme,
   findFacilitatorBySchemeAndNetwork,
   findSchemesByNetwork,
   safeBase64Decode,
   safeBase64Encode
-} from "../chunk-3IUBYRYG.mjs";
+} from "../chunk-LJ4M5Z5U.mjs";
 import "../chunk-4W2Y3RJM.mjs";
 export {
   Base64EncodedRegex,
+  cryptoRandomBigInt,
+  cryptoRandomHex,
+  cryptoRandomInt,
   deepEqual,
   findByNetworkAndScheme,
   findFacilitatorBySchemeAndNetwork,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t402/core",
-  "version": "2.3.1",
+  "version": "2.5.0",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
   "types": "./dist/cjs/index.d.ts",
@@ -10,21 +10,21 @@
   "repository": "https://github.com/t402-io/t402",
   "description": "t402 Payment Protocol",
   "devDependencies": {
-    "@eslint/js": "^9.24.0",
-    "@types/node": "^22.13.4",
-    "@typescript-eslint/eslint-plugin": "^8.29.1",
-    "@typescript-eslint/parser": "^8.29.1",
+    "@eslint/js": "^9.39.2",
+    "@types/node": "^25.2.2",
+    "@typescript-eslint/eslint-plugin": "^8.55.0",
+    "@typescript-eslint/parser": "^8.55.0",
     "eslint": "^9.24.0",
     "eslint-plugin-import": "^2.31.0",
-    "eslint-plugin-jsdoc": "^50.6.9",
-    "eslint-plugin-prettier": "^5.2.6",
+    "eslint-plugin-jsdoc": "^62.5.4",
+    "eslint-plugin-prettier": "^5.5.5",
     "glob": "^13.0.0",
-    "prettier": "3.5.2",
-    "tsup": "^8.4.0",
+    "prettier": "3.8.1",
+    "tsup": "^8.5.1",
     "tsx": "^4.21.0",
-    "typescript": "^5.7.3",
+    "typescript": "^5.9.3",
     "vite": "^7.3.1",
-    "vite-tsconfig-paths": "^5.1.4",
+    "vite-tsconfig-paths": "^6.1.0",
     "vitest": "^3.2.4"
   },
   "dependencies": {

package/dist/cjs/mechanisms-B-vz5yOj.d.ts

@@ -1,443 +0,0 @@
-type PaymentRequirementsV1 = {
-    scheme: string;
-    network: Network;
-    maxAmountRequired: string;
-    resource: string;
-    description: string;
-    mimeType: string;
-    outputSchema: Record<string, unknown>;
-    payTo: string;
-    maxTimeoutSeconds: number;
-    asset: string;
-    extra: Record<string, unknown>;
-};
-type PaymentRequiredV1 = {
-    t402Version: 1;
-    error?: string;
-    accepts: PaymentRequirementsV1[];
-};
-type PaymentPayloadV1 = {
-    t402Version: 1;
-    scheme: string;
-    network: Network;
-    payload: Record<string, unknown>;
-};
-type VerifyRequestV1 = {
-    paymentPayload: PaymentPayloadV1;
-    paymentRequirements: PaymentRequirementsV1;
-};
-type SettleRequestV1 = {
-    paymentPayload: PaymentPayloadV1;
-    paymentRequirements: PaymentRequirementsV1;
-};
-type SettleResponseV1 = {
-    success: boolean;
-    errorReason?: string;
-    payer?: string;
-    transaction: string;
-    network: Network;
-};
-type SupportedResponseV1 = {
-    kinds: {
-        t402Version: number;
-        scheme: string;
-        network: Network;
-        extra?: Record<string, unknown>;
-    }[];
-};
-
-interface ResourceServerExtension {
-    key: string;
-    enrichDeclaration?: (declaration: unknown, transportContext: unknown) => unknown;
-}
-
-/**
- * Up-To Scheme Types
- *
- * The `upto` scheme authorizes transfer of up to a maximum amount,
- * enabling usage-based billing where the final settlement amount
- * is determined by actual usage.
- *
- * @example
- * ```typescript
- * // Client authorizes up to $1.00
- * const requirements: UptoPaymentRequirements = {
- *   scheme: 'upto',
- *   network: 'eip155:8453',
- *   maxAmount: '1000000',  // $1.00 in USDC
- *   minAmount: '10000',    // $0.01 minimum
- *   asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
- *   payTo: '0x...',
- *   maxTimeoutSeconds: 300,
- *   extra: {
- *     unit: 'token',
- *     unitPrice: '100',
- *   },
- * };
- *
- * // Server settles for actual usage ($0.15)
- * const settlement: UptoSettlement = {
- *   settleAmount: '150000',
- *   usageDetails: {
- *     tokensGenerated: 1500,
- *     unitPrice: '100',
- *   },
- * };
- * ```
- */
-
-/**
- * Extended payment requirements for the upto scheme.
- */
-interface UptoPaymentRequirements extends Omit<PaymentRequirements, "scheme" | "amount"> {
-    /** Scheme identifier - always 'upto' */
-    scheme: "upto";
-    /** Network identifier (CAIP-2 format) */
-    network: Network;
-    /** Maximum amount the client authorizes (in smallest denomination) */
-    maxAmount: string;
-    /** Minimum settlement amount (prevents dust payments) */
-    minAmount?: string;
-    /** Asset contract address or identifier */
-    asset: string;
-    /** Recipient address */
-    payTo: string;
-    /** Maximum time in seconds before payment expires */
-    maxTimeoutSeconds: number;
-    /** Additional scheme-specific data */
-    extra: UptoExtra;
-}
-/**
- * Extra fields specific to the upto scheme.
- */
-interface UptoExtra extends Record<string, unknown> {
-    /** Billing unit (e.g., 'token', 'request', 'second', 'byte') */
-    unit?: string;
-    /** Price per unit in smallest denomination */
-    unitPrice?: string;
-    /** EIP-712 domain name (for EVM) */
-    name?: string;
-    /** EIP-712 domain version (for EVM) */
-    version?: string;
-    /** Router contract address (for EVM) */
-    routerAddress?: string;
-}
-/**
- * Base payload structure for upto scheme.
- */
-interface UptoPayloadBase {
-    /** Unique nonce to prevent replay attacks */
-    nonce: string;
-}
-/**
- * EVM-specific upto payload using EIP-2612 Permit.
- */
-interface UptoEvmPayload extends UptoPayloadBase {
-    /** EIP-2612 permit signature components */
-    signature: {
-        v: number;
-        r: `0x${string}`;
-        s: `0x${string}`;
-    };
-    /** Permit authorization parameters */
-    authorization: {
-        /** Token owner address */
-        owner: `0x${string}`;
-        /** Spender address (router contract) */
-        spender: `0x${string}`;
-        /** Maximum authorized value */
-        value: string;
-        /** Permit deadline (unix timestamp) */
-        deadline: string;
-        /** Permit nonce (from token contract) */
-        nonce: number;
-    };
-}
-/**
- * Alternative EVM payload with combined signature.
- */
-interface UptoEvmPayloadCompact extends UptoPayloadBase {
-    /** Combined EIP-2612 permit signature */
-    signature: `0x${string}`;
-    /** Permit authorization parameters */
-    authorization: {
-        owner: `0x${string}`;
-        spender: `0x${string}`;
-        value: string;
-        deadline: string;
-        nonce: number;
-    };
-}
-/**
- * Settlement request for upto scheme.
- */
-interface UptoSettlement {
-    /** Actual amount to settle (must be <= maxAmount) */
-    settleAmount: string;
-    /** Optional usage details for auditing */
-    usageDetails?: UptoUsageDetails;
-}
-/**
- * Usage details for settlement auditing.
- */
-interface UptoUsageDetails {
-    /** Number of units consumed */
-    unitsConsumed?: number;
-    /** Price per unit used */
-    unitPrice?: string;
-    /** Type of unit */
-    unitType?: string;
-    /** Start timestamp of usage period */
-    startTime?: number;
-    /** End timestamp of usage period */
-    endTime?: number;
-    /** Additional metadata */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Settlement response for upto scheme.
- */
-interface UptoSettlementResponse {
-    /** Whether settlement was successful */
-    success: boolean;
-    /** Transaction hash (if on-chain) */
-    transactionHash?: string;
-    /** Actual amount settled */
-    settledAmount: string;
-    /** Maximum amount that was authorized */
-    maxAmount: string;
-    /** Block number (if on-chain) */
-    blockNumber?: number;
-    /** Gas used (if on-chain) */
-    gasUsed?: string;
-    /** Error message if failed */
-    error?: string;
-}
-/**
- * Validation result for upto payment.
- */
-interface UptoValidationResult {
-    /** Whether the payment is valid */
-    isValid: boolean;
-    /** Reason if invalid */
-    invalidReason?: string;
-    /** Validated maximum amount */
-    validatedMaxAmount?: string;
-    /** Payer address */
-    payer?: string;
-    /** Expiration timestamp */
-    expiresAt?: number;
-}
-/**
- * Type guard for UptoPaymentRequirements.
- *
- * @param requirements - The value to check
- * @returns True if the value is UptoPaymentRequirements
- */
-declare function isUptoPaymentRequirements(requirements: unknown): requirements is UptoPaymentRequirements;
-/**
- * Type guard for UptoEvmPayload.
- *
- * @param payload - The value to check
- * @returns True if the value is UptoEvmPayload
- */
-declare function isUptoEvmPayload(payload: unknown): payload is UptoEvmPayload;
-/**
- * Constants for upto scheme.
- */
-declare const UPTO_SCHEME: "upto";
-declare const UPTO_DEFAULTS: {
-    /** Default minimum settlement amount (prevents dust) */
-    readonly MIN_AMOUNT: "1000";
-    /** Default maximum timeout in seconds (5 minutes) */
-    readonly MAX_TIMEOUT_SECONDS: 300;
-    /** Supported billing units */
-    readonly UNITS: readonly ["token", "request", "second", "minute", "byte", "kb", "mb"];
-};
-type UptoUnit = (typeof UPTO_DEFAULTS.UNITS)[number];
-
-type Network = `${string}:${string}`;
-type Money = string | number;
-type AssetAmount = {
-    asset: string;
-    amount: string;
-    extra?: Record<string, unknown>;
-};
-type Price = Money | AssetAmount;
-
-interface ResourceInfo {
-    url: string;
-    description?: string;
-    mimeType?: string;
-}
-type PaymentRequirements = {
-    scheme: string;
-    network: Network;
-    asset: string;
-    amount: string;
-    payTo: string;
-    maxTimeoutSeconds: number;
-    extra: Record<string, unknown>;
-};
-type PaymentRequired = {
-    t402Version: number;
-    error?: string;
-    resource: ResourceInfo;
-    accepts: PaymentRequirements[];
-    extensions?: Record<string, unknown>;
-};
-type PaymentPayload = {
-    t402Version: number;
-    resource?: ResourceInfo;
-    accepted: PaymentRequirements;
-    payload: Record<string, unknown>;
-    extensions?: Record<string, unknown>;
-};
-
-type VerifyRequest = {
-    paymentPayload: PaymentPayload;
-    paymentRequirements: PaymentRequirements;
-};
-type VerifyResponse = {
-    isValid: boolean;
-    invalidReason?: string;
-    payer?: string;
-};
-type SettleRequest = {
-    paymentPayload: PaymentPayload;
-    paymentRequirements: PaymentRequirements;
-};
-type SettleResponse = {
-    success: boolean;
-    errorReason?: string;
-    payer?: string;
-    transaction: string;
-    network: Network;
-};
-type SupportedKind = {
-    t402Version: number;
-    scheme: string;
-    network: Network;
-    extra?: Record<string, unknown>;
-};
-type SupportedResponse = {
-    kinds: SupportedKind[];
-    extensions: string[];
-    signers: Record<string, string[]>;
-};
-
-/**
- * Money parser function that converts a numeric amount to an AssetAmount
- * Receives the amount as a decimal number (e.g., 1.50 for $1.50)
- * Returns null to indicate "cannot handle this amount", causing fallback to next parser
- * Always returns a Promise for consistency - use async/await
- *
- * @param amount - The decimal amount (e.g., 1.50)
- * @param network - The network identifier for context
- * @returns AssetAmount or null to try next parser
- */
-type MoneyParser = (amount: number, network: Network) => Promise<AssetAmount | null>;
-interface SchemeNetworkClient {
-    readonly scheme: string;
-    createPaymentPayload(t402Version: number, paymentRequirements: PaymentRequirements): Promise<Pick<PaymentPayload, "t402Version" | "payload">>;
-}
-interface SchemeNetworkFacilitator {
-    readonly scheme: string;
-    /**
-     * CAIP family pattern that this facilitator supports.
-     * Used to group signers by blockchain family in the supported response.
-     *
-     * @example
-     * // EVM facilitators
-     * readonly caipFamily = "eip155:*";
-     *
-     * @example
-     * // SVM facilitators
-     * readonly caipFamily = "solana:*";
-     */
-    readonly caipFamily: string;
-    /**
-     * Get mechanism-specific extra data needed for the supported kinds endpoint.
-     * This method is called when building the facilitator's supported response.
-     *
-     * @param network - The network identifier for context
-     * @returns Extra data object or undefined if no extra data is needed
-     *
-     * @example
-     * // EVM schemes return undefined (no extra data needed)
-     * getExtra(network: Network): undefined {
-     *   return undefined;
-     * }
-     *
-     * @example
-     * // SVM schemes return feePayer address
-     * getExtra(network: Network): Record<string, unknown> | undefined {
-     *   return { feePayer: this.signer.address };
-     * }
-     */
-    getExtra(network: Network): Record<string, unknown> | undefined;
-    /**
-     * Get signer addresses used by this facilitator for a given network.
-     * These are included in the supported response to help clients understand
-     * which addresses might sign/pay for transactions.
-     *
-     * Supports multiple addresses for load balancing, key rotation, and high availability.
-     *
-     * @param network - The network identifier
-     * @returns Array of signer addresses (wallet addresses, fee payer addresses, etc.)
-     *
-     * @example
-     * // EVM facilitator
-     * getSigners(network: string): string[] {
-     *   return [...this.signer.getAddresses()];
-     * }
-     *
-     * @example
-     * // SVM facilitator
-     * getSigners(network: string): string[] {
-     *   return [...this.signer.getAddresses()];
-     * }
-     */
-    getSigners(network: string): string[];
-    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
-    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
-}
-interface SchemeNetworkServer {
-    readonly scheme: string;
-    /**
-     * Convert a user-friendly price to the scheme's specific amount and asset format
-     * Always returns a Promise for consistency
-     *
-     * @param price - User-friendly price (e.g., "$0.10", "0.10", { amount: "100000", asset: "USDC" })
-     * @param network - The network identifier for context
-     * @returns Promise that resolves to the converted amount, asset identifier, and any extra metadata
-     *
-     * @example
-     * // For EVM networks with USDC:
-     * await parsePrice("$0.10", "eip155:8453") => { amount: "100000", asset: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" }
-     *
-     * // For custom schemes:
-     * await parsePrice("10 points", "custom:network") => { amount: "10", asset: "points" }
-     */
-    parsePrice(price: Price, network: Network): Promise<AssetAmount>;
-    /**
-     * Build payment requirements for this scheme/network combination
-     *
-     * @param paymentRequirements - Base payment requirements with amount/asset already set
-     * @param supportedKind - The supported kind from facilitator's /supported endpoint
-     * @param supportedKind.t402Version - The t402 version
-     * @param supportedKind.scheme - The payment scheme
-     * @param supportedKind.network - The network identifier
-     * @param supportedKind.extra - Optional extra metadata
-     * @param facilitatorExtensions - Extensions supported by the facilitator
-     * @returns Enhanced payment requirements ready to be sent to clients
-     */
-    enhancePaymentRequirements(paymentRequirements: PaymentRequirements, supportedKind: {
-        t402Version: number;
-        scheme: string;
-        network: Network;
-        extra?: Record<string, unknown>;
-    }, facilitatorExtensions: string[]): Promise<PaymentRequirements>;
-}
-
-export { type AssetAmount as A, type UptoUnit as B, isUptoPaymentRequirements as C, isUptoEvmPayload as D, UPTO_SCHEME as E, UPTO_DEFAULTS as F, type Money as M, type Network as N, type PaymentRequirements as P, type ResourceServerExtension as R, type SettleResponse as S, type UptoPaymentRequirements as U, type VerifyResponse as V, type PaymentPayload as a, type SchemeNetworkFacilitator as b, type PaymentRequired as c, type SchemeNetworkClient as d, type SupportedResponse as e, type SchemeNetworkServer as f, type SupportedKind as g, type Price as h, type PaymentRequirementsV1 as i, type PaymentRequiredV1 as j, type PaymentPayloadV1 as k, type VerifyRequestV1 as l, type SettleRequestV1 as m, type SettleResponseV1 as n, type SupportedResponseV1 as o, type VerifyRequest as p, type SettleRequest as q, type MoneyParser as r, type UptoExtra as s, type UptoPayloadBase as t, type UptoEvmPayload as u, type UptoEvmPayloadCompact as v, type UptoSettlement as w, type UptoUsageDetails as x, type UptoSettlementResponse as y, type UptoValidationResult as z };

package/dist/esm/chunk-3IUBYRYG.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/utils/index.ts"],"sourcesContent":["import { Network } from \"../types\";\n\n/**\n * Scheme data structure for facilitator storage\n */\nexport interface SchemeData<T> {\n  facilitator: T;\n  networks: Set<Network>;\n  pattern: Network;\n}\n\nexport const findSchemesByNetwork = <T>(\n  map: Map<string, Map<string, T>>,\n  network: Network,\n): Map<string, T> | undefined => {\n  // Direct match first\n  let implementationsByScheme = map.get(network);\n\n  if (!implementationsByScheme) {\n    // Try pattern matching for registered network patterns\n    for (const [registeredNetworkPattern, implementations] of map.entries()) {\n      // Convert the registered network pattern to a regex\n      // e.g., \"eip155:*\" becomes /^eip155:.*$/\n      const pattern = registeredNetworkPattern\n        .replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\") // Escape special regex chars except *\n        .replace(/\\\\\\*/g, \".*\"); // Replace escaped * with .*\n\n      const regex = new RegExp(`^${pattern}$`);\n\n      if (regex.test(network)) {\n        implementationsByScheme = implementations;\n        break;\n      }\n    }\n  }\n\n  return implementationsByScheme;\n};\n\nexport const findByNetworkAndScheme = <T>(\n  map: Map<string, Map<string, T>>,\n  scheme: string,\n  network: Network,\n): T | undefined => {\n  return findSchemesByNetwork(map, network)?.get(scheme);\n};\n\n/**\n * Finds a facilitator by scheme and network using pattern matching.\n * Works with new SchemeData storage structure.\n *\n * @param schemeMap - Map of scheme names to SchemeData\n * @param scheme - The scheme to find\n * @param network - The network to match against\n * @returns The facilitator if found, undefined otherwise\n */\nexport const findFacilitatorBySchemeAndNetwork = <T>(\n  schemeMap: Map<string, SchemeData<T>>,\n  scheme: string,\n  network: Network,\n): T | undefined => {\n  const schemeData = schemeMap.get(scheme);\n  if (!schemeData) return undefined;\n\n  // Check if network is in the stored networks set\n  if (schemeData.networks.has(network)) {\n    return schemeData.facilitator;\n  }\n\n  // Try pattern matching\n  const patternRegex = new RegExp(\"^\" + schemeData.pattern.replace(\"*\", \".*\") + \"$\");\n  if (patternRegex.test(network)) {\n    return schemeData.facilitator;\n  }\n\n  return undefined;\n};\n\nexport const Base64EncodedRegex = /^[A-Za-z0-9+/]*={0,2}$/;\n\n/**\n * Encodes a string to base64 format\n *\n * @param data - The string to be encoded to base64\n * @returns The base64 encoded string\n */\nexport function safeBase64Encode(data: string): string {\n  if (typeof globalThis !== \"undefined\" && typeof globalThis.btoa === \"function\") {\n    return globalThis.btoa(data);\n  }\n  return Buffer.from(data).toString(\"base64\");\n}\n\n/**\n * Decodes a base64 string back to its original format\n *\n * @param data - The base64 encoded string to be decoded\n * @returns The decoded string in UTF-8 format\n */\nexport function safeBase64Decode(data: string): string {\n  if (typeof globalThis !== \"undefined\" && typeof globalThis.atob === \"function\") {\n    return globalThis.atob(data);\n  }\n  return Buffer.from(data, \"base64\").toString(\"utf-8\");\n}\n\n/**\n * Deep equality comparison for payment requirements\n * Uses a normalized JSON.stringify for consistent comparison\n *\n * @param obj1 - First object to compare\n * @param obj2 - Second object to compare\n * @returns True if objects are deeply equal\n */\nexport function deepEqual(obj1: unknown, obj2: unknown): boolean {\n  // Normalize and stringify both objects for comparison\n  // This handles nested objects, arrays, and different property orders\n  const normalize = (obj: unknown): string => {\n    // Handle primitives and null/undefined\n    if (obj === null || obj === undefined) return JSON.stringify(obj);\n    if (typeof obj !== \"object\") return JSON.stringify(obj);\n\n    // Handle arrays\n    if (Array.isArray(obj)) {\n      return JSON.stringify(\n        obj.map(item =>\n          typeof item === \"object\" && item !== null ? JSON.parse(normalize(item)) : item,\n        ),\n      );\n    }\n\n    // Handle objects - sort keys and recursively normalize values\n    const sorted: Record<string, unknown> = {};\n    Object.keys(obj as Record<string, unknown>)\n      .sort()\n      .forEach(key => {\n        const value = (obj as Record<string, unknown>)[key];\n        sorted[key] =\n          typeof value === \"object\" && value !== null ? JSON.parse(normalize(value)) : value;\n      });\n    return JSON.stringify(sorted);\n  };\n\n  try {\n    return normalize(obj1) === normalize(obj2);\n  } catch {\n    // Fallback to simple comparison if normalization fails\n    return JSON.stringify(obj1) === JSON.stringify(obj2);\n  }\n}\n"],"mappings":";AAWO,IAAM,uBAAuB,CAClC,KACA,YAC+B;AAE/B,MAAI,0BAA0B,IAAI,IAAI,OAAO;AAE7C,MAAI,CAAC,yBAAyB;AAE5B,eAAW,CAAC,0BAA0B,eAAe,KAAK,IAAI,QAAQ,GAAG;AAGvE,YAAM,UAAU,yBACb,QAAQ,uBAAuB,MAAM,EACrC,QAAQ,SAAS,IAAI;AAExB,YAAM,QAAQ,IAAI,OAAO,IAAI,OAAO,GAAG;AAEvC,UAAI,MAAM,KAAK,OAAO,GAAG;AACvB,kCAA0B;AAC1B;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAEO,IAAM,yBAAyB,CACpC,KACA,QACA,YACkB;AAClB,SAAO,qBAAqB,KAAK,OAAO,GAAG,IAAI,MAAM;AACvD;AAWO,IAAM,oCAAoC,CAC/C,WACA,QACA,YACkB;AAClB,QAAM,aAAa,UAAU,IAAI,MAAM;AACvC,MAAI,CAAC,WAAY,QAAO;AAGxB,MAAI,WAAW,SAAS,IAAI,OAAO,GAAG;AACpC,WAAO,WAAW;AAAA,EACpB;AAGA,QAAM,eAAe,IAAI,OAAO,MAAM,WAAW,QAAQ,QAAQ,KAAK,IAAI,IAAI,GAAG;AACjF,MAAI,aAAa,KAAK,OAAO,GAAG;AAC9B,WAAO,WAAW;AAAA,EACpB;AAEA,SAAO;AACT;AAEO,IAAM,qBAAqB;AAQ3B,SAAS,iBAAiB,MAAsB;AACrD,MAAI,OAAO,eAAe,eAAe,OAAO,WAAW,SAAS,YAAY;AAC9E,WAAO,WAAW,KAAK,IAAI;AAAA,EAC7B;AACA,SAAO,OAAO,KAAK,IAAI,EAAE,SAAS,QAAQ;AAC5C;AAQO,SAAS,iBAAiB,MAAsB;AACrD,MAAI,OAAO,eAAe,eAAe,OAAO,WAAW,SAAS,YAAY;AAC9E,WAAO,WAAW,KAAK,IAAI;AAAA,EAC7B;AACA,SAAO,OAAO,KAAK,MAAM,QAAQ,EAAE,SAAS,OAAO;AACrD;AAUO,SAAS,UAAU,MAAe,MAAwB;AAG/D,QAAM,YAAY,CAAC,QAAyB;AAE1C,QAAI,QAAQ,QAAQ,QAAQ,OAAW,QAAO,KAAK,UAAU,GAAG;AAChE,QAAI,OAAO,QAAQ,SAAU,QAAO,KAAK,UAAU,GAAG;AAGtD,QAAI,MAAM,QAAQ,GAAG,GAAG;AACtB,aAAO,KAAK;AAAA,QACV,IAAI;AAAA,UAAI,UACN,OAAO,SAAS,YAAY,SAAS,OAAO,KAAK,MAAM,UAAU,IAAI,CAAC,IAAI;AAAA,QAC5E;AAAA,MACF;AAAA,IACF;AAGA,UAAM,SAAkC,CAAC;AACzC,WAAO,KAAK,GAA8B,EACvC,KAAK,EACL,QAAQ,SAAO;AACd,YAAM,QAAS,IAAgC,GAAG;AAClD,aAAO,GAAG,IACR,OAAO,UAAU,YAAY,UAAU,OAAO,KAAK,MAAM,UAAU,KAAK,CAAC,IAAI;AAAA,IACjF,CAAC;AACH,WAAO,KAAK,UAAU,MAAM;AAAA,EAC9B;AAEA,MAAI;AACF,WAAO,UAAU,IAAI,MAAM,UAAU,IAAI;AAAA,EAC3C,QAAQ;AAEN,WAAO,KAAK,UAAU,IAAI,MAAM,KAAK,UAAU,IAAI;AAAA,EACrD;AACF;","names":[]}