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

package/dist/auth/walletAccount.js

@@ -1,267 +0,0 @@
-import { EvmSigner } from "@cubist-labs/cubesigner-sdk";
-import { CubeSignerAuth, createChainContext, createSessionCapabilityPolicy, } from "@ab-org/sdk-core";
-const cubistCapabilities = [
-    "eth_accounts",
-    "eth_requestAccounts",
-    "eth_chainId",
-    "eth_signTransaction",
-    "personal_sign",
-    "eth_signTypedData_v4",
-    "wallet_disconnect",
-];
-const evmChainIdMap = {
-    ETH: 1,
-    BSC: 56,
-};
-const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-const toBigIntQuantity = (value) => {
-    if (typeof value === "bigint")
-        return value;
-    if (typeof value === "number") {
-        if (!Number.isInteger(value) || value < 0) {
-            throw new Error(`Invalid EVM quantity number: ${value}`);
-        }
-        return BigInt(value);
-    }
-    const trimmed = value.trim();
-    if (!trimmed) {
-        throw new Error("EVM quantity cannot be empty");
-    }
-    if (/^0x[0-9a-fA-F]+$/.test(trimmed) || /^\d+$/.test(trimmed)) {
-        return BigInt(trimmed);
-    }
-    throw new Error(`Invalid EVM quantity string: ${value}`);
-};
-const toHexQuantity = (value) => {
-    if (value === undefined)
-        return undefined;
-    return `0x${toBigIntQuantity(value).toString(16)}`;
-};
-const normalizeAccessList = (accessList) => {
-    if (!accessList)
-        return undefined;
-    return accessList.map((item) => ({
-        address: item.address,
-        storageKeys: item.storageKeys,
-    }));
-};
-const textEncoder = new TextEncoder();
-const resolveTransactionType = (transaction) => {
-    if (transaction.type !== undefined) {
-        const normalized = toHexQuantity(transaction.type);
-        if (normalized === "0x0" || normalized === "0x1" || normalized === "0x2") {
-            return normalized;
-        }
-        throw new Error(`Unsupported EVM transaction type for Cubist: ${normalized}`);
-    }
-    if (transaction.maxFeePerGas !== undefined || transaction.maxPriorityFeePerGas !== undefined) {
-        return "0x2";
-    }
-    if (transaction.accessList?.length) {
-        return "0x1";
-    }
-    return "0x0";
-};
-const toCubistSignRequest = (address, chain, transaction) => {
-    const resolvedChainId = (transaction.chainId !== undefined ? Number(toBigIntQuantity(transaction.chainId)) : undefined) ??
-        evmChainIdMap[chain];
-    if (!resolvedChainId) {
-        throw new Error("Cubist signing requires an EVM chainId");
-    }
-    const type = resolveTransactionType(transaction);
-    const commonFields = {
-        from: transaction.from ?? address,
-        to: transaction.to,
-        data: transaction.data,
-        gas: toHexQuantity(transaction.gas),
-        nonce: toHexQuantity(transaction.nonce),
-        value: toHexQuantity(transaction.value),
-    };
-    const accessList = normalizeAccessList(transaction.accessList);
-    const tx = type === "0x2"
-        ? {
-            ...commonFields,
-            type,
-            ...(accessList ? { accessList } : {}),
-            maxFeePerGas: toHexQuantity(transaction.maxFeePerGas),
-            maxPriorityFeePerGas: toHexQuantity(transaction.maxPriorityFeePerGas),
-        }
-        : type === "0x1"
-            ? {
-                ...commonFields,
-                type,
-                ...(accessList ? { accessList } : {}),
-                gasPrice: toHexQuantity(transaction.gasPrice),
-            }
-            : {
-                ...commonFields,
-                type,
-                gasPrice: toHexQuantity(transaction.gasPrice),
-            };
-    return {
-        chain_id: resolvedChainId,
-        tx,
-    };
-};
-const getTransactionParam = (params) => {
-    const candidate = params?.[0];
-    if (!isRecord(candidate)) {
-        throw new Error("eth_signTransaction requires a transaction object");
-    }
-    return candidate;
-};
-const toHexBytes = (value) => {
-    if (/^0x[0-9a-fA-F]*$/.test(value))
-        return value;
-    return `0x${Array.from(textEncoder.encode(value))
-        .map((byte) => byte.toString(16).padStart(2, "0"))
-        .join("")}`;
-};
-const getMessageParam = (address, params) => {
-    const [first, second] = params ?? [];
-    if (typeof second === "string" && second.toLowerCase() === address.toLowerCase()) {
-        return String(first ?? "");
-    }
-    if (typeof first === "string" && first.toLowerCase() === address.toLowerCase()) {
-        return String(second ?? "");
-    }
-    return String(first ?? "");
-};
-const getTypedDataParam = (address, params) => {
-    const [first, second] = params ?? [];
-    if (typeof first === "string" && first.toLowerCase() === address.toLowerCase()) {
-        return typeof second === "string"
-            ? JSON.parse(second)
-            : (second ?? {});
-    }
-    return typeof second === "string"
-        ? JSON.parse(second)
-        : (second ?? first ?? {});
-};
-function createEmbeddedProvider({ session, address, chain, }) {
-    const signer = new EvmSigner(address, session.client);
-    return {
-        async request(payload) {
-            switch (payload.method) {
-                case "eth_accounts":
-                case "eth_requestAccounts":
-                    return [address];
-                case "eth_chainId": {
-                    const chainId = evmChainIdMap[chain];
-                    if (!chainId) {
-                        throw new Error(`CubistProvider: chain ${chain} does not expose an EVM chainId`);
-                    }
-                    return `0x${chainId.toString(16)}`;
-                }
-                case "eth_signTransaction": {
-                    const transaction = getTransactionParam(payload.params);
-                    const signRequest = toCubistSignRequest(address, chain, transaction);
-                    return (await signer.signTransaction(signRequest));
-                }
-                case "personal_sign": {
-                    const message = getMessageParam(address, payload.params);
-                    return (await signer.signEip191({ data: toHexBytes(message) }));
-                }
-                case "eth_signTypedData_v4": {
-                    const typedData = getTypedDataParam(address, payload.params);
-                    const domain = typedData.domain;
-                    const chainId = domain?.chainId !== undefined
-                        ? Number(toBigIntQuantity(domain.chainId))
-                        : evmChainIdMap[chain];
-                    if (!chainId) {
-                        throw new Error("CubistProvider: typed data signing requires an EVM chainId");
-                    }
-                    return (await signer.signEip712({
-                        chain_id: chainId,
-                        typed_data: typedData,
-                    }));
-                }
-                default:
-                    throw new Error(`CubistProvider: unsupported RPC method "${payload.method}"`);
-            }
-        },
-        async disconnect() {
-            await session.client.revokeSession();
-        },
-    };
-}
-export class EmbeddedWalletAccountProvider {
-    constructor(provider) {
-        this.provider = provider;
-    }
-    async request(payload) {
-        return this.provider.request(payload);
-    }
-    async disconnect() {
-        await this.provider.disconnect();
-    }
-    async eth_accounts() {
-        return this.request({ method: "eth_accounts" });
-    }
-    async eth_chainId() {
-        return this.request({ method: "eth_chainId" });
-    }
-}
-class WalletAccount {
-    static clearInstance() {
-        WalletAccount.instance = null;
-        WalletAccount.instanceToken = null;
-        WalletAccount.walletSession = null;
-        WalletAccount.cubeSignerSession = null;
-    }
-    static getWalletSession() {
-        return WalletAccount.walletSession;
-    }
-    static getCubeSignerSession() {
-        return WalletAccount.cubeSignerSession;
-    }
-    static async getInstance(oidcToken, authSource, cubeSignerConfig) {
-        if (WalletAccount.instance && WalletAccount.instanceToken === oidcToken) {
-            return WalletAccount.instance;
-        }
-        WalletAccount.clearInstance();
-        const auth = new CubeSignerAuth(cubeSignerConfig);
-        const cubeSignerSession = await auth.loginWithGoogle(oidcToken);
-        const keys = await cubeSignerSession.client.sessionKeys();
-        const evmKey = keys.find((key) => key.cached.key_type === "SecpEthAddr");
-        if (!evmKey) {
-            throw new Error("No EVM key found in CubeSigner session");
-        }
-        const address = evmKey.materialId;
-        const chain = "BSC";
-        const provider = createEmbeddedProvider({
-            session: cubeSignerSession,
-            address,
-            chain,
-        });
-        const wrappedProvider = new EmbeddedWalletAccountProvider(provider);
-        const capabilityPolicy = auth.defaultSessionPolicy
-            ? createSessionCapabilityPolicy(auth.defaultSessionPolicy)
-            : undefined;
-        WalletAccount.instance = wrappedProvider;
-        WalletAccount.instanceToken = oidcToken;
-        WalletAccount.cubeSignerSession = cubeSignerSession;
-        WalletAccount.walletSession = {
-            address,
-            chain,
-            provider: wrappedProvider,
-            walletType: "social",
-            authSource,
-            sessionId: `${authSource}:${address.toLowerCase()}`,
-            expiresAt: capabilityPolicy?.expiresAt,
-            capabilities: [...cubistCapabilities],
-            sessionData: cubeSignerSession.sessionData,
-            chainContext: createChainContext(chain),
-            capabilityPolicy,
-        };
-        return wrappedProvider;
-    }
-}
-WalletAccount.instance = null;
-WalletAccount.instanceToken = null;
-WalletAccount.walletSession = null;
-WalletAccount.cubeSignerSession = null;
-export default WalletAccount;
-export function clearSocialAccountInstance() {
-    WalletAccount.clearInstance();
-}

