@armory-sh/base 0.2.13 → 0.2.16

package/dist/data/tokens.d.ts

@@ -0,0 +1,40 @@
+import type { CustomToken } from "../types/networks";
+export declare const USDC_BASE: CustomToken;
+export declare const EURC_BASE: CustomToken;
+export declare const USDC_BASE_SEPOLIA: CustomToken;
+export declare const USDC_SKALE_BASE: CustomToken;
+export declare const SKL_SKALE_BASE: CustomToken;
+export declare const USDT_SKALE_BASE: CustomToken;
+export declare const WBTC_SKALE_BASE: CustomToken;
+export declare const WETH_SKALE_BASE: CustomToken;
+export declare const SKL_SKALE_BASE_SEPOLIA: CustomToken;
+export declare const USDC_SKALE_BASE_SEPOLIA: CustomToken;
+export declare const USDT_SKALE_BASE_SEPOLIA: CustomToken;
+export declare const WBTC_SKALE_BASE_SEPOLIA: CustomToken;
+export declare const WETH_SKALE_BASE_SEPOLIA: CustomToken;
+export declare const TOKENS: {
+    readonly USDC_BASE: CustomToken;
+    readonly USDC_BASE_SEPOLIA: CustomToken;
+    readonly EURC_BASE: CustomToken;
+    readonly USDC_SKALE_BASE: CustomToken;
+    readonly USDT_SKALE_BASE: CustomToken;
+    readonly WBTC_SKALE_BASE: CustomToken;
+    readonly WETH_SKALE_BASE: CustomToken;
+    readonly SKL_SKALE_BASE: CustomToken;
+    readonly SKL_SKALE_BASE_SEPOLIA: CustomToken;
+    readonly USDC_SKALE_BASE_SEPOLIA: CustomToken;
+    readonly USDT_SKALE_BASE_SEPOLIA: CustomToken;
+    readonly WBTC_SKALE_BASE_SEPOLIA: CustomToken;
+    readonly WETH_SKALE_BASE_SEPOLIA: CustomToken;
+};
+declare function getToken(chainId: number, contractAddress: string): CustomToken | undefined;
+declare function getAllTokens(): CustomToken[];
+declare function getTokensBySymbol(symbol: string): CustomToken[];
+declare function getTokensByChain(chainId: number): CustomToken[];
+export declare function getUSDCTokens(): CustomToken[];
+export declare function getEURCTokens(): CustomToken[];
+export declare function getSKLTokens(): CustomToken[];
+export declare function getUSDTTokens(): CustomToken[];
+export declare function getWBTCTokens(): CustomToken[];
+export declare function getWETHTokens(): CustomToken[];
+export { getToken, getAllTokens, getTokensBySymbol, getTokensByChain };

package/dist/encoding/x402.d.ts

@@ -1,10 +1,10 @@
 /**
- * X402 Protocol Encoding - Coinbase Compatible
+ * X402 Protocol Encoding - V2 Only (Coinbase Compatible)
  *
- * All payment payloads are Base64 encoded for transport in HTTP headers.
- * This matches the Coinbase x402 SDK format.
+ * Payment payloads are JSON-encoded for transport in HTTP headers.
+ * Matches the Coinbase x402 v2 SDK format.
  */
-import type { PaymentPayload, SettlementResponse, X402Response, LegacyPaymentPayload, PaymentPayloadV1, PaymentPayloadV2, PaymentRequirements } from "../types/x402";
+import type { PaymentPayload, X402Response, PaymentPayloadV2, PaymentRequirements, SettlementResponse } from "../types/x402";
 /**
  * Safe Base64 encode (URL-safe, no padding)
  */
@@ -14,20 +14,19 @@ export declare function safeBase64Encode(str: string): string;
  */
 export declare function safeBase64Decode(str: string): string;
 /**
- * Encode payment payload to Base64 string
- * All versions use Base64 encoding for compatibility
+ * Encode payment payload to JSON string
  */
-export declare function encodePayment(payload: PaymentPayload | LegacyPaymentPayload): string;
+export declare function encodePayment(payload: PaymentPayload | PaymentPayloadV2): string;
 /**
- * Decode payment payload from Base64 string
+ * Decode payment payload from JSON string
  */
 export declare function decodePayment(encoded: string): PaymentPayload;
 /**
- * Encode settlement response to Base64 string
+ * Encode settlement response to JSON string
  */
 export declare function encodeSettlementResponse(response: SettlementResponse): string;
 /**
- * Decode settlement response from Base64 string
+ * Decode settlement response from JSON string
  */
 export declare function decodeSettlementResponse(encoded: string): SettlementResponse;
 /**
@@ -38,40 +37,30 @@ export declare function encodeX402Response(response: X402Response): string;
  * Decode X402 error response
  */
 export declare function decodeX402Response(encoded: string): X402Response;
