@relai-fi/x402 0.6.2 → 0.6.4

package/dist/index.d.cts

@@ -4,3 +4,88 @@ export { RelayFeedbackConfig, submitRelayFeedback } from './relay-feedback.cjs';
 export { A as AcceptsExtra, B as BASE_MAINNET_NETWORK, C as CAIP2_TO_NETWORK, b as CHAIN_IDS, E as EXPLORER_TX_URL, l as EvmWallet, N as NETWORK_CAIP2, e as NETWORK_LABELS, d as NETWORK_TOKENS, c as NetworkToken, P as PaymentAccept, o as PaymentRequired, R as RELAI_FACILITATOR_URL, h as RELAI_NETWORKS, a as RelaiNetwork, m as ResourceInfo, S as SOLANA_MAINNET_NETWORK, k as SolanaWallet, U as USDC_ADDRESSES, g as USDC_BASE, f as USDC_SOLANA, W as WalletSet, j as isEvm, i as isSolana, n as normalizeNetwork, r as resolveToken } from './types-Y9ni5XwY.cjs';
 export { BridgeBalances, BridgeQuoteResult, BridgeResult } from './management.cjs';
 export { NETWORK_V1_TO_V2, NETWORK_V2_TO_V1, convertPayloadToVersion, convertV1ToV2, convertV2ToV1, detectPayloadVersion, formatUsd, fromAtomicUnits, isEvmNetwork, isSolanaNetwork, networkV1ToV2, networkV2ToV1, normalizePaymentHeader, toAtomicUnits } from './utils/index.cjs';
+export { charge as evmChargeMethod } from './mpp/evm-method.cjs';
+export { EvmChargeConfig, evmCharge as evmChargeServer } from './mpp/evm-server.cjs';
+export { EvmChargeClientConfig, evmCharge as evmChargeClient } from './mpp/evm-client.cjs';
+import 'mppx';
+import 'zod/v4/core';
+import 'zod/mini';
+import 'viem';
+
+/**
+ * Payment Code API — BLIK-style x402 payment codes
+ *
+ * generatePaymentCode() — sign EIP-3009 authorization and register on SKALE L3
+ * redeemPaymentCode()   — redeem a code (payee calls this, triggers Base L2 settlement)
+ * getPaymentCode()      — check code status
+ */
+interface PaymentCodeConfig {
+    facilitatorUrl?: string;
+}
+interface GeneratePaymentCodeParams {
+    /** EIP-3009 signer — must implement signTypedData */
+    signer: {
+        getAddress(): Promise<string>;
+        signTypedData(domain: object, types: object, value: object): Promise<string>;
+    };
+    /** Payee wallet address */
+    to: string;
+    /** Amount in USDC micro-units (6 decimals), e.g. 1000 = $0.001 */
+    value: string | bigint;
+    /** USDC contract address on Base L2 (defaults to Base mainnet USDC) */
+    usdcContract?: string;
+    /** TTL in seconds (default: 120) */
+    ttl?: number;
+}
+interface PaymentCode {
+    code: string;
+    validBefore: number;
+    expiresIn: number;
+}
+interface RedeemResult {
+    success: boolean;
+    code: string;
+    l3TxHash: string;
+    l2TxHash: string;
+    explorerUrl: string;
+    amount: string;
+    from: string;
+    to: string;
+}
+interface CodeStatus {
+    code: string;
+    from: string;
+    to: string;
+    value: string;
+    validBefore: number;
+    redeemed: boolean;
+    expired: boolean;
+    redeemable: boolean;
+}
+/**
+ * Generate a BLIK-style x402 payment code backed by EIP-3009.
+ *
+ * @example
+ * const { code } = await generatePaymentCode(config, {
+ *   signer: walletClient,
+ *   to: "0xMerchant...",
+ *   value: "1000",  // $0.001 USDC
+ *   ttl: 120,
+ * });
+ * // code = "X7K9P2AB"
+ */
+declare function generatePaymentCode(config: PaymentCodeConfig, params: GeneratePaymentCodeParams): Promise<PaymentCode>;
+/**
+ * Redeem a payment code. Triggers Base L2 settlement via relayer.
+ *
+ * @example
+ * const result = await redeemPaymentCode(config, "X7K9P2AB");
+ * // result.l2TxHash = "0x..."
+ */
+declare function redeemPaymentCode(config: PaymentCodeConfig, code: string): Promise<RedeemResult>;
+/**
+ * Get the status of a payment code.
+ */
+declare function getPaymentCode(config: PaymentCodeConfig, code: string): Promise<CodeStatus>;
+
+export { type CodeStatus, type GeneratePaymentCodeParams, type PaymentCode, type PaymentCodeConfig, type RedeemResult, generatePaymentCode, getPaymentCode, redeemPaymentCode };

