@keelcodes/sdk 0.0.0-stage → 2.0.0

package/dist/wallet.d.ts

@@ -0,0 +1,490 @@
+import { HttpClient } from './http';
+export type WalletType = 'waas' | 'mpc' | 'safe' | 'aa';
+export interface CreateWalletParams {
+    type: WalletType;
+    chain?: string;
+    /** 幂等键（同 reference 不重复建钱包）。 */
+    reference?: string;
+}
+export interface ImportWalletParams {
+    type: WalletType;
+    seed?: string;
+    privateKey?: string;
+}
+export interface WalletCreated {
+    walletId: string;
+    address: string;
+}
+export interface SignParams {
+    walletId: string;
+    message?: string;
+    typedData?: Record<string, unknown>;
+    digest?: string;
+    chain?: string;
+}
+export interface SignResult {
+    signature: string;
+    address: string;
+}
+export interface SendParams {
+    walletId: string;
+    to: string;
+    amount: string;
+    chain: string;
+    tokenAddress?: string;
+    /** 幂等键（防重复转账）。 */
+    reference?: string;
+}
+export interface SendResult {
+    txHash: string;
+    status: string;
+}
+export interface ChainParams {
+    chain: string;
+    method: string;
+    params?: unknown[];
+    rawTransaction?: string;
+}
+export interface ChainResult {
+    result?: unknown;
+    txHash?: string;
+}
+export interface WalletBalanceParams {
+    address: string;
+    chain?: string;
+    token?: string;
+}
+export interface WalletChainBalance {
+    chain: string;
+    address: string;
+    balances: Array<{
+        token: string;
+        token_address: string;
+        /** 人类可读金额：EVM 为原生币小数（18 位），Solana 为 SOL 小数（9 位） */
+        balance: string;
+        /** 仅 Solana：原始 lamports（十进制字符串） */
+        balance_lamports?: string;
+        usd_value: string;
+    }>;
+    usdTotal: string;
+    error?: string;
+}
+export interface WalletBalanceResult {
+    chainBalances: WalletChainBalance[];
+    totalUsd: string;
+}
+export interface SolanaDeriveAccountParams {
+    chain: string;
+    accountIndex: string | number;
+    smartAccountIndex?: string | number;
+}
+export interface SolanaDerivedAccount {
+    chain: string;
+    accountIndex: string;
+    smartAccountIndex: number;
+    settingsPda: string;
+    smartAccountPda: string;
+}
+export interface SolanaCreateAccountParams {
+    chain: string;
+    blockhash: string;
+    treasury: string;
+    creator: string;
+    settingsPda: string;
+    signers: Array<Record<string, unknown>>;
+    settingsAuthority?: string;
+    threshold?: number;
+    timeLock?: number;
+    rentCollector?: string;
+    memo?: string;
+}
+export interface SolanaInstallPolicyParams {
+    chain: string;
+    blockhash: string;
+    feePayer: string;
+    creator: string;
+    settingsPda: string;
+    transactionIndex: string | number;
+    signer: Record<string, unknown>;
+    /** 旧口径 `SettingsAction::AddSpendingLimit`（已 deprecated） */
+    spendingLimit?: Record<string, unknown>;
+    /** 新口径 `SettingsAction::PolicyCreate`（spending limit policy） */
+    spendingLimitPolicy?: SolanaSpendingLimitPolicy;
+}
+/** 新口径 spending limit policy（`PolicyCreate`；金额/seed 为十进制整数，可用字符串）。 */
+export interface SolanaSpendingLimitPolicy {
+    seed: string | number;
+    mint: string;
+    sourceAccountIndex?: number;
+    amount: string | number;
+    maxPerUse?: string | number;
+    /** 旧 `Period` 枚举值（0=OneTime / 1=Day / 2=Week / 3=Month） */
+    period?: number;
+    start?: string | number;
+    expiration?: string | number;
+    accumulateUnused?: boolean;
+    enforceExactQuantity?: boolean;
+    destinations?: string[];
+    signers: Array<Record<string, unknown>>;
+    threshold?: number;
+    timeLock?: number;
+}
+export interface SolanaCreatePolicyTransactionParams {
+    chain: string;
+    blockhash: string;
+    feePayer: string;
+    /** policy PDA */
+    policy: string;
+    transactionIndex: string | number;
+    creator: string;
+    rentPayer?: string;
+    accountIndex?: number;
+    amount: string | number;
+    destination: string;
+    decimals: number;
+}
+export interface SolanaCreateProposalParams {
+    chain: string;
+    blockhash: string;
+    feePayer: string;
+    /** 共识账户：settings PDA（settings 交易）或 policy PDA（policy 交易） */
+    settingsPda: string;
+    transactionIndex: string | number;
+    creator: string;
+    rentPayer?: string;
+    isDraft?: boolean;
+}
+export interface SolanaApproveProposalParams {
+    chain: string;
+    blockhash: string;
+    feePayer: string;
+    /** 共识账户：settings PDA（settings 交易）或 policy PDA（policy 交易） */
+    settingsPda: string;
+    transactionIndex: string | number;
+    signer: string;
+    memo?: string;
+}
+export interface SolanaExecutePolicyTransactionParams {
+    chain: string;
+    blockhash: string;
+    feePayer: string;
+    /** policy PDA */
+    policy: string;
+    transactionIndex: string | number;
+    signer: string;
+    /** 策略执行所需的剩余账户（native SOL: [source, destination, systemProgram]） */
+    anchorRemainingAccounts: Array<{
+        pubkey: string;
+        isWritable?: boolean;
+        isSigner?: boolean;
+    }>;
+}
+export interface SolanaRemovePolicyParams {
+    chain: string;
+    blockhash: string;
+    feePayer: string;
+    creator: string;
+    settingsPda: string;
+    transactionIndex: string | number;
+    /** 待删除的 policy PDA（同时需在 execute 时作为 remaining account 传入） */
+    policy: string;
+    rentPayer?: string;
+    memo?: string;
+}
+export interface SolanaCloseTransactionParams {
+    chain: string;
+    blockhash: string;
+    feePayer: string;
+    /** 共识账户：policy PDA（policy 交易）或 settings PDA（settings 交易） */
+    settingsPda: string;
+    transactionIndex: string | number;
+    /** transaction 账户 rent 回收地址；缺省 feePayer */
+    transactionRentCollector?: string;
+    /** proposal 账户 rent 回收地址；缺省 transactionRentCollector */
+    proposalRentCollector?: string;
+}
+export interface SolanaExecutePolicyPayloadParams {
+    chain: string;
+    blockhash: string;
+    feePayer: string;
+    /** policy PDA */
+    policy: string;
+    accountIndex?: number;
+    numSigners: number;
+    amount: string | number;
+    destination: string;
+    decimals: number;
+    instructionAccounts: Array<{
+        pubkey: string;
+        isWritable?: boolean;
+        isSigner?: boolean;
+    }>;
+}
+export interface SolanaCloseSettingsParams {
+    chain: string;
+    blockhash: string;
+    feePayer: string;
+    settingsPda: string;
+    transactionIndex: string | number;
+    transactionRentCollector?: string;
+    proposalRentCollector?: string;
+}
+export interface SolanaExecutePolicyParams {
+    chain: string;
+    blockhash: string;
+    feePayer: string;
+    settingsPda: string;
+    transactionIndex: string | number;
+    signer: string;
+    rentPayer?: string;
+    spendingLimits?: Array<Record<string, unknown>>;
+    /** `PolicyCreate` / `PolicyRemove` 的 policy PDA 列表（remaining accounts） */
+    policies?: string[];
+}
+export interface SolanaExecuteParams {
+    chain: string;
+    blockhash: string;
+    feePayer: string;
+    settingsPda: string;
+    signer: string;
+    spendingLimit: string;
+    mint?: string;
+    accountIndex: number;
+    amount: string | number;
+    decimals: number;
+    destination: string;
+    tokenProgram?: string;
+    memo?: string;
+}
+export interface SolanaRemoveSignerParams {
+    chain: string;
+    blockhash: string;
+    feePayer: string;
+    settingsPda: string;
+    settingsAuthority: string;
+    oldSigner: string;
+    memo?: string;
+}
+export interface SolanaSubmitParams {
+    chain: string;
+    transaction: string;
+}
+/** 构建端点返回的未签名交易（base64）。 */
+export interface SolanaUnsignedTransaction {
+    chain: string;
+    transaction: string;
+    feePayer?: string;
+    instructionCount?: number;
+}
+export interface SolanaSubmitResult {
+    chain: string;
+    signature: string;
+    feePayer?: string;
+}
+export interface MpcSendCodeParams {
+    email: string;
+}
+export interface MpcVerifyParams {
+    email: string;
+    code: string;
+}
+export interface MpcBalanceParams {
+    token: string;
+    chain?: string;
+    tokenAddress?: string;
+}
+export interface MpcSignMessageParams {
+    token: string;
+    message: string;
+}
+export interface MpcSignTypedDataParams {
+    token: string;
+    domain: Record<string, unknown>;
+    types: Record<string, unknown>;
+    value: Record<string, unknown>;
+}
+export interface MpcSendTransactionParams {
+    token: string;
+    to: string;
+    amount: string;
+    chain?: string;
+    tokenAddress?: string;
+}
+export interface MpcContractCallParams {
+    contractAddress: string;
+    abi: unknown[];
+    method: string;
+    args?: unknown[];
+    chain?: string;
+}
+export interface MpcContractWriteParams extends MpcContractCallParams {
+    token: string;
+    value?: string;
+    gasLimit?: string;
+}
+export interface MpcGasEstimateParams {
+    to?: string;
+    value?: string;
+    data?: string;
+    chain?: string;
+}
+export declare class WalletAPI {
+    private http;
+    constructor(http: HttpClient);
+    create(params: CreateWalletParams): Promise<WalletCreated>;
+    import(params: ImportWalletParams): Promise<WalletCreated>;
+    sign(params: SignParams): Promise<SignResult>;
+    send(params: SendParams): Promise<SendResult>;
+    /** 预估交易 gas（不耗资金）。 */
+    estimateGas(params: {
+        walletId: string;
+        toAddress: string;
+        amount: string;
+        chain: string;
+        tokenAddress?: string;
+    }): Promise<Record<string, unknown>>;
+    /** 清空钱包原生余额到指定地址（sweep）。 */
+    sweep(params: {
+        walletId: string;
+        toAddress: string;
+        chain: string;
+        paymentPassword: string;
+    }): Promise<Record<string, unknown>>;
+    /** 按 txHash 查交易状态（链上回执）。 */
+    txStatus(txHash: string): Promise<Record<string, unknown>>;
+    /** 链上读写（读 + 广播统一，走 chain-rpc 聚合层）。 */
+    chain(params: ChainParams): Promise<ChainResult>;
+    balance(params: WalletBalanceParams): Promise<WalletBalanceResult>;
+    /** Chain-RPC 子域：池状态 / 读套餐订阅面（canonical `/v1/wallet/chain/*`）。 */
+    chainRpc: {
+        /** chain-rpc 网关池状态（各链健康 / 活跃端点，脱敏）。 */
+        status: () => Promise<unknown>;
+        /** chain-rpc 网关健康检查。 */
+        health: () => Promise<unknown>;
+        /** RPC 读套餐订阅面。 */
+        subscription: {
+            /** 套餐目录 + 完整链表（公开，无需 key）。 */
+            plans: () => Promise<unknown>;
+            /** 发起订阅支付（rx_ key 鉴权）：免费即时激活，付费返回支付意图。 */
+            checkout: (p: {
+                rpcKey: string;
+                planId: string;
+                rail?: string;
+                subscriber?: string;
+            }) => Promise<unknown>;
+            /** 轮询订阅支付状态（chain rail 链上确认）。 */
+            paymentCheck: (p: {
+                rpcKey: string;
+                subscriber?: string;
+            }) => Promise<unknown>;
+            /** 确认 x402 rail 支付（提交 base64 PAYMENT-SIGNATURE）以激活订阅。 */
+            verify: (p: {
+                rpcKey: string;
+                paymentSignature: string;
+            }) => Promise<unknown>;
+            /** 查询订阅用量（套餐 / 月配额 / 当前用量 / 日聚合）。 */
+            usage: (rpcKey: string) => Promise<unknown>;
+        };
+    };
+    safe: {
+        /** Vault 概览：Safe 总数 / 待签 / 启用风控规则数。 */
+        dashboard: () => Promise<unknown>;
+        /** 列出多签 Safe（按 userId 过滤）。 */
+        list: (userId?: string) => Promise<unknown>;
+        /** 单个 Safe 详情（含交易历史）。 */
+        info: (address: string) => Promise<unknown>;
+        /** 创建并链上部署多签 Safe。 */
+        create: (p: {
+            chainId: string;
+            owners: string[];
+            threshold: number;
+            name?: string;
+            userId?: string;
+        }) => Promise<unknown>;
+        propose: (p: {
+            safeAddress: string;
+            to: string;
+            value?: string;
+            data?: string;
+        }) => Promise<unknown>;
+        confirm: (p: {
+            safeAddress: string;
+            safeTxHash: string;
+            signature: string;
+        }) => Promise<unknown>;
+        execute: (p: {
+            safeTxHash: string;
+        }) => Promise<unknown>;
+        /** 更新 owner 集合与阈值（走链上多签提案）。 */
+        updateOwners: (address: string, p: {
+            owners: string[];
+            threshold: number;
+            signature?: string;
+            userId?: string;
+        }) => Promise<unknown>;
+        /** 重试待部署 Safe（可按 chainId）。 */
+        retry: (chainId?: string) => Promise<unknown>;
+        /** 执行所有已达阈值的交易。 */
+        executeReady: (safeAddress?: string) => Promise<unknown>;
+        /** 同步 Safe 链上状态到库。 */
+        sync: (safeAddress: string) => Promise<unknown>;
+        /** Safe 状态（enabled / count）。 */
+        status: (walletAddress?: string) => Promise<unknown>;
+        /** 风控检查（按链规则判定单笔是否超限）。 */
+        riskCheck: (p: {
+            amount: string;
+            chain: string;
+        }) => Promise<unknown>;
+    };
+    session: {
+        create: (p: Record<string, unknown>) => Promise<unknown>;
+        revoke: (sessionId: string) => Promise<unknown>;
+        execute: (p: Record<string, unknown>) => Promise<unknown>;
+        /** Solana（Squads Smart Account）：构建未签名交易 + 广播已签名交易。 */
+        solana: {
+            deriveAccount: (p: SolanaDeriveAccountParams) => Promise<SolanaDerivedAccount>;
+            createAccount: (p: SolanaCreateAccountParams) => Promise<SolanaUnsignedTransaction>;
+            installPolicy: (p: SolanaInstallPolicyParams) => Promise<SolanaUnsignedTransaction>;
+            executePolicy: (p: SolanaExecutePolicyParams) => Promise<SolanaUnsignedTransaction>;
+            /** 新口径：创建 spending limit policy 交易（待多签审批）。 */
+            createPolicyTransaction: (p: SolanaCreatePolicyTransactionParams) => Promise<SolanaUnsignedTransaction>;
+            /** settings / policy 交易提案：创建。 */
+            createProposal: (p: SolanaCreateProposalParams) => Promise<SolanaUnsignedTransaction>;
+            /** settings / policy 交易提案：审批（threshold 达成即 Approved）。 */
+            approveProposal: (p: SolanaApproveProposalParams) => Promise<SolanaUnsignedTransaction>;
+            /** 新口径：异步执行已批准的 policy 交易。 */
+            executePolicyTransaction: (p: SolanaExecutePolicyTransactionParams) => Promise<SolanaUnsignedTransaction>;
+            /** 新口径：删除 policy（PolicyRemove）并回收其 rent。 */
+            removePolicy: (p: SolanaRemovePolicyParams) => Promise<SolanaUnsignedTransaction>;
+            /** 新口径：同步执行 spending limit policy。 */
+            executePolicyPayload: (p: SolanaExecutePolicyPayloadParams) => Promise<SolanaUnsignedTransaction>;
+            /** 关闭废弃 settings 交易并回收 rent。 */
+            closeSettings: (p: SolanaCloseSettingsParams) => Promise<SolanaUnsignedTransaction>;
+            /** 关闭 policy 交易并回收 transaction/proposal rent。 */
+            closeTransaction: (p: SolanaCloseTransactionParams) => Promise<SolanaUnsignedTransaction>;
+            execute: (p: SolanaExecuteParams) => Promise<SolanaUnsignedTransaction>;
+            removeSigner: (p: SolanaRemoveSignerParams) => Promise<SolanaUnsignedTransaction>;
+            submit: (p: SolanaSubmitParams) => Promise<SolanaSubmitResult>;
+        };
+    };
+    /** MPC（email 分片钱包）子域：canonical `/v1/wallet/mpc/*`。 */
+    mpc: {
+        sendCode: (p: MpcSendCodeParams) => Promise<unknown>;
+        register: (p: MpcVerifyParams) => Promise<unknown>;
+        recover: (p: MpcVerifyParams) => Promise<unknown>;
+        status: (email: string) => Promise<unknown>;
+        wallets: (email?: string) => Promise<unknown>;
+        sessionUnlock: (p: MpcVerifyParams) => Promise<unknown>;
+        sessionLock: (p: {
+            token: string;
+        }) => Promise<unknown>;
+        sessionStatus: (token: string) => Promise<unknown>;
+        balance: (p: MpcBalanceParams) => Promise<unknown>;
+        signMessage: (p: MpcSignMessageParams) => Promise<unknown>;
+        signTypedData: (p: MpcSignTypedDataParams) => Promise<unknown>;
+        sendTransaction: (p: MpcSendTransactionParams) => Promise<unknown>;
+        contractRead: (p: MpcContractCallParams) => Promise<unknown>;
+        contractWrite: (p: MpcContractWriteParams) => Promise<unknown>;
+        gasEstimate: (p: MpcGasEstimateParams) => Promise<unknown>;
+    };
+}