-/**
- * Unified X402 headers - Coinbase compatible
- */
-export declare const X402_HEADERS: {
-    readonly PAYMENT: "X-PAYMENT";
-    readonly PAYMENT_RESPONSE: "X-PAYMENT-RESPONSE";
-    readonly PAYMENT_REQUIRED: "X-PAYMENT-REQUIRED";
-};
 /**
  * Detect payment version from headers
  * Returns null if no payment header found
  *
- * Supports both x402 format (X-PAYMENT header with x402Version)
- * and legacy format (X-PAYMENT for v1, PAYMENT-SIGNATURE for v2)
+ * V2-only: checks for PAYMENT-SIGNATURE header
  */
 export declare function detectPaymentVersion(headers: Headers): number | null;
 /**
- * Extract payment from headers
+ * Extract payment from V2 headers
  */
 export declare function extractPaymentFromHeaders(headers: Headers): PaymentPayload | null;
 /**
- * Create payment required headers
+ * Create payment required headers (V2 format)
  */
 export declare function createPaymentRequiredHeaders(requirements: PaymentRequirements | PaymentRequirements[]): Record<string, string>;
 /**
- * Create settlement response headers
+ * Create settlement response headers (V2 format)
  */
 export declare function createSettlementHeaders(settlement: SettlementResponse): Record<string, string>;
 /**
- * Type guards for legacy compatibility
+ * Type guard for legacy V2 payload (without x402Version)
  */
-export declare function isLegacyV1(payload: unknown): payload is PaymentPayloadV1;
 export declare function isLegacyV2(payload: unknown): payload is PaymentPayloadV2;
 /**
- * Decode settlement from headers (legacy compatibility)
+ * Decode settlement from headers (V2 only)
  */
 export declare function decodeSettlement(headers: Headers): SettlementResponse;

package/dist/encoding.d.ts

@@ -1,22 +1,29 @@
-import type { PaymentPayloadV1, SettlementResponseV1 } from "./types/v1";
-import { V1_HEADERS } from "./types/v1";
 import type { PaymentPayloadV2, SettlementResponseV2 } from "./types/v2";
 import { V2_HEADERS } from "./types/v2";
-export { V1_HEADERS, V2_HEADERS };
-export type PaymentPayload = PaymentPayloadV1 | PaymentPayloadV2;
-export type SettlementResponse = SettlementResponseV1 | SettlementResponseV2;
-export declare const encodePaymentV1: (payload: PaymentPayloadV1) => string;
-export declare const decodePaymentV1: (encoded: string) => PaymentPayloadV1;
-export declare const encodeSettlementV1: (response: SettlementResponseV1) => string;
-export declare const decodeSettlementV1: (encoded: string) => SettlementResponseV1;
+export { V2_HEADERS };
+export type PaymentPayload = PaymentPayloadV2;
+export type SettlementResponse = SettlementResponseV2;
 export declare const encodePaymentV2: (payload: PaymentPayloadV2) => string;
 export declare const decodePaymentV2: (encoded: string) => PaymentPayloadV2;
 export declare const encodeSettlementV2: (response: SettlementResponseV2) => string;
 export declare const decodeSettlementV2: (encoded: string) => SettlementResponseV2;
-export declare const detectPaymentVersion: (headers: Headers) => 1 | 2 | null;
+/**
+ * Always returns 2 for V2-only mode
+ */
+export declare const detectPaymentVersion: (headers: Headers) => 2 | null;
+/**
+ * Decode payment from headers (V2 only)
+ */
 export declare const decodePayment: (headers: Headers) => PaymentPayload;
+/**
+ * Decode settlement from headers (V2 only)
+ */
 export declare const decodeSettlement: (headers: Headers) => SettlementResponse;
-export declare const isPaymentV1: (payload: PaymentPayload) => payload is PaymentPayloadV1;
+/**
+ * Type guard for V2 payload
+ */
 export declare const isPaymentV2: (payload: PaymentPayload) => payload is PaymentPayloadV2;
-export declare const isSettlementV1: (response: SettlementResponse) => response is SettlementResponseV1;
+/**
+ * Type guard for V2 settlement
+ */
 export declare const isSettlementV2: (response: SettlementResponse) => response is SettlementResponseV2;

package/dist/fixtures/payloads.d.ts

@@ -1,13 +1,11 @@
 /**
- * Mock Payment Payloads for Testing
+ * Mock Payment Payloads for Testing (V2 Only)
  */