package/dist/constants/chains.d.ts

@@ -1,2 +0,0 @@
-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,3 +0,0 @@
-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/modules/api.d.ts

@@ -1,149 +0,0 @@
-/**
- * Merchant API client
- * 基于 axios 封装，类型与文档一致。
- */
-import { type AxiosInstance } from "axios";
-/** 通用 API 响应：所有接口统一格式 */
-export interface ApiResponse<T> {
-    data: T | null;
-    code: number;
-    msg: string;
-    timestamp: number;
-}
-export interface TokenData {
-    symbol: string;
-    address: string;
-    decimals: number;
-    /** 最小充值量（最小单位字符串，如 `"15000000"`） */
-    minimum_deposit?: string;
-    /** 是否为 USD 类稳定币 */
-    is_usd_stable?: boolean;
-}
-export interface ChainData {
-    chain_id: string;
-    network: string;
-    tokens: TokenData[];
-}
-export interface ChainsResponseData {
-    chains: ChainData[];
-    is_testnet: boolean;
-}
-export interface PlatformRegisterRequest {
-    platform_contract_address: string;
-    chain_id: string;
-}
-export interface PlatformRegisterResponseData {
-    deposit_address: string;
-    chain_id: string;
-}
-export type QuoteDirection = "deposit" | "withdraw";
-interface QuoteRequest {
-    direction: QuoteDirection;
-    chain_id: string;
-    token_address: string;
-    token_amount?: string;
-    dst_token_amount?: string;
-}
-export interface QuoteResponseData {
-    token_address: string;
-    token_symbol: string;
-    token_decimals: number;
-    rate: string;
-    chain_id: number;
-    deposit_address?: string;
-    dst_token_amount?: string;
-    token_amount?: string;
-    expires_at?: string;
-}
-export type DepositOrderStatus = "received" | "processing" | "completed" | "failed" | "funded";
-export interface DepositOrderResponseData {
-    order_id: string;
-    status: DepositOrderStatus;
-    source_chain_id: string;
-    token_address: string;
-    token_amount?: string;
-    dst_token_amount?: string;
-    deposit_address?: string;
-    source_tx_hash?: string;
-    created_at?: string;
-    updated_at?: string;
-}
-export type WithdrawOrderStatus = "pending" | "funded" | "processing" | "completed" | "failed" | "expired";
-export interface WithdrawOrderResponseData {
-    order_id: string;
-    status: WithdrawOrderStatus;
-    one_time_address?: string;
-    chain_id: string;
-    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;
-    funding_tx_hash?: string;
-    dst_tx_hash?: string;
-    out_tx_hash?: string;
-    created_at?: string;
-    updated_at?: string;
-}
-export interface NativeSwapPayload {
-    chain_id: string;
-    token_address: string;
-    token_amount: string;
-    dst_chain_id: string;
-    dst_token_address: string;
-    recipient: string;
-}
-export interface PaymentPairData {
-    token_symbol: string;
-    token_amount: string;
-    token_address: string;
-    user_address: string;
-    chain_id: string;
-}
-export interface CreateOrderRequest {
-    intent_id: string;
-    order_type: "NATIVE_SWAP";
-    order_payload: NativeSwapPayload;
-    payment_pairs: PaymentPairData[];
-}
-export type PaymentSessionStatus = "CREATED" | "PENDING" | "FUNDED" | "CANCELED" | "CAPTURING" | "SUCCEED";
-export interface PaymentSessionResponseData {
-    payment_session_id: string;
-    created_at?: string;
-    status: PaymentSessionStatus;
-    one_time_wallet_address: string;
-    amount: string;
-    currency: string;
-    user_address?: string;
-    network?: string;
-    token_symbol?: string;
-    chain_id?: string;
-    funding_transaction_hash?: string | null;
-    capturable_amount?: string;
-    captured_amount?: string;
-}
-export interface CreateOrderResponseData {
-    order_id: string;
-    payment_sessions: PaymentSessionResponseData[];
-}
-/**
- * 配置 Merchant API 的 baseURL
- */
-export declare function configureMerchantApi(): void;
-/**
- * 获取当前 axios 实例（用于自定义请求）
- */
-export declare function getMerchantApiClient(): AxiosInstance;
-/** GET /chains - 查询支持的链和代币列表 */
-export declare function getChains(): Promise<ChainsResponseData>;
-/** POST /api/v1/platform - 注册平台合约并获取充值地址 */
-export declare function registerPlatform(body: PlatformRegisterRequest): Promise<PlatformRegisterResponseData>;
-/** POST /api/v1/quote - 统一报价（充值/提现） */
-export declare function quote(body: QuoteRequest): Promise<QuoteResponseData>;
-/** GET /api/v1/orders/deposit/{order_id} - 查询充值订单状态 */
-export declare function getDepositOrder(orderId: string): Promise<DepositOrderResponseData>;
-/** GET /api/v1/orders/withdraw/{order_id} - 查询提现订单状态 */
-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,95 +0,0 @@
-/**
- * Merchant API client
- * 基于 axios 封装，类型与文档一致。
- */
-import { getEnv } from "../utils/env.js";
-import axios from "axios";
-// ─── Axios 实例与请求封装 ─────────────────────────────────────────────────────
-function createClient() {
-    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,
-        headers: { "Content-Type": "application/json" },
-    });
-}
-/** 解析通用响应并抛出业务错误 */
-function unwrap(res) {
-    if (res.code !== 0 || res.data === null) {
-        throw new Error(res.msg || "API error");
-    }
-    return res.data;
-}
-// 单例 client，可通过 configureMerchantApi 修改 baseURL
-let apiClient = createClient();
-/**
- * 配置 Merchant API 的 baseURL
- */
-export function configureMerchantApi() {
-    apiClient = createClient();
-}
-/**
- * 获取当前 axios 实例（用于自定义请求）
- */
-export function getMerchantApiClient() {
-    return apiClient;
-}
-// ─── 接口方法（均 try-catch，失败时返回 mock）──────────────────────────────────
-/** GET /chains - 查询支持的链和代币列表 */
-export async function getChains() {
-    try {
-        const { data } = await apiClient.get("/chains");
-        return unwrap(data);
-    }
-    catch {
-        throw new Error('Failed to get chains');
-    }
-}
-/** POST /api/v1/platform - 注册平台合约并获取充值地址 */
-export async function registerPlatform(body) {
-    try {
-        const { data } = await apiClient.post("/api/v1/platform", body);
-        return unwrap(data);
-    }
-    catch {
-        throw new Error('Failed to register platform');
-    }
-}
-/** POST /api/v1/quote - 统一报价（充值/提现） */
-export async function quote(body) {
-    const { data } = await apiClient.post("/api/v1/quote", body);
-    return unwrap(data);
-}
-/** GET /api/v1/orders/deposit/{order_id} - 查询充值订单状态 */
-export async function getDepositOrder(orderId) {
-    try {
-        const { data } = await apiClient.get(`/api/v1/orders/deposit/${encodeURIComponent(orderId)}`);
-        return unwrap(data);
-    }
-    catch {
-        throw new Error('Failed to get deposit order');
-    }
-}
-/** GET /api/v1/orders/withdraw/{order_id} - 查询提现订单状态 */
-export async function getWithdrawOrder(orderId) {
-    try {
-        const { data } = await apiClient.get(`/api/v1/orders/withdraw/${encodeURIComponent(orderId)}`);
-        return unwrap(data);
-    }
-    catch {
-        throw new Error('Failed to get withdraw order');
-    }
-}
-/** POST /order - 创建 NATIVE_SWAP 提现订单 */
-export async function createOrder(body) {
-    try {
-        const { data } = await apiClient.post("/order", body);
-        return unwrap(data);
-    }
-    catch {
-        throw new Error('Failed to create order');
-    }
-}