package/dist/index.d.ts

@@ -4,3 +4,88 @@ export { RelayFeedbackConfig, submitRelayFeedback } from './relay-feedback.js';
 export { A as AcceptsExtra, B as BASE_MAINNET_NETWORK, C as CAIP2_TO_NETWORK, b as CHAIN_IDS, E as EXPLORER_TX_URL, l as EvmWallet, N as NETWORK_CAIP2, e as NETWORK_LABELS, d as NETWORK_TOKENS, c as NetworkToken, P as PaymentAccept, o as PaymentRequired, R as RELAI_FACILITATOR_URL, h as RELAI_NETWORKS, a as RelaiNetwork, m as ResourceInfo, S as SOLANA_MAINNET_NETWORK, k as SolanaWallet, U as USDC_ADDRESSES, g as USDC_BASE, f as USDC_SOLANA, W as WalletSet, j as isEvm, i as isSolana, n as normalizeNetwork, r as resolveToken } from './types-Y9ni5XwY.js';
 export { BridgeBalances, BridgeQuoteResult, BridgeResult } from './management.js';
 export { NETWORK_V1_TO_V2, NETWORK_V2_TO_V1, convertPayloadToVersion, convertV1ToV2, convertV2ToV1, detectPayloadVersion, formatUsd, fromAtomicUnits, isEvmNetwork, isSolanaNetwork, networkV1ToV2, networkV2ToV1, normalizePaymentHeader, toAtomicUnits } from './utils/index.js';
+export { charge as evmChargeMethod } from './mpp/evm-method.js';
+export { EvmChargeConfig, evmCharge as evmChargeServer } from './mpp/evm-server.js';
+export { EvmChargeClientConfig, evmCharge as evmChargeClient } from './mpp/evm-client.js';
+import 'mppx';
+import 'zod/v4/core';
+import 'zod/mini';
+import 'viem';
+
+/**
+ * Payment Code API — BLIK-style x402 payment codes
+ *
+ * generatePaymentCode() — sign EIP-3009 authorization and register on SKALE L3
+ * redeemPaymentCode()   — redeem a code (payee calls this, triggers Base L2 settlement)
+ * getPaymentCode()      — check code status
+ */
+interface PaymentCodeConfig {
+    facilitatorUrl?: string;
+}
+interface GeneratePaymentCodeParams {
+    /** EIP-3009 signer — must implement signTypedData */
+    signer: {
+        getAddress(): Promise<string>;
+        signTypedData(domain: object, types: object, value: object): Promise<string>;
+    };
+    /** Payee wallet address */
+    to: string;
+    /** Amount in USDC micro-units (6 decimals), e.g. 1000 = $0.001 */
+    value: string | bigint;
+    /** USDC contract address on Base L2 (defaults to Base mainnet USDC) */
+    usdcContract?: string;
+    /** TTL in seconds (default: 120) */
+    ttl?: number;
+}
+interface PaymentCode {
+    code: string;
+    validBefore: number;
+    expiresIn: number;
+}
+interface RedeemResult {
+    success: boolean;
+    code: string;
+    l3TxHash: string;
+    l2TxHash: string;
+    explorerUrl: string;
+    amount: string;
+    from: string;
+    to: string;
+}
+interface CodeStatus {
+    code: string;
+    from: string;
+    to: string;
+    value: string;
+    validBefore: number;
+    redeemed: boolean;
+    expired: boolean;
+    redeemable: boolean;
+}
+/**
+ * Generate a BLIK-style x402 payment code backed by EIP-3009.
+ *
+ * @example
+ * const { code } = await generatePaymentCode(config, {
+ *   signer: walletClient,
+ *   to: "0xMerchant...",
+ *   value: "1000",  // $0.001 USDC
+ *   ttl: 120,
+ * });
+ * // code = "X7K9P2AB"
+ */
+declare function generatePaymentCode(config: PaymentCodeConfig, params: GeneratePaymentCodeParams): Promise<PaymentCode>;
+/**
+ * Redeem a payment code. Triggers Base L2 settlement via relayer.
+ *
+ * @example
+ * const result = await redeemPaymentCode(config, "X7K9P2AB");
+ * // result.l2TxHash = "0x..."
+ */
+declare function redeemPaymentCode(config: PaymentCodeConfig, code: string): Promise<RedeemResult>;
+/**
+ * Get the status of a payment code.
+ */
+declare function getPaymentCode(config: PaymentCodeConfig, code: string): Promise<CodeStatus>;
+
+export { type CodeStatus, type GeneratePaymentCodeParams, type PaymentCode, type PaymentCodeConfig, type RedeemResult, generatePaymentCode, getPaymentCode, redeemPaymentCode };