@keelcodes/sdk 2.0.0 → 2.1.0

package/dist/wallet/types.d.ts

@@ -0,0 +1,74 @@
+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;
+}

package/dist/wallet/types.js

@@ -0,0 +1,5 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// @keelcodes/sdk — wallet 模块：核心类型
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/wallet/wallet-api.d.ts

@@ -0,0 +1,186 @@
+import { HttpClient } from '../http';
+import type { CreateWalletParams, WalletCreated, ImportWalletParams, SignParams, SignResult, SendParams, SendResult, ChainParams, ChainResult, WalletBalanceParams, WalletBalanceResult } from './types';
+import type { SolanaDeriveAccountParams, SolanaDerivedAccount, SolanaCreateAccountParams, SolanaInstallPolicyParams, SolanaCreatePolicyTransactionParams, SolanaCreateProposalParams, SolanaApproveProposalParams, SolanaExecutePolicyTransactionParams, SolanaRemovePolicyParams } from './solana-account-types';
+import type { SolanaExecutePolicyPayloadParams, SolanaCloseSettingsParams, SolanaCloseTransactionParams, SolanaExecutePolicyParams, SolanaExecuteParams, SolanaRemoveSignerParams, SolanaSubmitParams, SolanaUnsignedTransaction, SolanaSubmitResult } from './solana-execution-types';
+import type { MpcSendCodeParams, MpcVerifyParams, MpcBalanceParams, MpcSignMessageParams, MpcSignTypedDataParams, MpcSendTransactionParams, MpcContractCallParams, MpcContractWriteParams, MpcGasEstimateParams } from './mpc-types';
+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>;
+    /** 查询当前钱包在指定链的充值地址。 */
+    address(chain: string): Promise<Record<string, unknown>>;
+    /** 交易流水（托管查库；`nc=true` 时直接扫链）。 */
+    transactions(p?: {
+        page?: number;
+        limit?: number;
+        chain?: string;
+        type?: string;
+        nc?: boolean;
+    }): Promise<Record<string, unknown>>;
+    /** 批量转账（需 admin 权限，B 端钱包签名不可用；建议用 `request` 直连或逐笔 `send`）。 */
+    batch(p: {
+        walletId: string;
+        transfers: Array<{
+            to: string;
+            amount: string;
+        }>;
+        paymentPassword: string;
+    }): Promise<Record<string, unknown>>;
+    /** 查询批量转账进度。 */
+    batchProgress(batchId: string): Promise<Record<string, unknown>>;
+    /** 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 → wallet/wallet-api.js}

@@ -1,7 +1,4 @@
 "use strict";
-// ---------------------------------------------------------------------------
-// @keelcodes/sdk — wallet 模块
-// ---------------------------------------------------------------------------
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WalletAPI = void 0;
 class WalletAPI {
@@ -138,5 +135,33 @@ class WalletAPI {
             q.set('token', params.token);
         return this.http.get('/v1/wallet/balance?' + q.toString());
     }
+    /** 查询当前钱包在指定链的充值地址。 */
+    address(chain) {
+        return this.http.get('/v1/wallet/address?chain=' + encodeURIComponent(chain));
+    }
+    /** 交易流水（托管查库；`nc=true` 时直接扫链）。 */
+    transactions(p = {}) {
+        const q = new URLSearchParams();
+        if (p.page)
+            q.set('page', String(p.page));
+        if (p.limit)
+            q.set('limit', String(p.limit));
+        if (p.chain)
+            q.set('chain', p.chain);
+        if (p.type)
+            q.set('type', p.type);
+        if (p.nc)
+            q.set('nc', 'true');
+        const qs = q.toString();
+        return this.http.get('/v1/wallet/transactions' + (qs ? '?' + qs : ''));
+    }
+    /** 批量转账（需 admin 权限，B 端钱包签名不可用；建议用 `request` 直连或逐笔 `send`）。 */
+    batch(p) {
+        return this.http.post('/v1/wallet/batch', p);
+    }
+    /** 查询批量转账进度。 */
+    batchProgress(batchId) {
+        return this.http.get('/v1/wallet/batch/' + encodeURIComponent(batchId) + '/progress');
+    }
 }
 exports.WalletAPI = WalletAPI;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keelcodes/sdk",
-  "version": "2.0.0",
+  "version": "2.1.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",
@@ -14,8 +14,8 @@
       "default": "./dist/payment.js"
     },
     "./wallet": {
-      "types": "./dist/wallet.d.ts",
-      "default": "./dist/wallet.js"
+      "types": "./dist/wallet/index.d.ts",
+      "default": "./dist/wallet/index.js"
     },
     "./data": {
       "types": "./dist/data.d.ts",