package/dist/wallet.js

@@ -0,0 +1,142 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// @keelcodes/sdk — wallet 模块
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletAPI = void 0;
+class WalletAPI {
+    constructor(http) {
+        this.http = http;
+        /** Chain-RPC 子域：池状态 / 读套餐订阅面（canonical `/v1/wallet/chain/*`）。 */
+        this.chainRpc = {
+            /** chain-rpc 网关池状态（各链健康 / 活跃端点，脱敏）。 */
+            status: () => this.http.get('/v1/wallet/chain/status'),
+            /** chain-rpc 网关健康检查。 */
+            health: () => this.http.get('/v1/wallet/chain/health'),
+            /** RPC 读套餐订阅面。 */
+            subscription: {
+                /** 套餐目录 + 完整链表（公开，无需 key）。 */
+                plans: () => this.http.get('/v1/wallet/chain/subscription/plans'),
+                /** 发起订阅支付（rx_ key 鉴权）：免费即时激活，付费返回支付意图。 */
+                checkout: (p) => this.http.post('/v1/wallet/chain/subscription/checkout', { plan_id: p.planId, rail: p.rail, subscriber: p.subscriber }, { 'x-rpc-key': p.rpcKey }),
+                /** 轮询订阅支付状态（chain rail 链上确认）。 */
+                paymentCheck: (p) => this.http.post('/v1/wallet/chain/subscription/payment-check', { subscriber: p.subscriber }, { 'x-rpc-key': p.rpcKey }),
+                /** 确认 x402 rail 支付（提交 base64 PAYMENT-SIGNATURE）以激活订阅。 */
+                verify: (p) => this.http.post('/v1/wallet/chain/subscription/verify', { paymentSignature: p.paymentSignature }, { 'x-rpc-key': p.rpcKey }),
+                /** 查询订阅用量（套餐 / 月配额 / 当前用量 / 日聚合）。 */
+                usage: (rpcKey) => this.http.get('/v1/wallet/chain/subscription/usage', { 'x-rpc-key': rpcKey }),
+            },
+        };
+        this.safe = {
+            /** Vault 概览：Safe 总数 / 待签 / 启用风控规则数。 */
+            dashboard: () => this.http.get('/v1/wallet/safe/dashboard'),
+            /** 列出多签 Safe（按 userId 过滤）。 */
+            list: (userId) => this.http.get('/v1/wallet/safe/list' + (userId ? '?userId=' + encodeURIComponent(userId) : '')),
+            /** 单个 Safe 详情（含交易历史）。 */
+            info: (address) => this.http.get('/v1/wallet/safe/' + encodeURIComponent(address)),
+            /** 创建并链上部署多签 Safe。 */
+            create: (p) => this.http.post('/v1/wallet/safe/create', p),
+            propose: (p) => this.http.post('/v1/wallet/safe/propose', p),
+            confirm: (p) => this.http.post('/v1/wallet/safe/confirm', p),
+            execute: (p) => this.http.post('/v1/wallet/safe/execute', p),
+            /** 更新 owner 集合与阈值（走链上多签提案）。 */
+            updateOwners: (address, p) => this.http.put('/v1/wallet/safe/' + encodeURIComponent(address) + '/owners', p),
+            /** 重试待部署 Safe（可按 chainId）。 */
+            retry: (chainId) => this.http.post('/v1/wallet/safe/retry', { chainId }),
+            /** 执行所有已达阈值的交易。 */
+            executeReady: (safeAddress) => this.http.post('/v1/wallet/safe/execute-ready', { safeAddress }),
+            /** 同步 Safe 链上状态到库。 */
+            sync: (safeAddress) => this.http.post('/v1/wallet/safe/sync', { safeAddress }),
+            /** Safe 状态（enabled / count）。 */
+            status: (walletAddress) => this.http.get('/v1/wallet/safe/status' + (walletAddress ? '?walletAddress=' + encodeURIComponent(walletAddress) : '')),
+            /** 风控检查（按链规则判定单笔是否超限）。 */
+            riskCheck: (p) => this.http.post('/v1/wallet/safe/risk/check', p),
+        };
+        this.session = {
+            create: (p) => this.http.post('/v1/wallet/session/create', p),
+            revoke: (sessionId) => this.http.post('/v1/wallet/session/revoke', { sessionId }),
+            execute: (p) => this.http.post('/v1/wallet/session/execute', p),
+            /** Solana（Squads Smart Account）：构建未签名交易 + 广播已签名交易。 */
+            solana: {
+                deriveAccount: (p) => this.http.post('/v1/wallet/session/solana/account/derive', p),
+                createAccount: (p) => this.http.post('/v1/wallet/session/solana/account/create', p),
+                installPolicy: (p) => this.http.post('/v1/wallet/session/solana/session/policy', p),
+                executePolicy: (p) => this.http.post('/v1/wallet/session/solana/session/policy/execute', p),
+                /** 新口径：创建 spending limit policy 交易（待多签审批）。 */
+                createPolicyTransaction: (p) => this.http.post('/v1/wallet/session/solana/session/policy/create-transaction', p),
+                /** settings / policy 交易提案：创建。 */
+                createProposal: (p) => this.http.post('/v1/wallet/session/solana/session/proposal', p),
+                /** settings / policy 交易提案：审批（threshold 达成即 Approved）。 */
+                approveProposal: (p) => this.http.post('/v1/wallet/session/solana/session/proposal/approve', p),
+                /** 新口径：异步执行已批准的 policy 交易。 */
+                executePolicyTransaction: (p) => this.http.post('/v1/wallet/session/solana/session/policy/execute-transaction', p),
+                /** 新口径：删除 policy（PolicyRemove）并回收其 rent。 */
+                removePolicy: (p) => this.http.post('/v1/wallet/session/solana/session/policy/remove', p),
+                /** 新口径：同步执行 spending limit policy。 */
+                executePolicyPayload: (p) => this.http.post('/v1/wallet/session/solana/session/policy/execute-payload', p),
+                /** 关闭废弃 settings 交易并回收 rent。 */
+                closeSettings: (p) => this.http.post('/v1/wallet/session/solana/settings/close', p),
+                /** 关闭 policy 交易并回收 transaction/proposal rent。 */
+                closeTransaction: (p) => this.http.post('/v1/wallet/session/solana/session/policy/close-transaction', p),
+                execute: (p) => this.http.post('/v1/wallet/session/solana/session/execute', p),
+                removeSigner: (p) => this.http.post('/v1/wallet/session/solana/session/remove-signer', p),
+                submit: (p) => this.http.post('/v1/wallet/session/solana/submit', p),
+            },
+        };
+        /** MPC（email 分片钱包）子域：canonical `/v1/wallet/mpc/*`。 */
+        this.mpc = {
+            sendCode: (p) => this.http.post('/v1/wallet/mpc/send-code', p),
+            register: (p) => this.http.post('/v1/wallet/mpc/register', p),
+            recover: (p) => this.http.post('/v1/wallet/mpc/recover', p),
+            status: (email) => this.http.get('/v1/wallet/mpc/status?email=' + encodeURIComponent(email)),
+            wallets: (email) => this.http.get('/v1/wallet/mpc/wallets' + (email ? '?email=' + encodeURIComponent(email) : '')),
+            sessionUnlock: (p) => this.http.post('/v1/wallet/mpc/session/unlock', p),
+            sessionLock: (p) => this.http.post('/v1/wallet/mpc/session/lock', p),
+            sessionStatus: (token) => this.http.get('/v1/wallet/mpc/session/status?token=' + encodeURIComponent(token)),
+            balance: (p) => this.http.post('/v1/wallet/mpc/balance', p),
+            signMessage: (p) => this.http.post('/v1/wallet/mpc/sign-message', p),
+            signTypedData: (p) => this.http.post('/v1/wallet/mpc/sign-typed-data', p),
+            sendTransaction: (p) => this.http.post('/v1/wallet/mpc/send-transaction', p),
+            contractRead: (p) => this.http.post('/v1/wallet/mpc/contract-read', p),
+            contractWrite: (p) => this.http.post('/v1/wallet/mpc/contract-write', p),
+            gasEstimate: (p) => this.http.post('/v1/wallet/mpc/gas-estimate', p),
+        };
+    }
+    create(params) {
+        return this.http.post('/v1/wallet/create', params);
+    }
+    import(params) {
+        return this.http.post('/v1/wallet/import', params);
+    }
+    sign(params) {
+        return this.http.post('/v1/wallet/sign', params);
+    }
+    send(params) {
+        return this.http.post('/v1/wallet/send', params);
+    }
+    /** 预估交易 gas（不耗资金）。 */
+    estimateGas(params) {
+        return this.http.post('/v1/wallet/estimate-gas', params);
+    }
+    /** 清空钱包原生余额到指定地址（sweep）。 */
+    sweep(params) {
+        return this.http.post('/v1/wallet/sweep', params);
+    }
+    /** 按 txHash 查交易状态（链上回执）。 */
+    txStatus(txHash) {
+        return this.http.get('/v1/wallet/status/' + encodeURIComponent(txHash));
+    }
+    /** 链上读写（读 + 广播统一，走 chain-rpc 聚合层）。 */
+    chain(params) {
+        return this.http.post('/v1/wallet/chain', params);
+    }
+    balance(params) {
+        const q = new URLSearchParams({ address: params.address });
+        if (params.chain)
+            q.set('chain', params.chain);
+        if (params.token)
+            q.set('token', params.token);
+        return this.http.get('/v1/wallet/balance?' + q.toString());
+    }
+}
+exports.WalletAPI = WalletAPI;

package/package.json

@@ -1,6 +1,55 @@
 {
   "name": "@keelcodes/sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2.0.0",
+  "description": "Keel SDK — unified access to payment / wallet / data / account modules over https://keel.codes",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./payment": {
+      "types": "./dist/payment.d.ts",
+      "default": "./dist/payment.js"
+    },
+    "./wallet": {
+      "types": "./dist/wallet.d.ts",
+      "default": "./dist/wallet.js"
+    },
+    "./data": {
+      "types": "./dist/data.d.ts",
+      "default": "./dist/data.js"
+    },
+    "./account": {
+      "types": "./dist/account.d.ts",
+      "default": "./dist/account.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "keel",
+    "payment",
+    "wallet",
+    "data",
+    "account",
+    "sdk"
+  ],
+  "license": "MIT",
+  "author": "Keel",
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  }
+}