@ab-org/predicate-market-sdk 0.0.2 → 0.1.1

package/README.md

@@ -7,7 +7,7 @@ Prediction-market specific helpers built on top of `@ab-org/sdk-core`.
 - Connection state via `createWalletConnectController()` and `createAccountController()` from `@ab-org/sdk-core`
 - Unified smart-wallet session metadata with capability policy support
 - High-level execution helpers via `createWalletExecutionController()`
-- Deposit / withdraw controllers with USD1-first defaults
+- Deposit / withdraw controllers with USDT-first defaults
 - **Dynamic token & chain lists** via `MarketDataProvider` (backend-driven, mock included)
 - **Quote / slippage API** — fetch real-time pricing before confirming deposit or withdraw
 - Predicate-market policy adapter for deposit / withdraw / trade flows
@@ -94,6 +94,16 @@ initSDK({
 
 Rules:
 - **`NEXT_PUBLIC_RELAY_ORIGIN`** (or `RELAY_ORIGIN`) must match where you serve **`/relay/google`** and **`/relay/x`**
+
+### Funding chain & funding token (withdraw / balance)
+
+- **`getChainInfo(chainId?)`** — resolves RPC, explorer metadata, native currency fields, and **`defaultFundingTokenAddress`** (per-chain default ERC-20 for the funding leg). If **`chainId`** is omitted or empty, defaults to **`3131`** (Tenderly BSC vnet). Built-in ids are **`3131`** and **`56`** (BSC mainnet); unknown ids throw.
+- **`getFundingTokenAddress(chainId?)`** — same optional **`chainId`** as **`getChainInfo`**. If **`NEXT_PUBLIC_FUNDING_TOKEN_ADDRESS`** / **`FUNDING_TOKEN_ADDRESS`** or legacy defaultFundingTokenAddress`**.
+- **`DEFAULT_FUNDING_TOKEN_ADDRESS`** — shorthand for **`getChainInfo().defaultFundingTokenAddress`** (default funding chain **`3131`**).
+- **`fetchFundingTokenBalance(address, { chainId, rpcUrl?, tokenAddress?, decimals?, displaySymbol? })`** — uses **`getChainInfo(chainId)`** for RPC when **`rpcUrl`** is omitted, **`getFundingTokenAddress(chainId)`** when **`tokenAddress`** is omitted, and **`decimals`** default **`chain.nativeCurrencyDecimals`** when omitted (override if your funding token uses different decimals). 
+- **`createFundingWithdrawExecutor({ chainId?, rpcUrl?, tokenAddress?, … })`** — uses the same **`chainId`** for **`getChainInfo`**, default token address (**`getFundingTokenAddress(chainId)`**), and order payload (default **`3131`** when **`chainId`** omitted).
+
+**Type note:** **`EvmChainInfo`** includes **`defaultFundingTokenAddress`**. If you construct chain objects manually in TypeScript, add that field or use **`getChainInfo`** instead of literals.
 - `socialProviders: undefined` uses built-in defaults (`google`, `x`)
 - `socialProviders: []` hides all social buttons
 - known social ids like `google` and `x` automatically reuse built-in icons unless you override `icon`
@@ -241,7 +251,7 @@ These policies can be passed into your smart-wallet authorization flow so app ac
 <button
   onClick={() =>
     withdraw.open({
-      defaultToken: "USD1",
+      defaultToken: "USDT",
       defaultChain: "AB_CORE",
       targetAddress: "0x...",
       defaultAmount: "100",

package/dist/constants/chains.d.ts

@@ -1,22 +1,2 @@
-export declare const testBsc: {
-    readonly chainId: "3131";
-    readonly name: "BSC_TENDERLY";
-    readonly chainName: "BSC_TENDERLY";
-    readonly nativeCurrencyName: "BSC";
-    readonly nativeCurrencySymbol: "BSC";
-    readonly nativeCurrencyDecimals: 18;
-    readonly rpcUrls: readonly ["https://virtual.binance.eu.rpc.tenderly.co/e643ea28-32eb-4fb9-8116-90be24f7defa"];
-    readonly blockExplorerUrl: "https://dashboard.tenderly.co/explorer/vnet/6593bc72-f548-497d-bff9-5be061436a48";
-    readonly platformType: "EVM";
-    readonly icon: "https://static.tomo.inc/token/bsc_new.svg";
-    readonly supportSwap: true;
-    readonly supportGift: true;
-    readonly supportHistory: true;
-};
-export declare const clientIds: {
-    readonly google: string;
-    readonly x: string;
-    readonly sdk: "MfLzAb2ItdDR3RZfE33ueqUhRf3mo1w0tBzLfExvLG72oUzvI6mgACtq19v6Vz7cmHVsfMBpbmr1fFU09sn30wbD";
-};
-export declare const BSC_USD1_ADDRESS = "0x8d0D000Ee44948FC98c9B98A4FA4921476f08B0d";
-export declare const BSC_USD1_PLATFORM_CONTRACT_ADDRESS = "0x1234567890123456789012345678901234567890";
+export { ClientIds, DEFAULT_FUNDING_CHAIN_ID, DEFAULT_FUNDING_TOKEN_ADDRESS, getFundingTokenAddress, getChainInfo, type EvmChainInfo, } from "@ab-org/wallet-utils";
+/** Demo / docs placeholder platform contract; replace in production. */

package/dist/constants/chains.js

@@ -1,23 +1,3 @@
-import { getEnv } from "../utils/env.js";
-export const testBsc = {
-    chainId: "3131",
-    name: "BSC_TENDERLY",
-    chainName: "BSC_TENDERLY",
-    nativeCurrencyName: "BSC",
-    nativeCurrencySymbol: "BSC",
-    nativeCurrencyDecimals: 18,
-    rpcUrls: ["https://virtual.binance.eu.rpc.tenderly.co/e643ea28-32eb-4fb9-8116-90be24f7defa"],
-    blockExplorerUrl: "https://dashboard.tenderly.co/explorer/vnet/6593bc72-f548-497d-bff9-5be061436a48",
-    platformType: "EVM",
-    icon: "https://static.tomo.inc/token/bsc_new.svg",
-    supportSwap: true,
-    supportGift: true,
-    supportHistory: true,
-};
-export const clientIds = {
-    google: getEnv("GOOGLE_CLIENT_ID"),
-    x: getEnv("X_CLIENT_ID"),
-    sdk: "MfLzAb2ItdDR3RZfE33ueqUhRf3mo1w0tBzLfExvLG72oUzvI6mgACtq19v6Vz7cmHVsfMBpbmr1fFU09sn30wbD",
-};
-export const BSC_USD1_ADDRESS = "0x8d0D000Ee44948FC98c9B98A4FA4921476f08B0d";
-export const BSC_USD1_PLATFORM_CONTRACT_ADDRESS = "0x1234567890123456789012345678901234567890";
+export { ClientIds, DEFAULT_FUNDING_CHAIN_ID, DEFAULT_FUNDING_TOKEN_ADDRESS, getFundingTokenAddress, getChainInfo, } from "@ab-org/wallet-utils";
+/** Demo / docs placeholder platform contract; replace in production. */
+// export const FUNDING_TOKEN_PLATFORM_CONTRACT_ADDRESS ="0x1234567890123456789012345678901234567890";

package/dist/index.d.ts

@@ -8,6 +8,8 @@ export * from "./modules/withdraw.js";
 export * from "./modules/marketData.js";
 export * from "./modules/balanceQuery.js";
 export * from "./modules/withdrawExecutor.js";
+export * from "./modules/api.js";
+export * from "./modules/withdrawDirect.js";
 export * from "./policyAdapter.js";
 export * from "./ui/SignInModal.js";
 export * from "./ui/signInTypes.js";
@@ -17,3 +19,4 @@ export * from "./ui/WithdrawModal.js";
 export * from "./ui/components/DropdownField.js";
 export * from "./ui/components/DepositDetailsPanel.js";
 export * from "./walletUtils.js";
+export * from "./constants/chains.js";

package/dist/index.js

@@ -8,6 +8,8 @@ export * from "./modules/withdraw.js";
 export * from "./modules/marketData.js";
 export * from "./modules/balanceQuery.js";
 export * from "./modules/withdrawExecutor.js";
+export * from "./modules/api.js";
+export * from "./modules/withdrawDirect.js";
 export * from "./policyAdapter.js";
 export * from "./ui/SignInModal.js";
 export * from "./ui/signInTypes.js";
@@ -17,3 +19,5 @@ export * from "./ui/WithdrawModal.js";
 export * from "./ui/components/DropdownField.js";
 export * from "./ui/components/DepositDetailsPanel.js";
 export * from "./walletUtils.js";
+// Re-export funding chain helpers so apps can import from package root
+export * from "./constants/chains.js";

package/dist/modules/api.d.ts

@@ -1,5 +1,5 @@
 /**
- * Merchant API client (BaseUrl: https://merchant.tomo.services)
+ * Merchant API client
  * 基于 axios 封装，类型与文档一致。
  */
 import { type AxiosInstance } from "axios";
@@ -14,6 +14,10 @@ export interface TokenData {
     symbol: string;
     address: string;
     decimals: number;
+    /** 最小充值量（最小单位字符串，如 `"15000000"`） */
+    minimum_deposit?: string;
+    /** 是否为 USD 类稳定币 */
+    is_usd_stable?: boolean;
 }
 export interface ChainData {
     chain_id: string;
@@ -33,12 +37,12 @@ export interface PlatformRegisterResponseData {
     chain_id: string;
 }
 export type QuoteDirection = "deposit" | "withdraw";
-export interface QuoteRequest {
+interface QuoteRequest {
     direction: QuoteDirection;
     chain_id: string;
     token_address: string;
     token_amount?: string;
-    usd1_amount?: string;
+    dst_token_amount?: string;
 }
 export interface QuoteResponseData {
     token_address: string;
@@ -47,7 +51,7 @@ export interface QuoteResponseData {
     rate: string;
     chain_id: number;
     deposit_address?: string;
-    usd1_amount?: string;
+    dst_token_amount?: string;
     token_amount?: string;
     expires_at?: string;
 }
@@ -58,7 +62,7 @@ export interface DepositOrderResponseData {
     source_chain_id: string;
     token_address: string;
     token_amount?: string;
-    usd1_amount?: string;
+    dst_token_amount?: string;
     deposit_address?: string;
     source_tx_hash?: string;
     created_at?: string;
@@ -70,8 +74,8 @@ export interface WithdrawOrderResponseData {
     status: WithdrawOrderStatus;
     one_time_address?: string;
     chain_id: string;
-    usd1_amount: string;
-    /** Fee (e.g. "0.01 USD1"); only present if backend includes it in GET /api/v1/orders/withdraw/:id. UI falls back to feeDisplay prop or "—". */
+    dst_token_amount: string;
+    /** Fee (e.g. "0.01 USDT"); only present if backend includes it in GET /api/v1/orders/withdraw/:id. UI falls back to feeDisplay prop or "—". */
     fee?: string;
     target_chain_id: string;
     target_address: string;
@@ -123,7 +127,7 @@ export interface CreateOrderResponseData {
     payment_sessions: PaymentSessionResponseData[];
 }
 /**
- * 配置 Merchant API 的 baseURL（可选，默认 https://merchant.tomo.services）
+ * 配置 Merchant API 的 baseURL
  */
 export declare function configureMerchantApi(): void;
 /**
@@ -142,3 +146,4 @@ export declare function getDepositOrder(orderId: string): Promise<DepositOrderRe
 export declare function getWithdrawOrder(orderId: string): Promise<WithdrawOrderResponseData>;
 /** POST /order - 创建 NATIVE_SWAP 提现订单 */
 export declare function createOrder(body: CreateOrderRequest): Promise<CreateOrderResponseData>;
+export {};

package/dist/modules/api.js

@@ -1,13 +1,15 @@
 /**
- * Merchant API client (BaseUrl: https://merchant.tomo.services)
+ * Merchant API client
  * 基于 axios 封装，类型与文档一致。
  */
 import { getEnv } from "../utils/env.js";
 import axios from "axios";
-const DEFAULT_MERCHANT_BASE_URL = "https://merchant.tomo.services";
 // ─── Axios 实例与请求封装 ─────────────────────────────────────────────────────
 function createClient() {
-    const BASE_URL = getEnv("MERCHANT_BASE_URL") || DEFAULT_MERCHANT_BASE_URL;
+    const BASE_URL = getEnv("MERCHANT_BASE_URL");
+    if (!BASE_URL) {
+        throw new Error('MERCHANT_BASE_URL is not set');
+    }
     return axios.create({
         baseURL: BASE_URL,
         timeout: 30000,
@@ -24,7 +26,7 @@ function unwrap(res) {
 // 单例 client，可通过 configureMerchantApi 修改 baseURL
 let apiClient = createClient();
 /**
- * 配置 Merchant API 的 baseURL（可选，默认 https://merchant.tomo.services）
+ * 配置 Merchant API 的 baseURL
  */
 export function configureMerchantApi() {
     apiClient = createClient();

package/dist/modules/balanceQuery.d.ts

@@ -8,13 +8,20 @@ export interface Erc20BalanceResult {
  * No external library dependency – uses the global `fetch`.
  */
 export declare function fetchErc20Balance(rpcUrl: string, tokenAddress: string, walletAddress: string): Promise<bigint>;
-export interface BscUsd1BalanceOptions {
+export interface FundingTokenBalanceOptions {
     rpcUrl?: string;
     tokenAddress?: string;
     decimals?: number;
+    /**
+     * Funding chain id (e.g. `"3131"` Tenderly BSC, `"56"` mainnet).
+     * When omitted, defaults to `3131` via {@link getChainInfo}.
+     */
+    chainId?: string | number | null;
+    /** Label for {@link Erc20BalanceResult.symbol} (default `"Funding"`). */
+    displaySymbol?: string;
 }
 /**
- * Convenience wrapper – fetches the USD1 balance on BSC for a given wallet.
- * All parameters have sensible defaults and can be overridden.
+ * Fetches the configured funding ERC-20 balance on the selected funding chain.
+ * Defaults: chain `3131`, RPC from {@link getChainInfo}, token from {@link getFundingTokenAddress} / env.
  */
-export declare function fetchBscUsd1Balance(walletAddress: string, options?: BscUsd1BalanceOptions): Promise<Erc20BalanceResult>;
+export declare function fetchFundingTokenBalance(walletAddress: string, options?: FundingTokenBalanceOptions): Promise<Erc20BalanceResult>;

package/dist/modules/balanceQuery.js

@@ -1,7 +1,6 @@
-import { testBsc, BSC_USD1_ADDRESS } from "../constants/chains.js";
+import { getEnv } from "../utils/env";
+import { getFundingTokenAddress, getChainInfo } from "../constants/chains.js";
 const ERC20_BALANCE_OF_SELECTOR = "0x70a08231";
-const USD1_DECIMALS = testBsc.nativeCurrencyDecimals;
-const BSC_RPC_URL = testBsc.rpcUrls[0];
 function padAddress(address) {
     return address.toLowerCase().replace("0x", "").padStart(64, "0");
 }
@@ -42,17 +41,20 @@ export async function fetchErc20Balance(rpcUrl, tokenAddress, walletAddress) {
     return BigInt(json.result ?? "0x0");
 }
 /**
- * Convenience wrapper – fetches the USD1 balance on BSC for a given wallet.
- * All parameters have sensible defaults and can be overridden.
+ * Fetches the configured funding ERC-20 balance on the selected funding chain.
+ * Defaults: chain `3131`, RPC from {@link getChainInfo}, token from {@link getFundingTokenAddress} / env.
  */
-export async function fetchBscUsd1Balance(walletAddress, options) {
-    const rpcUrl = options?.rpcUrl ?? BSC_RPC_URL;
-    const tokenAddress = options?.tokenAddress ?? BSC_USD1_ADDRESS;
-    const decimals = options?.decimals ?? USD1_DECIMALS;
+export async function fetchFundingTokenBalance(walletAddress, options) {
+    const chain = getChainInfo(options?.chainId);
+    const rpcUrl = options?.rpcUrl ?? chain.rpcUrls[0];
+    const tokenAddress = options?.tokenAddress ?? getFundingTokenAddress(options?.chainId);
+    const decimals = options?.decimals ?? chain.nativeCurrencyDecimals;
+    const FUNDING_TOKEN_SYMBOL = getEnv("FUNDING_TOKEN_SYMBOL");
+    const displaySymbol = options?.displaySymbol ?? (FUNDING_TOKEN_SYMBOL || "Funding");
     const raw = await fetchErc20Balance(rpcUrl, tokenAddress, walletAddress);
     return {
         raw,
         formatted: formatBalanceDisplay(raw, decimals),
-        symbol: "USD1",
+        symbol: displaySymbol,
     };
 }

package/dist/modules/deposit.js

@@ -1,4 +1,5 @@
 import { sessionStore } from "@ab-org/sdk-core";
+import { getEnv } from "../utils/env";
 function requireSession() {
     const session = sessionStore.getState().session;
     if (!session)
@@ -17,7 +18,7 @@ export const createDepositController = (custody, marketData) => {
             session.chainContext?.settlementChain ??
             session.chain ??
             "AB_CORE";
-        const token = config?.preferredToken ?? "USD1";
+        const token = config?.preferredToken || getEnv("FUNDING_TOKEN_SYMBOL") || "USDT";
         try {
             const { address } = await marketData.getDepositAddress(token, chain);
             const depositId = `${chain}:${token}:${Date.now()}`;

package/dist/modules/marketData.d.ts

@@ -3,6 +3,6 @@ import type { MarketDataProvider } from "../types.js";
  * Default `MarketDataProvider` backed by the merchant chains API.
  * - getSupportedTokens / getSupportedChains: from GET `{merchantBase}/chains`
  * - getQuote: local estimate until a dedicated quote API exists
- * - getDepositAddress: session wallet address + fixed minimum (no deposit-address HTTP API here)
+ * - getDepositAddress: 当前 session 钱包地址 + 与 `token`/`chain` 匹配的 `GET /chains` 中 `minimum_deposit`（按 decimals 格式化）
  */
 export declare function createMarketDataProvider(): MarketDataProvider;

package/dist/modules/marketData.js

@@ -1,45 +1,20 @@
 import { sessionStore } from "@ab-org/sdk-core";
-import { getEnv } from "../utils/env.js";
-const DEFAULT_MERCHANT_BASE_URL = "https://merchant.tomo.services";
+import { formatUnits } from "viem";
+import { getChains } from "./api.js";
 let cachedChains = null;
-/** Fallback when chains API fails (network error, 4xx/5xx, parse error, missing base URL). */
-const DEFAULT_CHAINS_FALLBACK = [
-    {
-        chain_id: "56",
-        network: "BSC",
-        tokens: [
-            { symbol: "USD1", address: "0x", decimals: 18 },
-            { symbol: "USDT", address: "0x", decimals: 6 },
-            { symbol: "USDC", address: "0x", decimals: 6 },
-        ],
-    },
-    {
-        chain_id: "ETH",
-        network: "Ethereum",
-        tokens: [
-            { symbol: "USDT", address: "0x", decimals: 6 },
-            { symbol: "USDC", address: "0x", decimals: 6 },
-        ],
-    },
-];
 async function fetchChainsFromApi() {
     if (cachedChains)
         return cachedChains;
     try {
-        const CHAINS_API_BASE = getEnv("MERCHANT_BASE_URL") || DEFAULT_MERCHANT_BASE_URL;
-        const res = await fetch(`${CHAINS_API_BASE}/chains`);
-        if (!res.ok)
-            throw new Error(`Chains API error: ${res.status} ${res.statusText}`);
-        const json = (await res.json());
-        const chains = json.data?.chains ?? [];
+        const { chains } = await getChains();
         if (chains.length > 0) {
             cachedChains = chains;
             return chains;
         }
-        return DEFAULT_CHAINS_FALLBACK;
+        return [];
     }
     catch {
-        return DEFAULT_CHAINS_FALLBACK;
+        return [];
     }
 }
 function chainToChainInfo(chain) {
@@ -48,6 +23,22 @@ function chainToChainInfo(chain) {
         name: chain.network,
     };
 }
+function findTokenInChains(chains, chainId, tokenSymbol) {
+    const chain = chains.find((c) => c.chain_id === chainId);
+    return chain?.tokens.find((t) => t.symbol === tokenSymbol);
+}
+/** `minimum_deposit` 为链上最小单位整数字符串，按 `decimals` 转成可读金额并拼 token 符号 */
+function formatMinimumDepositDisplay(token, tokenSymbol) {
+    const raw = token.minimum_deposit?.trim();
+    if (raw == null || raw === "")
+        return undefined;
+    try {
+        return `${formatUnits(BigInt(raw), token.decimals)} ${tokenSymbol}`;
+    }
+    catch {
+        return `${raw} ${tokenSymbol}`;
+    }
+}
 function deriveTokensFromChains(chains) {
     const bySymbol = new Map();
     for (const chain of chains) {
@@ -84,7 +75,7 @@ function computeDefaultQuote(request) {
  * Default `MarketDataProvider` backed by the merchant chains API.
  * - getSupportedTokens / getSupportedChains: from GET `{merchantBase}/chains`
  * - getQuote: local estimate until a dedicated quote API exists
- * - getDepositAddress: session wallet address + fixed minimum (no deposit-address HTTP API here)
+ * - getDepositAddress: 当前 session 钱包地址 + 与 `token`/`chain` 匹配的 `GET /chains` 中 `minimum_deposit`（按 decimals 格式化）
  */
 export function createMarketDataProvider() {
     return {
@@ -102,11 +93,14 @@ export function createMarketDataProvider() {
         async getQuote(request) {
             return computeDefaultQuote(request);
         },
-        async getDepositAddress(_token, _chain) {
+        async getDepositAddress(token, chain) {
             const session = sessionStore.getState().session;
+            const chains = await fetchChainsFromApi();
+            const meta = findTokenInChains(chains, chain, token);
+            const minimumDeposit = meta != null ? formatMinimumDepositDisplay(meta, token) : undefined;
             return {
                 address: session?.address ?? "",
-                minimumDeposit: "15.00",
+                minimumDeposit,
             };
         },
     };

package/dist/modules/withdraw.js

@@ -1,4 +1,5 @@
 import { sessionStore } from "@ab-org/sdk-core";
+import { getEnv } from "../utils/env";
 function requireSession() {
     const session = sessionStore.getState().session;
     if (!session)
@@ -13,7 +14,7 @@ export const createWithdrawController = (custody, marketData) => {
     };
     const open = async (config) => {
         const session = requireSession();
-        const token = config?.defaultToken ?? "USD1";
+        const token = config?.defaultToken || getEnv("FUNDING_TOKEN_SYMBOL") || "USDT";
         const chain = config?.defaultChain ??
             session.chainContext?.settlementChain ??
             session.chain ??

package/dist/modules/withdrawDirect.d.ts

@@ -0,0 +1,14 @@
+import type { ChainData, TokenData } from "./api.js";
+/**
+ * funding 链（与 {@link DEFAULT_FUNDING_CHAIN_ID} 一致）上，且 `tokenAddress` 在 Merchant `GET /chains`
+ * 中对应条目的 `is_usd_stable === true` 时，由业务层自行完成提现并构造 `withdrawDirectResult`；
+ * 其余情况走默认 funding 提现执行器与订单轮询。
+ */
+export declare function isUsdtWithdrawDirect(chainId: string, tokenAddress: string, chains: ChainData[]): boolean;
+/**
+ * 从 `getChains()` 返回的 `chains` 中，按当前选择的链 id + token symbol 或合约地址解析 `TokenData`。
+ */
+export declare function findTokenDataFromChains(chains: ChainData[], chainId: string, opts: {
+    symbol: string;
+    tokenAddress?: string;
+}): TokenData | undefined;

package/dist/modules/withdrawDirect.js

@@ -0,0 +1,33 @@
+import { DEFAULT_FUNDING_CHAIN_ID } from "../constants/chains.js";
+/**
+ * funding 链（与 {@link DEFAULT_FUNDING_CHAIN_ID} 一致）上，且 `tokenAddress` 在 Merchant `GET /chains`
+ * 中对应条目的 `is_usd_stable === true` 时，由业务层自行完成提现并构造 `withdrawDirectResult`；
+ * 其余情况走默认 funding 提现执行器与订单轮询。
+ */
+export function isUsdtWithdrawDirect(chainId, tokenAddress, chains) {
+    if (chainId !== String(DEFAULT_FUNDING_CHAIN_ID))
+        return false;
+    const addr = tokenAddress.trim();
+    if (!addr)
+        return false;
+    const chain = chains.find((c) => c.chain_id === chainId);
+    const token = chain?.tokens.find((t) => t.address.toLowerCase() === addr.toLowerCase());
+    return token?.is_usd_stable === true;
+}
+/**
+ * 从 `getChains()` 返回的 `chains` 中，按当前选择的链 id + token symbol 或合约地址解析 `TokenData`。
+ */
+export function findTokenDataFromChains(chains, chainId, opts) {
+    const chain = chains.find((c) => c.chain_id === chainId);
+    if (!chain?.tokens.length)
+        return undefined;
+    const sym = opts.symbol.trim();
+    const addr = opts.tokenAddress?.trim().toLowerCase();
+    return chain.tokens.find((t) => {
+        if (addr && t.address.toLowerCase() === addr)
+            return true;
+        if (sym.length > 0 && t.symbol === sym)
+            return true;
+        return false;
+    });
+}

package/dist/modules/withdrawExecutor.d.ts

@@ -9,7 +9,7 @@ export interface WithdrawRequest {
     chain: string;
 }
 export interface WithdrawResult {
-    /** BSC 上转入一次性地址的 funding tx hash */
+    /** Funding 链上转入一次性地址的 tx hash */
     txHash: string;
     /** 提现订单 ID，用于轮询 getWithdrawOrder(orderId) */
     orderId: string;
@@ -30,18 +30,27 @@ export type WithdrawExecutor = (request: WithdrawRequest) => Promise<WithdrawRes
  *   "100.1" → 100100000000000000000n
  */
 export declare function parseUnits(value: string, decimals: number): bigint;
-export interface BscUsd1WithdrawExecutorOptions {
-    /** 源代币 USD1 合约地址（提现场景下为 BSC 上的 USD1） */
+export interface FundingWithdrawExecutorOptions {
+    /** 源链 funding ERC-20 合约地址；默认 {@link getFundingTokenAddress} / env */
     tokenAddress?: string;
     decimals?: number;
-    chainId?: number;
+    /**
+     * Funding EVM chain id（如 `3131` Tenderly、`56` 主网）。未传时默认 `3131`。
+     */
+    chainId?: number | string;
+    /** 覆盖 {@link getChainInfo} 提供的 JSON-RPC URL */
+    rpcUrl?: string;
     /** 系统配置的单笔限额（wei 字符串），若提供则校验 request.amount 不得超过此值 */
     maxAmountWei?: string;
+    /**
+     * 与商户订单接口约定的 funding 侧 token symbol（默认 `USDT`，按后端协议）。
+     */
+    fundingLegTokenSymbol?: string;
 }
 /**
  * Factory that returns a `WithdrawExecutor` implementing the flow in withdraw.md:
  * 1) Create NATIVE_SWAP order → get one-time wallet address (OTW);
- * 2) Sign ERC-20 transfer of USD1 on BSC to the OTW (not to user);
+ * 2) Sign ERC-20 transfer of the funding token on the funding chain to the OTW (not to user);
  * 3) Broadcast tx and return { txHash, orderId } for the client to poll getWithdrawOrder(orderId).
  */
-export declare function createBscUsd1WithdrawExecutor(options?: BscUsd1WithdrawExecutorOptions): WithdrawExecutor;
+export declare function createFundingWithdrawExecutor(options?: FundingWithdrawExecutorOptions): WithdrawExecutor;

package/dist/modules/withdrawExecutor.js

@@ -2,12 +2,11 @@ import { sessionStore } from "@ab-org/sdk-core";
 import { tryAutoReconnect } from "../auth/autoReconnect.js";
 import { getChains, createOrder } from "./api.js";
 import { fromHex, parseGwei, toHex } from "viem";
-import { testBsc, BSC_USD1_ADDRESS } from "../constants/chains.js";
+import { getFundingTokenAddress, getChainInfo } from "../constants/chains.js";
+import { getEnv } from "../utils/env";
 const MAX_WITHDRAW_GAS_LIMIT = 500000n;
-const BSC_RPC_URL = testBsc.rpcUrls[0];
 /* ─── Internal helpers ────────────────────────── */
 const ERC20_TRANSFER_SELECTOR = "0xa9059cbb";
-const USD1_DECIMALS = testBsc.nativeCurrencyDecimals;
 function padHex256(value) {
     return value.toString(16).padStart(64, "0");
 }
@@ -82,13 +81,13 @@ async function requestHexQuantity(provider, rpcUrl, method, params) {
         return toHexQuantity(await callRpc(rpcUrl, method, params));
     }
 }
-async function ensureBscChain(provider, chainId) {
+async function ensureFundingEvmChain(provider, chainId) {
     const hex = `0x${chainId.toString(16)}`;
     try {
         await provider.request({ method: "wallet_switchEthereumChain", params: [{ chainId: hex }] });
     }
     catch {
-        // Ignored – the wallet may already be on BSC or may not support switching.
+        // Ignored – the wallet may already be on the funding chain or may not support switching.
     }
 }
 function getDstTokenAddress(chains, chainId, tokenSymbol) {
@@ -98,14 +97,17 @@ function getDstTokenAddress(chains, chainId, tokenSymbol) {
 /**
  * Factory that returns a `WithdrawExecutor` implementing the flow in withdraw.md:
  * 1) Create NATIVE_SWAP order → get one-time wallet address (OTW);
- * 2) Sign ERC-20 transfer of USD1 on BSC to the OTW (not to user);
+ * 2) Sign ERC-20 transfer of the funding token on the funding chain to the OTW (not to user);
  * 3) Broadcast tx and return { txHash, orderId } for the client to poll getWithdrawOrder(orderId).
  */
-export function createBscUsd1WithdrawExecutor(options) {
-    const tokenAddress = options?.tokenAddress ?? BSC_USD1_ADDRESS;
-    const decimals = options?.decimals ?? USD1_DECIMALS;
+export function createFundingWithdrawExecutor(options) {
+    const fundingChain = getChainInfo(options?.chainId);
+    const chainIdNum = Number(fundingChain.chainId);
+    const rpcUrl = options?.rpcUrl ?? fundingChain.rpcUrls[0];
+    const tokenAddress = options?.tokenAddress ?? getFundingTokenAddress(options?.chainId);
+    const decimals = options?.decimals ?? fundingChain.nativeCurrencyDecimals;
     const maxAmountWei = options?.maxAmountWei;
-    const chainId = options?.chainId ?? Number(testBsc.chainId);
+    const fundingLegTokenSymbol = options?.fundingLegTokenSymbol || getEnv("FUNDING_TOKEN_SYMBOL") || "USDT";
     return async (request) => {
         const amountWei = parseUnits(request.amount, decimals);
         const amountWeiStr = amountWei.toString();
@@ -139,13 +141,13 @@ export function createBscUsd1WithdrawExecutor(options) {
         if (!dstTokenAddress) {
             throw new Error(`Unsupported token ${request.token} on chain ${request.chain}`);
         }
-        // 校验规则：源代币或目标代币中必须有一个是 USD1。提现场景下源代币（token_address）为 USD1；token_amount 已按 maxAmountWei 做单笔限额校验
-        const sourceTokenSymbol = "USD1";
+        // 校验规则：源/目标代币需满足商户约定；提现场景下源链为 funding token；token_amount 已按 maxAmountWei 做单笔限额校验
+        const sourceTokenSymbol = fundingLegTokenSymbol;
         const orderRes = await createOrder({
             intent_id: `withdraw-${Date.now()}`,
             order_type: "NATIVE_SWAP",
             order_payload: {
-                chain_id: String(chainId),
+                chain_id: fundingChain.chainId,
                 token_address: tokenAddress,
                 token_amount: amountWeiStr,
                 dst_chain_id: request.chain,
@@ -158,7 +160,7 @@ export function createBscUsd1WithdrawExecutor(options) {
                     token_amount: amountWeiStr,
                     token_address: tokenAddress,
                     user_address: session.address,
-                    chain_id: String(chainId),
+                    chain_id: fundingChain.chainId,
                 },
             ],
         });
@@ -166,18 +168,18 @@ export function createBscUsd1WithdrawExecutor(options) {
         if (!oneTimeAddress) {
             throw new Error("Order created but no one-time wallet address returned");
         }
-        await ensureBscChain(provider, chainId);
+        await ensureFundingEvmChain(provider, chainIdNum);
         const data = encodeTransferData(oneTimeAddress, amountWei);
-        const nonce = await requestHexQuantity(provider, BSC_RPC_URL, "eth_getTransactionCount", [session.address, "latest"]);
+        const nonce = await requestHexQuantity(provider, rpcUrl, "eth_getTransactionCount", [session.address, "latest"]);
         const tx = {
             from: session.address,
             to: tokenAddress,
             value: "0x0",
             nonce,
             data,
-            chainId: toHex(chainId),
+            chainId: toHex(chainIdNum),
         };
-        const estimatedGasHex = await requestHexQuantity(provider, BSC_RPC_URL, "eth_estimateGas", [tx]);
+        const estimatedGasHex = await requestHexQuantity(provider, rpcUrl, "eth_estimateGas", [tx]);
         const estimatedGas = fromHex(estimatedGasHex, "bigint");
         const gas = toHex(estimatedGas > MAX_WITHDRAW_GAS_LIMIT ? MAX_WITHDRAW_GAS_LIMIT : estimatedGas);
         const transaction = {
@@ -201,8 +203,8 @@ export function createBscUsd1WithdrawExecutor(options) {
                 method: "eth_signTransaction",
                 params: [transaction],
             });
-            txHash = await callRpc(BSC_RPC_URL, "eth_sendRawTransaction", [signedTx]);
+            txHash = await callRpc(rpcUrl, "eth_sendRawTransaction", [signedTx]);
         }
-        return { txHash, orderId: orderRes.order_id, fundingChainId: String(chainId) };
+        return { txHash, orderId: orderRes.order_id, fundingChainId: fundingChain.chainId };
     };
 }

package/dist/ui/DepositModal.d.ts

@@ -27,7 +27,7 @@ export interface DepositModalProps {
     explorerTxUrl?: (chainId: string, txHash: string) => string;
     onTokenSelect?: (id: string) => void;
     onChainSelect?: (id: string) => void;
-    onCopyAddress?: () => void;
+    onCopyAddress?: (address: string) => void;
     onBuyCrypto?: () => void;
     onSignIn?: () => void;
     onBack?: () => void;