@relai-fi/x402 0.6.2 → 0.6.3

package/dist/index.d.cts

@@ -4,3 +4,81 @@ 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';
+
+/**
+ * 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,81 @@ 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';
+
+/**
+ * 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.js

@@ -1,3 +1,10 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
 // src/types.ts
 var RELAI_FACILITATOR_URL = "https://facilitator.x402.fi";
 var NETWORK_CAIP2 = {
@@ -2204,6 +2211,96 @@ function submitRelayFeedback(config) {
   })();
 }
 
+// src/payment-codes.ts
+var DEFAULT_FACILITATOR = "https://relai.fi/facilitator";
+var DEFAULT_USDC_BASE = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+var EIP3009_TYPES = {
+  TransferWithAuthorization: [
+    { name: "from", type: "address" },
+    { name: "to", type: "address" },
+    { name: "value", type: "uint256" },
+    { name: "validAfter", type: "uint256" },
+    { name: "validBefore", type: "uint256" },
+    { name: "nonce", type: "bytes32" }
+  ]
+};
+function randomBytes32() {
+  const bytes = new Uint8Array(32);
+  if (typeof globalThis.crypto !== "undefined") {
+    globalThis.crypto.getRandomValues(bytes);
+  } else {
+    const { randomBytes } = __require("crypto");
+    randomBytes(32).copy(Buffer.from(bytes.buffer));
+  }
+  return "0x" + Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+async function generatePaymentCode(config, params) {
+  const { signer, to, value, usdcContract, ttl = 120 } = params;
+  const facilitatorUrl = config.facilitatorUrl || DEFAULT_FACILITATOR;
+  const usdc = usdcContract || DEFAULT_USDC_BASE;
+  const from = await signer.getAddress();
+  const now = Math.floor(Date.now() / 1e3);
+  const validAfter = 0;
+  const validBefore = now + ttl;
+  const nonce = randomBytes32();
+  const domain = {
+    name: "USD Coin",
+    version: "2",
+    chainId: 8453,
+    // Base mainnet
+    verifyingContract: usdc
+  };
+  const message = {
+    from,
+    to,
+    value: BigInt(value).toString(),
+    validAfter,
+    validBefore,
+    nonce
+  };
+  const signature = await signer.signTypedData(domain, EIP3009_TYPES, message);
+  const res = await fetch(`${facilitatorUrl}/payment-codes`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      from,
+      to,
+      value: BigInt(value).toString(),
+      validAfter,
+      validBefore,
+      nonce,
+      signature,
+      usdcContract: usdc
+    })
+  });
+  if (!res.ok) {
+    const err = await res.json().catch(() => ({}));
+    throw new Error(`Failed to register payment code: ${err.error || res.status}`);
+  }
+  return res.json();
+}
+async function redeemPaymentCode(config, code) {
+  const facilitatorUrl = config.facilitatorUrl || DEFAULT_FACILITATOR;
+  const res = await fetch(`${facilitatorUrl}/payment-codes/${code.toUpperCase()}/redeem`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" }
+  });
+  if (!res.ok) {
+    const err = await res.json().catch(() => ({}));
+    throw new Error(`Failed to redeem payment code: ${err.error || res.status}`);
+  }
+  return res.json();
+}
+async function getPaymentCode(config, code) {
+  const facilitatorUrl = config.facilitatorUrl || DEFAULT_FACILITATOR;
+  const res = await fetch(`${facilitatorUrl}/payment-codes/${code.toUpperCase()}`);
+  if (!res.ok) {
+    const err = await res.json().catch(() => ({}));
+    throw new Error(`Payment code not found: ${err.error || res.status}`);
+  }
+  return res.json();
+}
+
 // src/utils/payload-converter.ts
 var NETWORK_V1_TO_V2 = {
   "solana": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
@@ -2368,6 +2465,8 @@ export {
   detectPayloadVersion,
   formatUsd,
   fromAtomicUnits,
+  generatePaymentCode,
+  getPaymentCode,
   isEvm,
   isEvmNetwork,
   isSolana,
@@ -2376,6 +2475,7 @@ export {
   networkV2ToV1,
   normalizeNetwork,
   normalizePaymentHeader,
+  redeemPaymentCode,
   resolveToken,
   stripePayTo,
   submitRelayFeedback,