-import type { X402PaymentPayloadV1, X402PayloadV2, PaymentPayloadV2 } from "@armory-sh/base";
-export declare const TEST_PRIVATE_KEY = "0x0000000000000000000000000000000000000000000000000000000000000000000001";
+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 createX402V1Payload: (nonce?: string) => X402PaymentPayloadV1;
-export declare const createFaremeterPayload: (nonce?: string) => X402PaymentPayloadV1;
 export declare const createX402V2Payload: (nonce?: string) => PaymentPayloadV2;
 export declare const createLegacyV2Payload: (nonce?: string) => X402PayloadV2;
 export declare const INVALID_PAYLOADS: {

package/dist/fixtures/requirements.d.ts

@@ -1,9 +1,7 @@
 /**
- * Mock Payment Requirements for Testing
+ * Mock Payment Requirements for Testing (V2 Only)
  */
-import type { X402PaymentRequirementsV1, PaymentRequirementsV2 } from "@armory-sh/base";
-export declare const MOCK_X402_V1_REQUIREMENTS: X402PaymentRequirementsV1;
-export declare const createX402V1Requirements: (overrides?: Partial<X402PaymentRequirementsV1>) => X402PaymentRequirementsV1;
+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: {
@@ -14,6 +12,8 @@ export declare const INVALID_REQUIREMENTS: {
         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: {

package/dist/index.d.ts

@@ -1,20 +1,20 @@
-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, PaymentPayloadV1 as X402PayloadV1, PaymentPayloadV2 as X402PayloadV2, LegacyPaymentPayload as X402LegacyPayload, } from "./types/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, 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, X402_HEADERS, detectPaymentVersion, extractPaymentFromHeaders, createPaymentRequiredHeaders, createSettlementHeaders, isLegacyV1, isLegacyV2, } from "./encoding/x402";
+export { safeBase64Encode, safeBase64Decode, encodePayment, decodePayment, encodeSettlementResponse, decodeSettlementResponse, encodeX402Response, decodeX402Response, detectPaymentVersion, extractPaymentFromHeaders, createPaymentRequiredHeaders, createSettlementHeaders, isLegacyV2, } from "./encoding/x402";
 export { createNonce, toAtomicUnits, fromAtomicUnits, caip2ToNetwork, networkToCaip2, getCurrentTimestamp, isValidAddress, normalizeAddress, } from "./utils/x402";
-export type { PaymentPayloadV1, PaymentRequirementsV1, SettlementResponseV1, X402PaymentPayloadV1, X402PaymentRequiredV1, X402PaymentRequirementsV1, X402SettlementResponseV1, X402SchemePayloadV1, EIP3009AuthorizationV1, LegacyPaymentPayloadV1, LegacyPaymentRequirementsV1, LegacySettlementResponseV1, } from "./types/v1";
-export { V1_HEADERS, encodeX402PaymentRequiredV1, decodeX402PaymentRequiredV1, encodeX402PaymentPayloadV1, decodeX402PaymentPayloadV1, encodeX402SettlementResponseV1, decodeX402SettlementResponseV1, isX402PaymentRequiredV1, isX402PaymentPayloadV1, isLegacyPaymentPayloadV1, encodePaymentPayloadLegacy, decodePaymentPayloadLegacy, encodeSettlementResponseLegacy, decodeSettlementResponseLegacy, } from "./types/v1";
-export { encodePaymentPayloadLegacy as encodePaymentPayload, decodePaymentPayloadLegacy as decodePaymentPayload } from "./types/v1";
 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 { isV1, isV2, isX402V1Payload, isX402V2Payload, isLegacyV1Payload, isX402V1Requirements, isX402V2Requirements, isX402V1Settlement, isX402V2Settlement, isX402V1PaymentRequired, isX402V2PaymentRequired, getPaymentVersion, getRequirementsVersion, getSettlementVersion, getPaymentRequiredVersion, getPaymentHeaderName, getPaymentResponseHeaderName, getPaymentRequiredHeaderName, isSettlementSuccessful, getTxHash, } from "./types/protocol";
+export { isX402V2Payload, isX402V2Requirements, isX402V2Settlement, isX402V2PaymentRequired, isLegacyV2Payload, 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";
 export type { TransferWithAuthorizationParams, ReceiveWithAuthorizationParams, BalanceOfParams, BalanceOfReturnType, NameReturnType, SymbolReturnType, ERC20Abi, } from "./abi/erc20";
 export { ERC20_ABI } from "./abi/erc20";
 export type { TypedDataDomain, EIP712Domain, TransferWithAuthorization, TypedDataField, EIP712Types, } from "./eip712";
 export { EIP712_TYPES, USDC_DOMAIN, createEIP712Domain, createTransferWithAuthorization, validateTransferWithAuthorization, } from "./eip712";
 export { resolveNetwork, resolveToken, resolveFacilitator, checkFacilitatorSupport, validatePaymentConfig, validateAcceptConfig, getAvailableNetworks, getAvailableTokens, isValidationError, isResolvedNetwork, isResolvedToken, createError, normalizeNetworkName, } from "./validation";
-export { encodePaymentV1, decodePaymentV1, encodeSettlementV1, decodeSettlementV1, encodePaymentV2, decodePaymentV2, encodeSettlementV2, decodeSettlementV2, detectPaymentVersion as detectPaymentVersionLegacy, decodePayment as decodePaymentLegacy, decodeSettlement as decodeSettlementLegacy, isPaymentV1, isPaymentV2, isSettlementV1, 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/simple";
+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 { 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";