package/dist/modules/balanceQuery.d.ts

@@ -1,27 +0,0 @@
-export interface Erc20BalanceResult {
-    raw: bigint;
-    formatted: string;
-    symbol: string;
-}
-/**
- * Query any ERC-20 token balance via a raw JSON-RPC `eth_call`.
- * No external library dependency – uses the global `fetch`.
- */
-export declare function fetchErc20Balance(rpcUrl: string, tokenAddress: string, walletAddress: string): Promise<bigint>;
-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;
-}
-/**
- * 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 fetchFundingTokenBalance(walletAddress: string, options?: FundingTokenBalanceOptions): Promise<Erc20BalanceResult>;

package/dist/modules/balanceQuery.js

@@ -1,60 +0,0 @@
-import { getEnv } from "../utils/env";
-import { getFundingTokenAddress, getChainInfo } from "../constants/chains.js";
-const ERC20_BALANCE_OF_SELECTOR = "0x70a08231";
-function padAddress(address) {
-    return address.toLowerCase().replace("0x", "").padStart(64, "0");
-}
-function formatUnits(value, decimals) {
-    const divisor = 10n ** BigInt(decimals);
-    const intPart = value / divisor;
-    const fracPart = value % divisor;
-    if (fracPart === 0n)
-        return intPart.toString();
-    const fracStr = fracPart.toString().padStart(decimals, "0").replace(/0+$/, "");
-    return `${intPart}.${fracStr}`;
-}
-/** 格式化为显示用 balance，保留小数点后 2 位 */
-function formatBalanceDisplay(value, decimals) {
-    const full = formatUnits(value, decimals);
-    const n = Number(full);
-    return Number.isNaN(n) ? full : n.toFixed(2);
-}
-/**
- * Query any ERC-20 token balance via a raw JSON-RPC `eth_call`.
- * No external library dependency – uses the global `fetch`.
- */
-export async function fetchErc20Balance(rpcUrl, tokenAddress, walletAddress) {
-    const data = `${ERC20_BALANCE_OF_SELECTOR}${padAddress(walletAddress)}`;
-    const response = await fetch(rpcUrl, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-            jsonrpc: "2.0",
-            id: 1,
-            method: "eth_call",
-            params: [{ to: tokenAddress, data }, "latest"],
-        }),
-    });
-    const json = (await response.json());
-    if (json.error)
-        throw new Error(json.error.message ?? "RPC error");
-    return BigInt(json.result ?? "0x0");
-}
-/**
- * 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 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: displaySymbol,
-    };
-}

package/dist/modules/deposit.d.ts

@@ -1,31 +0,0 @@
-import type { ChainInfo, CustodyAdapter, DepositAddressResult, MarketDataProvider, ModalController, QuoteResult, TokenInfo } from "../types.js";
-export interface DepositModalConfig {
-    preferredToken?: string;
-    preferredChain?: string;
-    onStatusChange?: (status: DepositStatus) => void;
-}
-export type DepositStatus = {
-    phase: "idle";
-} | {
-    phase: "address-issued";
-    depositId: string;
-    address: string;
-} | {
-    phase: "confirming";
-    depositId: string;
-} | {
-    phase: "settled";
-    depositId: string;
-    txHash?: string;
-} | {
-    phase: "failed";
-    reason: string;
-};
-export interface DepositController extends ModalController<DepositModalConfig> {
-    readonly status: DepositStatus;
-    fetchTokens(): Promise<TokenInfo[]>;
-    fetchChains(token: string): Promise<ChainInfo[]>;
-    fetchQuote(token: string, chain: string, amount: string): Promise<QuoteResult>;
-    fetchDepositAddress(token: string, chain: string): Promise<DepositAddressResult>;
-}
-export declare const createDepositController: (custody: CustodyAdapter, marketData: MarketDataProvider) => DepositController;