@armory-sh/base 0.2.21 → 0.2.22-alpha.3.20

package/dist/encoding/x402.d.ts

@@ -4,7 +4,7 @@
  * Payment payloads are JSON-encoded for transport in HTTP headers.
  * Matches the Coinbase x402 v2 SDK format.
  */
-import type { PaymentPayload, X402Response, PaymentPayloadV2, PaymentRequirements, SettlementResponse } from "../types/x402";
+import type { PaymentPayload, X402Response, PaymentRequirements, SettlementResponse } from "../types/x402";
 /**
  * Safe Base64 encode (URL-safe, no padding)
  */
@@ -16,7 +16,7 @@ export declare function safeBase64Decode(str: string): string;
 /**
  * Encode payment payload to JSON string
  */
-export declare function encodePayment(payload: PaymentPayload | PaymentPayloadV2): string;
+export declare function encodePayment(payload: PaymentPayload): string;
 /**
  * Decode payment payload from JSON string
  */
@@ -56,10 +56,6 @@ export declare function createPaymentRequiredHeaders(requirements: PaymentRequir
  * Create settlement response headers (V2 format)
  */
 export declare function createSettlementHeaders(settlement: SettlementResponse): Record<string, string>;
-/**
- * Type guard for legacy V2 payload (without x402Version)
- */
-export declare function isLegacyV2(payload: unknown): payload is PaymentPayloadV2;
 /**
  * Decode settlement from headers (V2 only)
  */

package/dist/index.d.ts

@@ -1,11 +1,11 @@
-export type { Address as X402Address, Hex, X402Version, Scheme, Network as X402Network, ExactEvmAuthorization, ExactEvmPayload, PaymentPayload as X402PaymentPayload, UnsignedPaymentPayload as X402UnsignedPaymentPayload, PaymentRequirements as X402PaymentRequirements, SettlementResponse as X402SettlementResponse, VerifyResponse, X402Response, PaymentPayloadV2 as X402PayloadV2, LegacyPaymentPayload as X402LegacyPayload, } from "./types/x402";
-export { X402_VERSION, SCHEMES, isPaymentPayload, isExactEvmPayload, legacyToPaymentPayload, } from "./types/x402";
-export { safeBase64Encode, safeBase64Decode, encodePayment, decodePayment, encodeSettlementResponse, decodeSettlementResponse, encodeX402Response, decodeX402Response, detectPaymentVersion, extractPaymentFromHeaders, createPaymentRequiredHeaders, createSettlementHeaders, isLegacyV2, } from "./encoding/x402";
+export type { Address as X402Address, Hex, X402Version, Scheme, Network as X402Network, ExactEvmAuthorization, ExactEvmPayload, PaymentPayload as X402PaymentPayload, UnsignedPaymentPayload as X402UnsignedPaymentPayload, PaymentRequirements as X402PaymentRequirements, SettlementResponse as X402SettlementResponse, VerifyResponse, X402Response, } from "./types/x402";
+export { X402_VERSION, SCHEMES, isPaymentPayload, isExactEvmPayload, } from "./types/x402";
+export { safeBase64Encode, safeBase64Decode, encodePayment, decodePayment, encodeSettlementResponse, decodeSettlementResponse, encodeX402Response, decodeX402Response, detectPaymentVersion, extractPaymentFromHeaders, createPaymentRequiredHeaders, createSettlementHeaders, } from "./encoding/x402";
 export { createNonce, toAtomicUnits, fromAtomicUnits, caip2ToNetwork, networkToCaip2, getCurrentTimestamp, isValidAddress, normalizeAddress, } from "./utils/x402";
 export type { CAIP2Network as CAIP2ChainId, CAIPAssetId, Address, Signature, PayToV2, Extensions, PaymentPayloadV2, PaymentRequirementsV2, SettlementResponseV2, PaymentRequiredV2, ResourceInfo, EIP3009Authorization, SchemePayloadV2, } from "./types/v2";
 export { V2_HEADERS, isCAIP2ChainId, isCAIPAssetId, isAddress, isPaymentRequiredV2, isPaymentPayloadV2, assetIdToAddress, addressToAssetId, parseSignature as parseSignatureV2, combineSignature as combineSignatureV2, } from "./types/v2";
 export type { PaymentPayload, PaymentRequirements, SettlementResponse, PaymentRequired, } from "./types/protocol";
-export { isX402V2Payload, isX402V2Requirements, isX402V2Settlement, isX402V2PaymentRequired, isLegacyV2Payload, isSettlementSuccessful, getTxHash, PAYMENT_SIGNATURE_HEADER, PAYMENT_RESPONSE_HEADER, PAYMENT_REQUIRED_HEADER, } from "./types/protocol";
+export { isX402V2Payload, isX402V2Requirements, isX402V2Settlement, isX402V2PaymentRequired, isSettlementSuccessful, getTxHash, PAYMENT_SIGNATURE_HEADER, PAYMENT_RESPONSE_HEADER, PAYMENT_REQUIRED_HEADER, } from "./types/protocol";
 export type { NetworkConfig, CustomToken } from "./types/networks";
 export { NETWORKS, getNetworkConfig, getNetworkByChainId, getMainnets, getTestnets, registerToken, getCustomToken, getAllCustomTokens, unregisterToken, isCustomToken, } from "./types/networks";
 export { TOKENS, USDC_BASE, EURC_BASE, USDC_BASE_SEPOLIA, USDC_SKALE_BASE, SKL_SKALE_BASE, USDT_SKALE_BASE, WBTC_SKALE_BASE, WETH_SKALE_BASE, SKL_SKALE_BASE_SEPOLIA, USDC_SKALE_BASE_SEPOLIA, USDT_SKALE_BASE_SEPOLIA, WBTC_SKALE_BASE_SEPOLIA, WETH_SKALE_BASE_SEPOLIA, getToken, getAllTokens, getTokensBySymbol, getTokensByChain, getUSDCTokens, getEURCTokens, getSKLTokens, getUSDTTokens, getWBTCTokens, getWETHTokens, } from "./data/tokens";
@@ -19,5 +19,5 @@ export { parseRoutePattern, matchRoute, findMatchingRoute, validateRouteConfig,
 export { encodePaymentV2, decodePaymentV2, encodeSettlementV2, decodeSettlementV2, isPaymentV2, isSettlementV2, } from "./encoding";
 export type { NetworkId, TokenId, FacilitatorConfig, FacilitatorVerifyResult, FacilitatorSettleResult, SettlementMode, PayToAddress, AcceptPaymentOptions, PricingConfig, PaymentResult, PaymentError, PaymentErrorCode, ArmoryPaymentResult, ResolvedNetwork, ResolvedToken, ResolvedFacilitator, ResolvedPaymentConfig, ValidationError, } from "./types/api";
 export type { PaymentRequiredContext, PaymentPayloadContext, HookResult, OnPaymentRequiredHook, BeforePaymentHook, ExtensionHook, HookConfig, HookRegistry, } from "./types/hooks";
-export { createX402V2Payload, createLegacyV2Payload, INVALID_PAYLOADS, TEST_PAYER_ADDRESS, TEST_PAY_TO_ADDRESS, TEST_CONTRACT_ADDRESS, TEST_PRIVATE_KEY, } from "./fixtures/payloads";
-export { DEFAULT_PAYMENT_CONFIG, type TestPaymentConfig } from "./fixtures/config";
+export type { FacilitatorClientConfig, SupportedKind, SupportedResponse, } from "./payment-client";
+export { verifyPayment, settlePayment, getSupported, decodePayloadHeader, extractPayerAddress, } from "./payment-client";

package/dist/index.js

@@ -1,108 +1,14 @@
+import { randomBytes } from 'crypto';
+
 // src/types/x402.ts
-var X402_VERSION = 1;
+var X402_VERSION = 2;
 var SCHEMES = ["exact"];
-var CHAIN_ID_TO_NETWORK = {
-  1: "ethereum",
-  8453: "base",
-  84532: "base-sepolia",
-  137: "polygon",
-  42161: "arbitrum",
-  421614: "arbitrum-sepolia",
-  10: "optimism",
-  11155420: "optimism-sepolia",
-  11155111: "ethereum-sepolia"
-};
 function isPaymentPayload(obj) {
-  return typeof obj === "object" && obj !== null && "x402Version" in obj && "scheme" in obj && "network" in obj && "payload" in obj;
+  return typeof obj === "object" && obj !== null && "x402Version" in obj && "accepted" in obj && "payload" in obj;
 }
 function isExactEvmPayload(obj) {
   return typeof obj === "object" && obj !== null && "signature" in obj && "authorization" in obj;
 }
-function extractNetworkFromLegacy(legacy) {
-  if ("network" in legacy && typeof legacy.network === "string") {
-    return legacy.network;
-  }
-  if ("chainId" in legacy && typeof legacy.chainId === "string") {
-    const match = legacy.chainId.match(/^eip155:(\d+)$/);
-    if (match) {
-      const chainId = parseInt(match[1], 10);
-      return CHAIN_ID_TO_NETWORK[chainId] || `eip155:${chainId}`;
-    }
-  }
-  if ("chainId" in legacy && typeof legacy.chainId === "number") {
-    return CHAIN_ID_TO_NETWORK[legacy.chainId] || `eip155:${legacy.chainId}`;
-  }
-  return "base";
-}
-function extractSignatureFromLegacy(legacy) {
-  if ("v" in legacy && "r" in legacy && "s" in legacy) {
-    const v = legacy.v.toString(16).padStart(2, "0");
-    const r = legacy.r.startsWith("0x") ? legacy.r.slice(2) : legacy.r;
-    const s = legacy.s.startsWith("0x") ? legacy.s.slice(2) : legacy.s;
-    return `0x${r}${s}${v}`;
-  }
-  if ("signature" in legacy && typeof legacy.signature === "object" && legacy.signature !== null) {
-    const sig = legacy.signature;
-    const v = sig.v.toString(16).padStart(2, "0");
-    const r = sig.r.startsWith("0x") ? sig.r.slice(2) : sig.r;
-    const s = sig.s.startsWith("0x") ? sig.s.slice(2) : sig.s;
-    return `0x${r}${s}${v}`;
-  }
-  return "0x";
-}
-function convertAmountToAtomic(amount) {
-  if (amount.includes(".")) {
-    const parts = amount.split(".");
-    const whole = parts[0];
-    const fractional = parts[1] || "";
-    const paddedFractional = fractional.padEnd(6, "0").slice(0, 6);
-    return `${whole}${paddedFractional}`;
-  }
-  return amount;
-}
-function convertNonceToHex(nonce) {
-  if (nonce.startsWith("0x") && nonce.length === 66) {
-    return nonce;
-  }
-  const hex = BigInt(nonce).toString(16).padStart(64, "0");
-  return `0x${hex}`;
-}
-function extractFromAddress(legacy) {
-  return legacy.from;
-}
-function extractToAddress(legacy) {
-  if ("to" in legacy && typeof legacy.to === "string") {
-    return legacy.to;
-  }
-  return legacy.from;
-}
-function legacyToPaymentPayload(legacy) {
-  if (isPaymentPayload(legacy)) {
-    return legacy;
-  }
-  const network = extractNetworkFromLegacy(legacy);
-  const signature = extractSignatureFromLegacy(legacy);
-  const value = convertAmountToAtomic(legacy.amount);
-  const nonce = convertNonceToHex(legacy.nonce);
-  const from = extractFromAddress(legacy);
-  const to = extractToAddress(legacy);
-  return {
-    x402Version: X402_VERSION,
-    scheme: "exact",
-    network,
-    payload: {
-      signature,
-      authorization: {
-        from,
-        to,
-        value,
-        validAfter: "0",
-        validBefore: legacy.expiry.toString(),
-        nonce
-      }
-    }
-  };
-}
 
 // src/types/v2.ts
 var V2_HEADERS = {
@@ -123,7 +29,7 @@ function isPaymentRequiredV2(obj) {
   return typeof obj === "object" && obj !== null && "x402Version" in obj && obj.x402Version === 2 && "resource" in obj && "accepts" in obj && Array.isArray(obj.accepts);
 }
 function isPaymentPayloadV2(obj) {
-  return typeof obj === "object" && obj !== null && "x402Version" in obj && obj.x402Version === 2 && "scheme" in obj && "network" in obj && "payload" in obj;
+  return typeof obj === "object" && obj !== null && "x402Version" in obj && obj.x402Version === 2 && "accepted" in obj && "payload" in obj;
 }
 function assetIdToAddress(assetId) {
   const match = assetId.match(/\/erc20:(0x[a-fA-F0-9]{40})$/);
@@ -163,13 +69,10 @@ function safeBase64Decode(str) {
   return Buffer.from(str, "base64").toString("utf-8");
 }
 function encodePayment(payload) {
-  let normalizedPayload;
-  if (isPaymentPayload(payload)) {
-    normalizedPayload = payload;
-  } else {
-    normalizedPayload = legacyToPaymentPayload(payload);
+  if (!isPaymentPayload(payload)) {
+    throw new Error("Invalid payment payload format");
   }
-  const safePayload = JSON.parse(JSON.stringify(normalizedPayload, (_, value) => {
+  const safePayload = JSON.parse(JSON.stringify(payload, (_, value) => {
     if (typeof value === "bigint") {
       return value.toString();
     }
@@ -178,10 +81,15 @@ function encodePayment(payload) {
   return safeBase64Encode(JSON.stringify(safePayload));
 }
 function decodePayment(encoded) {
-  const decoded = safeBase64Decode(encoded);
-  const parsed = JSON.parse(decoded);
+  let parsed;
+  try {
+    parsed = JSON.parse(encoded);
+  } catch {
+    const decoded = safeBase64Decode(encoded);
+    parsed = JSON.parse(decoded);
+  }
   if (!isPaymentPayload(parsed)) {
-    return legacyToPaymentPayload(parsed);
+    throw new Error("Invalid payment payload format");
   }
   return parsed;
 }
@@ -195,15 +103,23 @@ function encodeSettlementResponse(response) {
   return safeBase64Encode(JSON.stringify(safeResponse));
 }
 function decodeSettlementResponse(encoded) {
-  const decoded = safeBase64Decode(encoded);
-  return JSON.parse(decoded);
+  try {
+    return JSON.parse(encoded);
+  } catch {
+    const decoded = safeBase64Decode(encoded);
+    return JSON.parse(decoded);
+  }
 }
 function encodeX402Response(response) {
   return safeBase64Encode(JSON.stringify(response));
 }
 function decodeX402Response(encoded) {
-  const decoded = safeBase64Decode(encoded);
-  return JSON.parse(decoded);
+  try {
+    return JSON.parse(encoded);
+  } catch {
+    const decoded = safeBase64Decode(encoded);
+    return JSON.parse(decoded);
+  }
 }
 function detectPaymentVersion(headers) {
   if (headers.has("PAYMENT-SIGNATURE")) {
@@ -235,12 +151,6 @@ function createSettlementHeaders(settlement) {
     [V2_HEADERS.PAYMENT_RESPONSE]: encodeSettlementResponse(settlement)
   };
 }
-function isLegacyV2(payload) {
-  return typeof payload === "object" && payload !== null && "signature" in payload && typeof payload.signature === "object";
-}
-
-// src/utils/x402.ts
-import { randomBytes } from "crypto";
 function createNonce() {
   const bytes = randomBytes(32);
   return `0x${bytes.toString("hex")}`;
@@ -314,13 +224,7 @@ function normalizeAddress(address) {
 
 // src/types/protocol.ts
 function isX402V2Payload(obj) {
-  return typeof obj === "object" && obj !== null && "x402Version" in obj && obj.x402Version === 2 && "signature" in obj && "chainId" in obj && "assetId" in obj;
-}
-function isLegacyV2Payload(obj) {
-  if (typeof obj !== "object" || obj === null) return false;
-  const record = obj;
-  const signature = record.signature;
-  return "signature" in record && typeof signature === "object" && signature !== null && "v" in signature && "chainId" in record && typeof record.chainId === "string" && record.chainId.startsWith("eip155:") && "assetId" in record && !("x402Version" in record);
+  return typeof obj === "object" && obj !== null && "x402Version" in obj && obj.x402Version === 2 && "accepted" in obj && "payload" in obj;
 }
 function isX402V2Requirements(obj) {
   return typeof obj === "object" && obj !== null && "scheme" in obj && obj.scheme === "exact" && "network" in obj && typeof obj.network === "string" && obj.network.startsWith("eip155:") && // CAIP-2 format
@@ -367,10 +271,10 @@ var NETWORKS = {
   "base-sepolia": {
     name: "Base Sepolia",
     chainId: 84532,
-    usdcAddress: "0x036CbD53842c5426634e7929541eA237834d2D14",
+    usdcAddress: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
     rpcUrl: "https://sepolia.base.org",
     caip2Id: "eip155:84532",
-    caipAssetId: "eip155:84532/erc20:0x036CbD53842c5426634e7929541eA237834d2D14"
+    caipAssetId: "eip155:84532/erc20:0x036CbD53842c5426634e7929541eC2318f3dCF7e"
   },
   "skale-base": {
     name: "SKALE Base",
@@ -461,7 +365,7 @@ var USDC_BASE_SEPOLIA = {
   symbol: "USDC",
   name: "USD Coin",
   version: "2",
-  contractAddress: "0x036CbD5d9A3b9231f83BefBE4F9E3FAA03eee2e0",
+  contractAddress: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
   chainId: 84532,
   decimals: 6
 };
@@ -469,7 +373,7 @@ var USDC_SKALE_BASE = {
   symbol: "USDC",
   name: "USD Coin",
   version: "2",
-  contractAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+  contractAddress: "0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20",
   chainId: 1187947933,
   decimals: 6
 };
@@ -477,7 +381,7 @@ var SKL_SKALE_BASE = {
   symbol: "SKL",
   name: "SKALE",
   version: "1",
-  contractAddress: "0xaf2e1eb5c9f4a94dbf7400f76e4ec0d8de18fb8584",
+  contractAddress: "0xE0595a049d02b7674572b0d59cd4880Db60EDC50",
   chainId: 1187947933,
   decimals: 18
 };
@@ -485,7 +389,7 @@ var USDT_SKALE_BASE = {
   symbol: "USDT",
   name: "Tether USD",
   version: "1",
-  contractAddress: "0x2bF5bF154b4881Ef4E3Ff28Ac1a60Fa1aDcb5fE5F6",
+  contractAddress: "0x2bF5bF154b515EaA82C31a65ec11554fF5aF7fCA",
   chainId: 1187947933,
   decimals: 6
 };
@@ -493,7 +397,7 @@ var WBTC_SKALE_BASE = {
   symbol: "WBTC",
   name: "Wrapped BTC",
   version: "1",
-  contractAddress: "0x1aee79F6316aD699F96468A32F7BaF2fD8d55c0000",
+  contractAddress: "0x1aeeCFE5454c83B42D8A316246CAc9739E7f690e",
   chainId: 1187947933,
   decimals: 8
 };
@@ -501,7 +405,7 @@ var WETH_SKALE_BASE = {
   symbol: "WETH",
   name: "Wrapped Ether",
   version: "1",
-  contractAddress: "0x8fF2237e4d845bc7Db6E1f1a93C8bCb288Bc5a400",
+  contractAddress: "0x7bD39ABBd0Dd13103542cAe3276C7fA332bCA486",
   chainId: 1187947933,
   decimals: 18
 };
@@ -509,7 +413,7 @@ var SKL_SKALE_BASE_SEPOLIA = {
   symbol: "SKL",
   name: "SKALE",
   version: "1",
-  contractAddress: "0xaf2e1eb5c9f4a94dbf7400f76e4ec0d8de18fb8584",
+  contractAddress: "0xaf2e0ff5b5f51553fdb34ce7f04a6c3201cee57b",
   chainId: 324705682,
   decimals: 18
 };
@@ -517,7 +421,7 @@ var USDC_SKALE_BASE_SEPOLIA = {
   symbol: "USDC",
   name: "USD Coin",
   version: "2",
-  contractAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+  contractAddress: "0x2e08028E3C4c2356572E096d8EF835cD5C6030bD",
   chainId: 324705682,
   decimals: 6
 };
@@ -525,7 +429,7 @@ var USDT_SKALE_BASE_SEPOLIA = {
   symbol: "USDT",
   name: "Tether USD",
   version: "1",
-  contractAddress: "0xe8af39ca6558a983f6b5f8c0b828cc609f7a1c200",
+  contractAddress: "0x3ca0a49f511c2c89c4dcbbf1731120d8919050bf",
   chainId: 324705682,
   decimals: 6
 };
@@ -533,7 +437,7 @@ var WBTC_SKALE_BASE_SEPOLIA = {
   symbol: "WBTC",
   name: "Wrapped BTC",
   version: "1",
-  contractAddress: "0x1aee79F6316aD699F96468A32F7BaF2fD8d55c0000",
+  contractAddress: "0x4512eacd4186b025186e1cf6cc0d89497c530e87",
   chainId: 324705682,
   decimals: 8
 };
@@ -541,7 +445,7 @@ var WETH_SKALE_BASE_SEPOLIA = {
   symbol: "WETH",
   name: "Wrapped Ether",
   version: "1",
-  contractAddress: "0x8fF2237e4d845bc7Db6E1f1a93C8bCb288Bc5a400",
+  contractAddress: "0xf94056bd7f6965db3757e1b145f200b7346b4fc0",
   chainId: 324705682,
   decimals: 18
 };
@@ -1289,214 +1193,128 @@ var encodePaymentV2 = (payload) => base64JsonEncode(payload);
 var decodePaymentV2 = (encoded) => base64JsonDecode(encoded);
 var encodeSettlementV2 = (response) => base64JsonEncode(response);
 var decodeSettlementV2 = (encoded) => base64JsonDecode(encoded);
-var isPaymentV2 = (payload) => "signature" in payload && typeof payload.signature === "object";
-var isSettlementV2 = (response) => "status" in response;
+var isPaymentV2 = (payload) => "x402Version" in payload && payload.x402Version === 2 && "accepted" in payload && "payload" in payload;
+var isSettlementV2 = (response) => "success" in response && typeof response.success === "boolean" && "network" in response;
 
-// src/fixtures/payloads.ts
-var TEST_PRIVATE_KEY = "0x0000000000000000000000000000000000000000000000000000000000000000001";
-var TEST_PAYER_ADDRESS = "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1";
-var TEST_PAY_TO_ADDRESS = "0x1234567890123456789012345678901234567890";
-var TEST_CONTRACT_ADDRESS = "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48";
-var createV2Authorization = (nonce) => ({
-  from: TEST_PAYER_ADDRESS,
-  to: TEST_PAY_TO_ADDRESS,
-  value: "1000000",
-  validAfter: Math.floor(Date.now() / 1e3).toString(),
-  validBefore: (Math.floor(Date.now() / 1e3) + 3600).toString(),
-  nonce: `0x${Buffer.from(nonce).toString("hex").padStart(64, "0")}`
-});
-var createV2SchemePayload = (nonce) => ({
-  signature: `0x${"b".repeat(130)}`,
-  authorization: createV2Authorization(nonce)
-});
-var createX402V2Payload = (nonce) => ({
-  x402Version: 2,
-  scheme: "exact",
-  network: "eip155:84532",
-  payload: createV2SchemePayload(nonce ?? "test_v2_nonce"),
-  resource: {
-    url: "https://example.com/api/test",
-    description: "Test resource"
+// src/payment-client.ts
+var DEFAULT_FACILITATOR_URL = "https://facilitator.payai.network";
+function toJsonSafe(data) {
+  function convert(value) {
+    if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+      return Object.fromEntries(Object.entries(value).map(([key, val]) => [key, convert(val)]));
+    }
+    if (Array.isArray(value)) {
+      return value.map(convert);
+    }
+    if (typeof value === "bigint") {
+      return value.toString();
+    }
+    return value;
   }
-});
-var createLegacyV2Payload = (nonce) => ({
-  from: TEST_PAYER_ADDRESS,
-  to: TEST_PAY_TO_ADDRESS,
-  amount: "1000000",
-  nonce: nonce ?? "test_legacy_v2_nonce",
-  expiry: Math.floor(Date.now() / 1e3) + 3600,
-  signature: {
-    v: 27,
-    r: `0x${"f".repeat(64)}`,
-    s: `0x${"0".repeat(64)}`
-  },
-  chainId: "eip155:84532",
-  assetId: `eip155:84532/erc20:${TEST_CONTRACT_ADDRESS.slice(2)}`
-});
-var INVALID_PAYLOADS = {
-  missingFields: {},
-  invalidAddress: {
-    x402Version: 2,
-    scheme: "exact",
-    network: "eip155:84532",
-    payload: {
-      signature: `0x${"i".repeat(130)}`,
-      authorization: {
-        from: "not-an-address",
-        to: TEST_PAY_TO_ADDRESS,
-        value: "1000000",
-        validAfter: Math.floor(Date.now() / 1e3).toString(),
-        validBefore: (Math.floor(Date.now() / 1e3) + 3600).toString(),
-        nonce: `0x${"1".repeat(64)}`
+  return convert(data);
+}
+function resolveUrl(config) {
+  return config?.url ?? DEFAULT_FACILITATOR_URL;
+}
+async function resolveHeaders(config) {
+  const base = { "Content-Type": "application/json" };
+  if (!config?.createHeaders) return base;
+  const extra = await config.createHeaders();
+  return { ...base, ...extra };
+}
+async function verifyPayment(payload, requirements, config) {
+  const url = resolveUrl(config);
+  const headers = await resolveHeaders(config);
+  const response = await fetch(`${url}/verify`, {
+    method: "POST",
+    headers,
+    body: JSON.stringify({
+      paymentPayload: toJsonSafe(payload),
+      paymentRequirements: toJsonSafe(requirements)
+    })
+  });
+  if (response.status !== 200) {
+    const text = await response.text().catch(() => response.statusText);
+    throw new Error(`Facilitator verify failed: ${response.status} ${text}`);
+  }
+  return await response.json();
+}
+async function settlePayment(payload, requirements, config) {
+  const url = resolveUrl(config);
+  const headers = await resolveHeaders(config);
+  const response = await fetch(`${url}/settle`, {
+    method: "POST",
+    headers,
+    body: JSON.stringify({
+      paymentPayload: toJsonSafe(payload),
+      paymentRequirements: toJsonSafe(requirements)
+    })
+  });
+  if (response.status !== 200) {
+    const text = await response.text().catch(() => response.statusText);
+    throw new Error(`Facilitator settle failed: ${response.status} ${text}`);
+  }
+  return await response.json();
+}
+async function getSupported(config) {
+  const url = resolveUrl(config);
+  const headers = await resolveHeaders(config);
+  const response = await fetch(`${url}/supported`, {
+    method: "GET",
+    headers
+  });
+  if (response.status !== 200) {
+    throw new Error(`Facilitator supported failed: ${response.statusText}`);
+  }
+  return await response.json();
+}
+function isCompactV2Payload(payload) {
+  if (typeof payload !== "object" || payload === null) return false;
+  const record = payload;
+  return typeof record.x402Version === "number" && "payload" in record && !("accepted" in record);
+}
+function decodePayloadHeader(headerValue, defaults) {
+  if (headerValue.startsWith("{")) {
+    const parsed = JSON.parse(headerValue);
+    if (isPaymentPayload(parsed)) return parsed;
+    if (isCompactV2Payload(parsed)) {
+      const compact = parsed;
+      if (!defaults?.accepted) {
+        throw new Error("Invalid payment payload: missing 'accepted' field and no defaults provided");
       }
+      return {
+        x402Version: 2,
+        accepted: defaults.accepted,
+        payload: compact.payload
+      };
     }
-  },
-  expired: (() => {
-    const payload = createX402V2Payload("test_expired_nonce");
-    payload.payload.authorization.validBefore = (Math.floor(Date.now() / 1e3) - 100).toString();
-    return payload;
-  })(),
-  malformedSignature: (() => {
-    const payload = createX402V2Payload("test_malformed_sig_nonce");
-    payload.payload.signature = "not-hex";
-    return payload;
-  })()
-};
-
-// src/fixtures/config.ts
-var TEST_PRIVATE_KEY2 = process.env.TEST_PRIVATE_KEY || "0x0000000000000000000000000000000000000000000000000000000000000000000001";
-var TEST_PAY_TO_ADDRESS2 = "0x1234567890123456789012345678901234567890";
-var TEST_NETWORK = "base-sepolia";
-var TEST_AMOUNT_DECIMAL = "1.0";
-var FACILITATOR_URL = process.env.FACILITATOR_URL || "https://facilitator.payai.network";
-var TEST_RPC_URL = process.env.TEST_RPC_URL || "https://sepolia.base.org";
-var DEFAULT_PAYMENT_CONFIG = {
-  payTo: TEST_PAY_TO_ADDRESS2,
-  amount: TEST_AMOUNT_DECIMAL,
-  network: TEST_NETWORK,
-  defaultVersion: 2,
-  accept: {
-    networks: [TEST_NETWORK],
-    tokens: ["usdc"],
-    facilitators: [{ url: FACILITATOR_URL }]
+    throw new Error("Invalid payment payload: unrecognized format");
   }
-};
-export {
-  DEFAULT_PAYMENT_CONFIG,
-  EIP712_TYPES,
-  ERC20_ABI,
-  EURC_BASE,
-  INVALID_PAYLOADS,
-  NETWORKS,
-  PAYMENT_REQUIRED_HEADER,
-  PAYMENT_RESPONSE_HEADER,
-  PAYMENT_SIGNATURE_HEADER,
-  SCHEMES,
-  SKL_SKALE_BASE,
-  SKL_SKALE_BASE_SEPOLIA,
-  TEST_CONTRACT_ADDRESS,
-  TEST_PAYER_ADDRESS,
-  TEST_PAY_TO_ADDRESS,
-  TEST_PRIVATE_KEY,
-  TOKENS,
-  USDC_BASE,
-  USDC_BASE_SEPOLIA,
-  USDC_DOMAIN,
-  USDC_SKALE_BASE,
-  USDC_SKALE_BASE_SEPOLIA,
-  USDT_SKALE_BASE,
-  USDT_SKALE_BASE_SEPOLIA,
-  V2_HEADERS,
-  WBTC_SKALE_BASE,
-  WBTC_SKALE_BASE_SEPOLIA,
-  WETH_SKALE_BASE,
-  WETH_SKALE_BASE_SEPOLIA,
-  X402_VERSION,
-  addressToAssetId,
-  assetIdToAddress,
-  caip2ToNetwork,
-  checkFacilitatorSupport,
-  combineSignature as combineSignatureV2,
-  createEIP712Domain,
-  createError,
-  createLegacyV2Payload,
-  createNonce,
-  createPaymentRequiredHeaders,
-  createSettlementHeaders,
-  createTransferWithAuthorization,
-  createX402V2Payload,
-  decodePayment,
-  decodePaymentV2,
-  decodeSettlementResponse,
-  decodeSettlementV2,
-  decodeX402Response,
-  detectPaymentVersion,
-  encodePayment,
-  encodePaymentV2,
-  encodeSettlementResponse,
-  encodeSettlementV2,
-  encodeX402Response,
-  extractPaymentFromHeaders,
-  findMatchingRoute,
-  fromAtomicUnits,
-  getAllCustomTokens,
-  getAllTokens,
-  getAvailableNetworks,
-  getAvailableTokens,
-  getCurrentTimestamp,
-  getCustomToken,
-  getEURCTokens,
-  getMainnets,
-  getNetworkByChainId,
-  getNetworkConfig,
-  getSKLTokens,
-  getTestnets,
-  getToken,
-  getTokensByChain,
-  getTokensBySymbol,
-  getTxHash,
-  getUSDCTokens,
-  getUSDTTokens,
-  getWBTCTokens,
-  getWETHTokens,
-  isAddress,
-  isCAIP2ChainId,
-  isCAIPAssetId,
-  isCustomToken,
-  isExactEvmPayload,
-  isLegacyV2,
-  isLegacyV2Payload,
-  isPaymentPayload,
-  isPaymentPayloadV2,
-  isPaymentRequiredV2,
-  isPaymentV2,
-  isResolvedNetwork,
-  isResolvedToken,
-  isSettlementSuccessful,
-  isSettlementV2,
-  isValidAddress,
-  isValidationError,
-  isX402V2Payload,
-  isX402V2PaymentRequired,
-  isX402V2Requirements,
-  isX402V2Settlement,
-  legacyToPaymentPayload,
-  matchRoute,
-  networkToCaip2,
-  normalizeAddress,
-  normalizeNetworkName,
-  parseRoutePattern,
-  parseSignature as parseSignatureV2,
-  registerToken,
-  resolveFacilitator,
-  resolveNetwork,
-  resolveToken,
-  safeBase64Decode,
-  safeBase64Encode,
-  toAtomicUnits,
-  unregisterToken,
-  validateAcceptConfig,
-  validatePaymentConfig,
-  validateRouteConfig,
-  validateTransferWithAuthorization
-};
+  const normalized = headerValue.replace(/-/g, "+").replace(/_/g, "/").padEnd(Math.ceil(headerValue.length / 4) * 4, "=");
+  try {
+    const decoded = JSON.parse(Buffer.from(normalized, "base64").toString("utf-8"));
+    if (isPaymentPayload(decoded)) return decoded;
+    if (isCompactV2Payload(decoded)) {
+      const compact = decoded;
+      if (!defaults?.accepted) {
+        throw new Error("Invalid payment payload: missing 'accepted' field and no defaults provided");
+      }
+      return {
+        x402Version: 2,
+        accepted: defaults.accepted,
+        payload: compact.payload
+      };
+    }
+    throw new Error("Invalid payment payload: unrecognized format");
+  } catch {
+    throw new Error("Invalid payment payload: failed to decode");
+  }
+}
+function extractPayerAddress(payload) {
+  if (isExactEvmPayload(payload.payload)) {
+    return payload.payload.authorization.from;
+  }
+  throw new Error("Unable to extract payer address from payload");
+}
+
+export { EIP712_TYPES, ERC20_ABI, EURC_BASE, NETWORKS, PAYMENT_REQUIRED_HEADER, PAYMENT_RESPONSE_HEADER, PAYMENT_SIGNATURE_HEADER, SCHEMES, SKL_SKALE_BASE, SKL_SKALE_BASE_SEPOLIA, TOKENS, USDC_BASE, USDC_BASE_SEPOLIA, USDC_DOMAIN, USDC_SKALE_BASE, USDC_SKALE_BASE_SEPOLIA, USDT_SKALE_BASE, USDT_SKALE_BASE_SEPOLIA, V2_HEADERS, WBTC_SKALE_BASE, WBTC_SKALE_BASE_SEPOLIA, WETH_SKALE_BASE, WETH_SKALE_BASE_SEPOLIA, X402_VERSION, addressToAssetId, assetIdToAddress, caip2ToNetwork, checkFacilitatorSupport, combineSignature as combineSignatureV2, createEIP712Domain, createError, createNonce, createPaymentRequiredHeaders, createSettlementHeaders, createTransferWithAuthorization, decodePayloadHeader, decodePayment, decodePaymentV2, decodeSettlementResponse, decodeSettlementV2, decodeX402Response, detectPaymentVersion, encodePayment, encodePaymentV2, encodeSettlementResponse, encodeSettlementV2, encodeX402Response, extractPayerAddress, extractPaymentFromHeaders, findMatchingRoute, fromAtomicUnits, getAllCustomTokens, getAllTokens, getAvailableNetworks, getAvailableTokens, getCurrentTimestamp, getCustomToken, getEURCTokens, getMainnets, getNetworkByChainId, getNetworkConfig, getSKLTokens, getSupported, getTestnets, getToken, getTokensByChain, getTokensBySymbol, getTxHash, getUSDCTokens, getUSDTTokens, getWBTCTokens, getWETHTokens, isAddress, isCAIP2ChainId, isCAIPAssetId, isCustomToken, isExactEvmPayload, isPaymentPayload, isPaymentPayloadV2, isPaymentRequiredV2, isPaymentV2, isResolvedNetwork, isResolvedToken, isSettlementSuccessful, isSettlementV2, isValidAddress, isValidationError, isX402V2Payload, isX402V2PaymentRequired, isX402V2Requirements, isX402V2Settlement, matchRoute, networkToCaip2, normalizeAddress, normalizeNetworkName, parseRoutePattern, parseSignature as parseSignatureV2, registerToken, resolveFacilitator, resolveNetwork, resolveToken, safeBase64Decode, safeBase64Encode, settlePayment, toAtomicUnits, unregisterToken, validateAcceptConfig, validatePaymentConfig, validateRouteConfig, validateTransferWithAuthorization, verifyPayment };

package/dist/payment-client.d.ts

@@ -0,0 +1,23 @@
+import type { PaymentPayload, PaymentRequirements, VerifyResponse, SettlementResponse } from "./types/x402";
+export interface FacilitatorClientConfig {
+    url: string;
+    createHeaders?: () => Record<string, string> | Promise<Record<string, string>>;
+}
+export declare function verifyPayment(payload: PaymentPayload, requirements: PaymentRequirements, config?: FacilitatorClientConfig): Promise<VerifyResponse>;
+export declare function settlePayment(payload: PaymentPayload, requirements: PaymentRequirements, config?: FacilitatorClientConfig): Promise<SettlementResponse>;
+export interface SupportedKind {
+    x402Version: number;
+    scheme: string;
+    network: string;
+    extra?: Record<string, unknown>;
+}
+export interface SupportedResponse {
+    kinds: SupportedKind[];
+}
+interface DecodePayloadDefaults {
+    accepted?: PaymentRequirements;
+}
+export declare function getSupported(config?: FacilitatorClientConfig): Promise<SupportedResponse>;
+export declare function decodePayloadHeader(headerValue: string, defaults?: DecodePayloadDefaults): PaymentPayload;
+export declare function extractPayerAddress(payload: PaymentPayload): string;
+export {};

package/dist/types/protocol.d.ts

@@ -53,10 +53,6 @@ export type CAIPAssetId = `eip155:${string}/erc20:${string}`;
  * Check if payload is x402 V2 format (Coinbase format)
  */
 export declare function isX402V2Payload(obj: unknown): obj is PaymentPayloadV2;
-/**
- * Check if payload is legacy Armory V2 format
- */
-export declare function isLegacyV2Payload(obj: unknown): boolean;
 /**
  * Check if requirements is x402 V2 format
  */

package/dist/types/v2.d.ts

@@ -43,7 +43,7 @@ export interface PaymentRequirementsV2 {
     /** Blockchain network identifier in CAIP-2 format */
     network: CAIP2Network;
     /** Required payment amount in atomic token units */
-    amount: string;
+    maxAmountRequired: string;
     /** Token contract address (extracted from CAIP asset ID) */
     asset: Address;
     /** Recipient wallet address or role constant */
@@ -103,17 +103,17 @@ export interface SchemePayloadV2 {
 /**
  * Payment payload sent by client
  * Matches x402 V2 PaymentPayload spec (Coinbase format)
+ *
+ * The 'accepted' field echoes the server's requirements being accepted.
  */
 export interface PaymentPayloadV2 {
     /** Protocol version identifier */
     x402Version: 2;
-    /** Payment scheme (e.g., "exact") */
-    scheme: string;
-    /** Network identifier in CAIP-2 format */
-    network: string;
+    /** The payment requirements being accepted (echoed from server) */
+    accepted: PaymentRequirementsV2;
     /** Scheme-specific payment data */
     payload: SchemePayloadV2;
-    /** Resource being accessed (optional, echoed from server) */
+    /** Resource being accessed (optional) */
     resource?: ResourceInfo;
     /** Protocol extensions data */
     extensions?: Extensions;

package/dist/types/x402.d.ts

@@ -6,7 +6,7 @@
  */
 export type Address = `0x${string}`;
 export type Hex = `0x${string}`;
-export declare const X402_VERSION: 1;
+export declare const X402_VERSION: 2;
 export type X402Version = typeof X402_VERSION;
 export declare const SCHEMES: readonly ["exact"];
 export type Scheme = (typeof SCHEMES)[number];
@@ -30,25 +30,35 @@ export interface ExactEvmPayload {
     authorization: ExactEvmAuthorization;
 }
 /**
- * Payment payload - Coinbase compatible format
- * This is the unified format that works with both v1 and v2
+ * Resource information for payment payload
+ */
+export interface ResourceInfo {
+    url: string;
+    description?: string;
+    mimeType?: string;
+}
+/**
+ * Payment payload - Coinbase compatible format (x402 v2)
+ * Uses 'accepted' field to echo server's requirements
  */
 export interface PaymentPayload {
     x402Version: X402Version;
-    scheme: Scheme;
-    network: Network;
+    accepted: PaymentRequirements;
     payload: ExactEvmPayload;
+    resource?: ResourceInfo;
+    extensions?: Record<string, unknown>;
 }
 /**
  * Unsigned payment payload (before signing)
  */
 export interface UnsignedPaymentPayload {
     x402Version: X402Version;
-    scheme: Scheme;
-    network: Network;
+    accepted: PaymentRequirements;
     payload: Omit<ExactEvmPayload, "signature"> & {
         signature: undefined;
     };
+    resource?: ResourceInfo;
+    extensions?: Record<string, unknown>;
 }
 /**
  * Payment requirements for 402 response
@@ -57,7 +67,7 @@ export interface UnsignedPaymentPayload {
 export interface PaymentRequirements {
     scheme: Scheme;
     network: Network;
-    amount: string;
+    maxAmountRequired: string;
     payTo: Address;
     maxTimeoutSeconds: number;
     asset: Address;
@@ -92,44 +102,8 @@ export interface X402Response {
     accepts?: PaymentRequirements[];
     payer?: Address;
 }
-export interface PaymentPayloadV1 {
-    from: string;
-    to: string;
-    amount: string;
-    nonce: string;
-    expiry: number;
-    v: number;
-    r: string;
-    s: string;
-    chainId: number;
-    contractAddress: string;
-    network: string;
-}
-export interface PaymentPayloadV2 {
-    from: Address;
-    to: Address | {
-        role?: string;
-        callback?: string;
-    };
-    amount: string;
-    nonce: string;
-    expiry: number;
-    signature: {
-        v: number;
-        r: string;
-        s: string;
-    };
-    chainId: `eip155:${string}`;
-    assetId: `eip155:${string}/erc20:${string}`;
-    extensions?: Record<string, unknown>;
-}
-export type LegacyPaymentPayload = PaymentPayloadV1 | PaymentPayloadV2;
 /**
  * Type guards
  */
 export declare function isPaymentPayload(obj: unknown): obj is PaymentPayload;
 export declare function isExactEvmPayload(obj: unknown): obj is ExactEvmPayload;
-/**
- * Convert legacy payload to new format
- */
-export declare function legacyToPaymentPayload(legacy: LegacyPaymentPayload | PaymentPayload): PaymentPayload;

package/dist/utils/utils/index.d.ts

@@ -4,4 +4,3 @@
  * Re-exports commonly used test utilities
  */
 export * from "./mock-facilitator";
-export * from "../../fixtures/config";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@armory-sh/base",
-  "version": "0.2.21",
+  "version": "0.2.22-alpha.3.20",
   "license": "MIT",
   "author": "Sawyer Cutler <sawyer@dirtroad.dev>",
   "type": "module",
@@ -23,7 +23,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/thegreataxios/armory.git",
+    "url": "git+https://github.com/TheGreatAxios/armory.git",
     "directory": "packages/base"
   },
   "dependencies": {},
@@ -37,4 +37,4 @@
     "test": "bun test",
     "typecheck": "tsc --noEmit"
   }
-}
+}

package/dist/fixtures/config.d.ts

@@ -1,48 +0,0 @@
-/**
- * Test Configuration
- *
- * Shared configuration for E2E tests including network configs,
- * test keys, and facilitator URLs.
- */
-export declare const TEST_PRIVATE_KEY: `0x${string}`;
-export declare const TEST_PAYER_ADDRESS: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1";
-export declare const TEST_PAY_TO_ADDRESS: "0x1234567890123456789012345678901234567890";
-export declare const TEST_CONTRACT_ADDRESS: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48";
-export declare const TEST_NETWORK: "base-sepolia";
-export declare const TEST_CHAIN_ID: 84532;
-export declare const TEST_CAIP2_NETWORK: "eip155:84532";
-export declare const TEST_ASSET_ID: "eip155:84532/erc20:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48";
-export declare const TEST_AMOUNT: "1000000";
-export declare const TEST_AMOUNT_DECIMAL: "1.0";
-export declare const FACILITATOR_URL: string;
-export declare const MOCK_FACILITATOR_PORT = 8899;
-export declare const TEST_TIMEOUT_MS = 30000;
-export declare const SERVER_STARTUP_DELAY_MS = 100;
-export declare const SETTLEMENT_TIMEOUT_MS = 10000;
-export declare const TEST_RPC_URL: string;
-export interface TestPaymentConfig {
-    payTo: `0x${string}`;
-    amount: string;
-    network: string;
-    defaultVersion: 1 | 2;
-    accept: {
-        networks: string[];
-        tokens: string[];
-        facilitators: Array<{
-            url: string;
-        }>;
-    };
-}
-export declare const DEFAULT_PAYMENT_CONFIG: TestPaymentConfig;
-/**
- * Get a random port for test servers
- */
-export declare const getRandomPort: () => number;
-/**
- * Create a test nonce with timestamp
- */
-export declare const createTestNonce: (prefix: string) => string;
-/**
- * Sleep for specified milliseconds
- */
-export declare const sleep: (ms: number) => Promise<void>;

package/dist/fixtures/payloads.d.ts

@@ -1,16 +0,0 @@
-/**
- * Mock Payment Payloads for Testing (V2 Only)
- */
-import type { X402PayloadV2, PaymentPayloadV2 } from "@armory-sh/base";
-export declare const TEST_PRIVATE_KEY = "0x0000000000000000000000000000000000000000000000000000000000000000001";
-export declare const TEST_PAYER_ADDRESS = "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb1";
-export declare const TEST_PAY_TO_ADDRESS = "0x1234567890123456789012345678901234567890";
-export declare const TEST_CONTRACT_ADDRESS = "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48";
-export declare const createX402V2Payload: (nonce?: string) => PaymentPayloadV2;
-export declare const createLegacyV2Payload: (nonce?: string) => X402PayloadV2;
-export declare const INVALID_PAYLOADS: {
-    readonly missingFields: {};
-    readonly invalidAddress: PaymentPayloadV2;
-    readonly expired: PaymentPayloadV2;
-    readonly malformedSignature: PaymentPayloadV2;
-};

package/dist/fixtures/requirements.d.ts

@@ -1,35 +0,0 @@
-/**
- * Mock Payment Requirements for Testing (V2 Only)
- */
-import type { PaymentRequirementsV2 } from "@armory-sh/base";
-export declare const MOCK_X402_V2_REQUIREMENTS: PaymentRequirementsV2;
-export declare const createX402V2Requirements: (overrides?: Partial<PaymentRequirementsV2>) => PaymentRequirementsV2;
-export declare const INVALID_REQUIREMENTS: {
-    readonly missingAmount: {
-        scheme: "exact";
-        network: import("@armory-sh/base").CAIP2ChainId;
-        amount: string;
-        asset: import("@armory-sh/base").Address;
-        payTo: import("@armory-sh/base").Address;
-        maxTimeoutSeconds: number;
-        name?: string;
-        version?: string;
-        extra?: import("@armory-sh/base").Extensions;
-    };
-    readonly invalidNetwork: {
-        readonly scheme: "exact";
-        readonly network: `eip155:${string}`;
-        readonly amount: "1000000";
-        readonly asset: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48";
-        readonly payTo: "0x1234567890123456789012345678901234567890";
-        readonly maxTimeoutSeconds: 300;
-    };
-    readonly invalidAsset: {
-        readonly scheme: "exact";
-        readonly network: "eip155:84532";
-        readonly amount: "1000000";
-        readonly asset: `0x${string}`;
-        readonly payTo: "0x1234567890123456789012345678901234567890";
-        readonly maxTimeoutSeconds: 300;
-    };
-};

package/dist/types/v1.d.ts

@@ -1,156 +0,0 @@
-/**
- * Armory V1 Types - x402 Protocol V1 Compatible
- *
- * Supports both the x402 V1 specification format and legacy Armory V1 format.
- *
- * x402 V1 Specification: https://github.com/coinbase/x402
- */
-import type { Address } from "./v2";
-/**
- * Network name for x402 V1 (e.g., "base-sepolia", "ethereum-mainnet")
- */
-export type X402V1Network = string;
-/**
- * EIP-3009 authorization data (same format for V1 and V2)
- */
-export interface EIP3009AuthorizationV1 {
-    from: Address;
-    to: Address;
-    value: string;
-    validAfter: string;
-    validBefore: string;
-    nonce: `0x${string}`;
-}
-/**
- * Payment requirements for a specific payment method (x402 V1)
- */
-export interface X402PaymentRequirementsV1 {
-    scheme: "exact";
-    network: X402V1Network;
-    maxAmountRequired: string;
-    asset: Address;
-    payTo: Address;
-    resource: string;
-    description: string;
-    mimeType?: string;
-    outputSchema?: object | null;
-    maxTimeoutSeconds: number;
-    extra?: Record<string, unknown>;
-}
-/**
- * Payment requirements response (x402 V1)
- * Matches x402 V1 PaymentRequirementsResponse spec
- */
-export interface X402PaymentRequiredV1 {
-    x402Version: 1;
-    error: string;
-    accepts: X402PaymentRequirementsV1[];
-}
-/**
- * Scheme payload data (x402 V1)
- */
-export interface X402SchemePayloadV1 {
-    signature: `0x${string}`;
-    authorization: EIP3009AuthorizationV1;
-}
-/**
- * Payment payload (x402 V1)
- * Matches x402 V1 PaymentPayload spec
- */
-export interface X402PaymentPayloadV1 {
-    x402Version: 1;
-    scheme: "exact";
-    network: X402V1Network;
-    payload: X402SchemePayloadV1;
-}
-/**
- * Settlement response (x402 V1)
- * Matches x402 V1 SettlementResponse spec
- */
-export interface X402SettlementResponseV1 {
-    success: boolean;
-    errorReason?: string;
-    transaction: string;
-    network: X402V1Network;
-    payer: Address;
-}
-/**
- * Legacy Armory V1 payment payload format
- * @deprecated Use X402PaymentPayloadV1 for new code
- */
-export interface LegacyPaymentPayloadV1 {
-    from: string;
-    to: string;
-    amount: string;
-    nonce: string;
-    expiry: number;
-    v: number;
-    r: string;
-    s: string;
-    chainId: number;
-    contractAddress: string;
-    network: string;
-}
-/**
- * Legacy Armory V1 payment requirements format
- * @deprecated Use X402PaymentRequirementsV1 for new code
- */
-export interface LegacyPaymentRequirementsV1 {
-    amount: string;
-    network: string;
-    contractAddress: string;
-    payTo: string;
-    expiry: number;
-}
-/**
- * Legacy Armory V1 settlement response format
- * @deprecated Use X402SettlementResponseV1 for new code
- */
-export interface LegacySettlementResponseV1 {
-    success: boolean;
-    txHash?: string;
-    error?: string;
-    timestamp: number;
-}
-export type PaymentPayloadV1 = X402PaymentPayloadV1 | LegacyPaymentPayloadV1;
-export type PaymentRequirementsV1 = X402PaymentRequirementsV1 | LegacyPaymentRequirementsV1;
-export type SettlementResponseV1 = X402SettlementResponseV1 | LegacySettlementResponseV1;
-export declare const V1_HEADERS: {
-    readonly PAYMENT: "X-PAYMENT";
-    readonly PAYMENT_RESPONSE: "X-PAYMENT-RESPONSE";
-    readonly PAYMENT_REQUIRED: "X-PAYMENT-REQUIRED";
-};
-export declare function encodeX402PaymentRequiredV1(data: X402PaymentRequiredV1): string;
-export declare function decodeX402PaymentRequiredV1(encoded: string): X402PaymentRequiredV1;
-export declare function encodeX402PaymentPayloadV1(data: X402PaymentPayloadV1): string;
-export declare function decodeX402PaymentPayloadV1(encoded: string): X402PaymentPayloadV1;
-export declare function encodeX402SettlementResponseV1(data: X402SettlementResponseV1): string;
-export declare function decodeX402SettlementResponseV1(encoded: string): X402SettlementResponseV1;
-/**
- * @deprecated Use encodeX402PaymentPayloadV1 instead
- */
-export declare function encodePaymentPayloadLegacy(payload: LegacyPaymentPayloadV1): string;
-/**
- * @deprecated Use decodeX402PaymentPayloadV1 instead
- */
-export declare function decodePaymentPayloadLegacy(encoded: string): LegacyPaymentPayloadV1;
-/**
- * @deprecated Use encodeX402SettlementResponseV1 instead
- */
-export declare function encodeSettlementResponseLegacy(response: LegacySettlementResponseV1): string;
-/**
- * @deprecated Use decodeX402SettlementResponseV1 instead
- */
-export declare function decodeSettlementResponseLegacy(encoded: string): LegacySettlementResponseV1;
-/**
- * Check if value is x402 V1 PaymentRequired
- */
-export declare function isX402PaymentRequiredV1(obj: unknown): obj is X402PaymentRequiredV1;
-/**
- * Check if value is x402 V1 PaymentPayload
- */
-export declare function isX402PaymentPayloadV1(obj: unknown): obj is X402PaymentPayloadV1;
-/**
- * Check if value is legacy Armory V1 format
- */
-export declare function isLegacyPaymentPayloadV1(obj: unknown): obj is LegacyPaymentPayloadV1;