@keelcodes/sdk 1.0.0 → 2.1.0

package/dist/account.d.ts

@@ -47,4 +47,27 @@ export declare class AccountAPI {
         subscribe: (p: SubscriptionParams) => Promise<SubscriptionResult>;
         cancel: (module: KeelModule) => Promise<unknown>;
     };
+    /** 创建提现（钱包签名；启用 TOTP 时需带 `totpCode`）。 */
+    withdraw(p: {
+        externalUserId: string;
+        toAddress: string;
+        amount: string;
+        token?: string;
+        totpCode?: string;
+    }): Promise<Record<string, unknown>>;
+    /** 提现列表（可选 `x-api-key`；无租户上下文时返回空列表 + 热钱包概况）。 */
+    withdrawals(p?: {
+        status?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, unknown>>;
+    /** 租户余额总览（需配置 `tenantApiKey`）。 */
+    balances(): Promise<Record<string, unknown>>;
+    /** 租户交易流水（需配置 `tenantApiKey`）。 */
+    transactions(p?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Record<string, unknown>>;
+    /** 租户热钱包各链原生余额（需配置 `tenantApiKey`）。 */
+    hotWalletBalances(): Promise<Record<string, unknown>>;
 }

package/dist/account.js

@@ -22,5 +22,39 @@ class AccountAPI {
             cancel: (module) => this.http.post('/v1/account/subscription/cancel', { module }),
         };
     }
+    /** 创建提现（钱包签名；启用 TOTP 时需带 `totpCode`）。 */
+    withdraw(p) {
+        return this.http.post('/v1/account/withdraw', p);
+    }
+    /** 提现列表（可选 `x-api-key`；无租户上下文时返回空列表 + 热钱包概况）。 */
+    withdrawals(p = {}) {
+        const q = new URLSearchParams();
+        if (p.status)
+            q.set('status', p.status);
+        if (p.limit)
+            q.set('limit', String(p.limit));
+        if (p.offset)
+            q.set('offset', String(p.offset));
+        const qs = q.toString();
+        return this.http.get('/v1/account/withdrawals' + (qs ? '?' + qs : ''));
+    }
+    /** 租户余额总览（需配置 `tenantApiKey`）。 */
+    balances() {
+        return this.http.get('/v1/account/balances');
+    }
+    /** 租户交易流水（需配置 `tenantApiKey`）。 */
+    transactions(p = {}) {
+        const q = new URLSearchParams();
+        if (p.limit)
+            q.set('limit', String(p.limit));
+        if (p.offset)
+            q.set('offset', String(p.offset));
+        const qs = q.toString();
+        return this.http.get('/v1/account/transactions' + (qs ? '?' + qs : ''));
+    }
+    /** 租户热钱包各链原生余额（需配置 `tenantApiKey`）。 */
+    hotWalletBalances() {
+        return this.http.get('/v1/account/hot-wallet/balances');
+    }
 }
 exports.AccountAPI = AccountAPI;

package/dist/data.d.ts

@@ -75,6 +75,31 @@ export declare class DataAPI {
     predictions(params: PredictParams): Promise<PredictResult>;
     events(params?: EventsParams): Promise<EventsResult>;
     rag(params: RagParams): Promise<RagResult>;
+    /**
+     * SSE 实时流（ticker / factors）。返回原始 `Response`，由调用方消费 `res.body`。
+     * 该请求不设超时，需自行处理断线与重连。
+     */
+    stream(params?: {
+        channels?: string | string[];
+        symbols?: string | string[];
+    }): Promise<Response>;
+    /** 用户级数据 Key 自助管理（钱包签名；网关另需 `sk_data_*`）。 */
+    myKeys: {
+        /** 列出当前钱包持有的 key（不含明文）。 */
+        list: () => Promise<Record<string, unknown>>;
+        /** 创建 key：`{label, scope?, rate_limit?}`；明文仅本次返回。 */
+        create: (p: {
+            label: string;
+            scope?: string;
+            rate_limit?: number;
+        }) => Promise<Record<string, unknown>>;
+        /** 用一次性认领码换取 key 明文（仅一次可见）。 */
+        claim: (claimCode: string) => Promise<Record<string, unknown>>;
+        /** 轮换 key，返回新的明文。 */
+        rotate: (keyId: number | string) => Promise<Record<string, unknown>>;
+        /** 删除 key。 */
+        remove: (keyId: number | string) => Promise<Record<string, unknown>>;
+    };
     /** 取单符号最新行情（ticker）。 */
     ticker(symbol: string): Promise<Record<string, unknown>>;
     /** 列出受支持交易符号（可按市场 / 关键词过滤）。 */

package/dist/data.js

@@ -7,6 +7,19 @@ exports.DataAPI = void 0;
 class DataAPI {
     constructor(http) {
         this.http = http;
+        /** 用户级数据 Key 自助管理（钱包签名；网关另需 `sk_data_*`）。 */
+        this.myKeys = {
+            /** 列出当前钱包持有的 key（不含明文）。 */
+            list: () => this.http.get('/v1/data/my-keys'),
+            /** 创建 key：`{label, scope?, rate_limit?}`；明文仅本次返回。 */
+            create: (p) => this.http.post('/v1/data/my-keys', p),
+            /** 用一次性认领码换取 key 明文（仅一次可见）。 */
+            claim: (claimCode) => this.http.post('/v1/data/my-keys/claim', { claim_code: claimCode }),
+            /** 轮换 key，返回新的明文。 */
+            rotate: (keyId) => this.http.post('/v1/data/my-keys/' + encodeURIComponent(String(keyId)) + '/rotate'),
+            /** 删除 key。 */
+            remove: (keyId) => this.http.delete('/v1/data/my-keys/' + encodeURIComponent(String(keyId))),
+        };
         // ── Market 子域（DEX 行情 / 监控 / 订阅）：canonical `/v1/data/market*` ──
         this.market = {
             /** 按名称/符号搜索 DEX 代币（DexScreener）。 */
@@ -146,6 +159,18 @@ class DataAPI {
     rag(params) {
         return this.http.post('/v1/data/rag', params);
     }
+    /**
+     * SSE 实时流（ticker / factors）。返回原始 `Response`，由调用方消费 `res.body`。
+     * 该请求不设超时，需自行处理断线与重连。
+     */
+    stream(params = {}) {
+        const channels = Array.isArray(params.channels) ? params.channels.join(',') : (params.channels ?? 'ticker');
+        const q = new URLSearchParams({ channels });
+        if (params.symbols) {
+            q.set('symbols', Array.isArray(params.symbols) ? params.symbols.join(',') : params.symbols);
+        }
+        return this.http.stream('/v1/data/stream?' + q.toString());
+    }
     // ── 行情 / 符号 / 快照（旧 hub MCP 能力）──
     /** 取单符号最新行情（ticker）。 */
     ticker(symbol) {

package/dist/http.d.ts

@@ -1,6 +1,6 @@
 import type { KeelConfig } from './types';
-/** SDK 版本（契约 §5，基线 1.0.0，随包版本同步）。 */
-export declare const SDK_VERSION = "1.0.0";
+/** SDK 版本（契约 §5，基线 2.1.0，随包版本同步）。 */
+export declare const SDK_VERSION = "2.1.0";
 export declare class HttpClient {
     private baseUrl;
     private headers;
@@ -11,7 +11,13 @@ export declare class HttpClient {
     get<T>(path: string, headers?: Record<string, string>): Promise<T>;
     post<T>(path: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
     put<T>(path: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
-    private request;
+    delete<T>(path: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
+    /**
+     * 发起 SSE / 流式 GET，返回原始 `Response`（不解析 JSON、不设超时）。
+     * 调用方自行消费 `res.body`；非 2xx 仍抛 `KeelApiError`。
+     */
+    stream(path: string, headers?: Record<string, string>): Promise<Response>;
+    request<T>(method: string, path: string, body?: unknown, extraHeaders?: Record<string, string>): Promise<T>;
     /** 静态头 + （若配置）钱包签名头。签名按 WALLET_TOKEN_TTL_MS 复用。 */
     private buildHeaders;
 }

package/dist/http.js

@@ -5,8 +5,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HttpClient = exports.SDK_VERSION = void 0;
 const errors_1 = require("./errors");
-/** SDK 版本（契约 §5，基线 1.0.0，随包版本同步）。 */
-exports.SDK_VERSION = '1.0.0';
+/** SDK 版本（契约 §5，基线 2.1.0，随包版本同步）。 */
+exports.SDK_VERSION = '2.1.0';
 /**
  * 钱包签名的复用时长（ms）：首次签名后在该窗口内复用，避免每个请求都触发钱包弹窗。
  * 服务端会话 TTL 为 24h，此处取 1h 留足余量。
@@ -19,6 +19,8 @@ class HttpClient {
         this.headers = { 'Content-Type': 'application/json', 'X-Keel-Version': exports.SDK_VERSION };
         if (config.apiKey)
             this.headers['Authorization'] = `Bearer ${config.apiKey}`;
+        if (config.tenantApiKey)
+            this.headers['x-api-key'] = config.tenantApiKey;
         if (config.serviceKey)
             this.headers['X-Service-Key'] = config.serviceKey;
         if (config.wallet)
@@ -33,6 +35,24 @@ class HttpClient {
     async put(path, body, headers) {
         return this.request('PUT', path, body, headers);
     }
+    delete(path, body, headers) {
+        return this.request('DELETE', path, body, headers);
+    }
+    /**
+     * 发起 SSE / 流式 GET，返回原始 `Response`（不解析 JSON、不设超时）。
+     * 调用方自行消费 `res.body`；非 2xx 仍抛 `KeelApiError`。
+     */
+    async stream(path, headers) {
+        const res = await fetch(this.baseUrl + path, {
+            method: 'GET',
+            headers: { ...(await this.buildHeaders()), ...headers },
+        });
+        if (res.status < 200 || res.status >= 300) {
+            const json = await res.json().catch(() => ({}));
+            throw new errors_1.KeelApiError(path, res.status, json?.code ?? 'INTERNAL', json);
+        }
+        return res;
+    }
     async request(method, path, body, extraHeaders) {
         const controller = new AbortController();
         const timer = setTimeout(() => controller.abort(), this.timeout);

package/dist/index.d.ts

@@ -10,6 +10,16 @@ export declare class Keel {
     readonly wallet: WalletAPI;
     readonly data: DataAPI;
     readonly account: AccountAPI;
+    private readonly http;
     constructor(config?: KeelConfig);
+    /**
+     * 通用逃生口：直接调用任意 canonical `/v1/<module>/*` 端点。
+     * 与命名空间方法共用同一套鉴权头（Bearer / x-api-key / 钱包签名）。
+     *
+     * @example
+     * const caps = await keel.request('GET', '/v1/payment/capabilities')
+     * const nft = await keel.request('GET', '/v1/wallet/nfts?chain=bsc')
+     */
+    request<T = unknown>(method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE', path: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
 }
 export default Keel;

package/dist/index.js

@@ -18,11 +18,22 @@ Object.defineProperty(exports, "KeelApiError", { enumerable: true, get: function
 Object.defineProperty(exports, "isKeelApiError", { enumerable: true, get: function () { return errors_1.isKeelApiError; } });
 class Keel {
     constructor(config = {}) {
-        const http = new http_1.HttpClient(config);
-        this.payment = new payment_1.PaymentAPI(http);
-        this.wallet = new wallet_1.WalletAPI(http);
-        this.data = new data_1.DataAPI(http);
-        this.account = new account_1.AccountAPI(http);
+        this.http = new http_1.HttpClient(config);
+        this.payment = new payment_1.PaymentAPI(this.http);
+        this.wallet = new wallet_1.WalletAPI(this.http);
+        this.data = new data_1.DataAPI(this.http);
+        this.account = new account_1.AccountAPI(this.http);
+    }
+    /**
+     * 通用逃生口：直接调用任意 canonical `/v1/<module>/*` 端点。
+     * 与命名空间方法共用同一套鉴权头（Bearer / x-api-key / 钱包签名）。
+     *
+     * @example
+     * const caps = await keel.request('GET', '/v1/payment/capabilities')
+     * const nft = await keel.request('GET', '/v1/wallet/nfts?chain=bsc')
+     */
+    request(method, path, body, headers) {
+        return this.http.request(method, path, body, headers);
     }
 }
 exports.Keel = Keel;

package/dist/payment.d.ts

@@ -4,19 +4,14 @@ export interface ChargeParams {
     payer: string;
     amountWei: string;
     /** 收费 rail（内部路由，对外仅暴露语义）。 */
-    method: 'fiat' | 'x402' | 'a2a' | 'batch' | 'invite';
+    method: 'x402' | 'a2a' | 'batch' | 'invite';
     asset?: string;
     chain?: string;
     reference: Reference;
     metadata?: Record<string, unknown>;
 }
-/** fiat 走 sessionUrl；链上走 payTo/priceWei。 */
+/** 链上收费返回收款地址 / 价格 / 网络。 */
 export type ChargeResult = {
-    reference: string;
-    sessionUrl: string;
-    paymentId: string;
-    redirect: true;
-} | {
     reference: string;
     payTo: string;
     priceWei: string;
@@ -106,7 +101,7 @@ export interface PaymentRequiredBody {
 export declare class PaymentAPI {
     private http;
     constructor(http: HttpClient);
-    /** 发起收费（内部路由 fiat/x402/a2a/batch/invite）。 */
+    /** 发起收费（内部路由 x402/a2a/batch/invite）。 */
     charge(params: ChargeParams): Promise<ChargeResult>;
     /** 主动付费。 */
     pay(params: PayParams): Promise<PayResult>;
@@ -132,29 +127,22 @@ export declare class PaymentAPI {
     }): Promise<Record<string, unknown>>;
     /** 支付通道发现：启用的 rail、各链收款钱包 / 价格 / 托管、各链可接受的稳定币。 */
     info(chain?: string): Promise<Record<string, unknown>>;
-    /** fiat 结账（Stripe）：返回 sessionUrl。mode=payment 为一次性扣款（默认订阅）。 */
-    checkout(params: {
-        subscriber: string;
-        amountCents?: number;
-        planId?: number;
-        period?: string;
-        currency?: string;
-        chain?: string;
-        mode?: 'subscription' | 'payment';
-        metadata?: Record<string, unknown>;
-        clientReference?: string;
-    }): Promise<Record<string, unknown>>;
     /** 读取链上订阅详情（active / payToken / amountPaid / 周期 / 试用）。 */
     subscriptionDetail(chain: string, subscriber: string, resourceId: number): Promise<Record<string, unknown>>;
     /** 读取链上套餐定价（price / period / active）。 */
     price(planId: number, chain?: string): Promise<Record<string, unknown>>;
-    /** 创建 a2a 链上支付意图（phase 1）。 */
+    /**
+     * 创建 a2a 支付意图（phase 1）。
+     * `settlementMode: 'direct'` 时 `payee` 必填，settle 只核验 payer → payee 的链上转账。
+     */
     a2aCreate(params: {
         subscriber: string;
         valueWei: string;
         asset?: string;
         chain?: string;
         payee?: string;
+        settlementMode?: 'collector' | 'direct';
+        expiresIn?: number;
         metadata?: Record<string, unknown>;
     }): Promise<Record<string, unknown>>;
     /** 确认 a2a 支付意图（phase 2）：mode=tx 校验链上交易；mode=balance 走账本扣减。 */
@@ -168,6 +156,10 @@ export declare class PaymentAPI {
         asset?: string;
         ref?: string;
     }): Promise<Record<string, unknown>>;
+    /** 结算 direct 意图（phase 2）：按 intent 绑定的 payee/asset/精确金额核验，并按链确认数判定终局。 */
+    a2aDirectSettle(paymentId: string, txHash: string): Promise<Record<string, unknown>>;
+    /** 取消未结算的 direct 意图（幂等）。 */
+    a2aCancel(paymentId: string): Promise<Record<string, unknown>>;
     /** 创建批量收款意图（一付款人对多收款人）。 */
     batchCreate(params: {
         subscriber: string;
@@ -235,31 +227,41 @@ export declare class PaymentAPI {
     transferConfirm(transferId: string): Promise<Record<string, unknown>>;
     /** 取消未执行的转账。 */
     transferCancel(transferId: string): Promise<Record<string, unknown>>;
-    /** 打开 MPP 支付通道（校验充值交易）。 */
-    mppOpen(params: {
-        payer: string;
-        depositWei: string;
-        salt: string;
-        txHash: string;
-        chain?: string;
-        metadata?: Record<string, unknown>;
-    }): Promise<Record<string, unknown>>;
-    /** 提交 MPP 累计凭证（EIP-712 签名）。 */
-    mppVoucher(params: {
-        channelId: string;
-        cumulativeAmount: string;
-        signature: string;
-    }): Promise<Record<string, unknown>>;
-    /** 为 MPP 通道追加充值。 */
-    mppTopup(params: {
-        channelId: string;
-        txHash: string;
-        additionalWei: string;
-    }): Promise<Record<string, unknown>>;
-    /** 批量结算 MPP 通道未结消费。 */
-    mppSettle(channelId: string): Promise<Record<string, unknown>>;
-    /** 关闭 MPP 通道（先结算尾部）。 */
-    mppClose(channelId: string): Promise<Record<string, unknown>>;
-    /** 读取 MPP 通道当前状态。 */
-    mppSession(channelId: string): Promise<Record<string, unknown>>;
+    /** 周期订阅扣费（基于已创建的 authorization）。 */
+    period: {
+        /** 扣减一个周期；返回 authorizationId 与扣费结果。 */
+        charge: (authorizationId: string) => Promise<Record<string, unknown>>;
+        /** 查询周期授权状态（剩余额度 / 周期 / 状态）。 */
+        authorization: (authorizationId: string) => Promise<Record<string, unknown>>;
+    };
+    /** 托管（escrow）链上按量计费 / 退款。 */
+    escrow: {
+        /** relayer 代为签名扣费：`{chain, user, amountWei, reference}`。 */
+        charge: (p: {
+            chain: string;
+            user: string;
+            amountWei: string;
+            reference: string;
+        }) => Promise<Record<string, unknown>>;
+        /** relayer 代为签名退款：`{chain, user, amountWei, reference}`。 */
+        refund: (p: {
+            chain: string;
+            user: string;
+            amountWei: string;
+            reference: string;
+        }) => Promise<Record<string, unknown>>;
+        /** 查询托管余额（未配置链返回 `{configured:false, balanceWei:'0'}`）。 */
+        balance: (chain: string, user: string) => Promise<Record<string, unknown>>;
+        /** 查询链上托管配置（地址 / 限额）。 */
+        info: (chain: string) => Promise<Record<string, unknown>>;
+        /** relayer gas 健康；不传 chain 返回全部已配置链。 */
+        relayerStatus: (chain?: string) => Promise<Record<string, unknown>>;
+        /** 核验 Solana 原生 SOL 充值并入账（幂等键 `sol:<signature>`）。 */
+        solanaVerify: (p: {
+            signature: string;
+            from: string;
+            amountLamports: string | number;
+            waitMs?: number;
+        }) => Promise<Record<string, unknown>>;
+    };
 }

package/dist/payment.js

@@ -7,8 +7,30 @@ exports.PaymentAPI = void 0;
 class PaymentAPI {
     constructor(http) {
         this.http = http;
-    }
-    /** 发起收费（内部路由 fiat/x402/a2a/batch/invite）。 */
+        /** 周期订阅扣费（基于已创建的 authorization）。 */
+        this.period = {
+            /** 扣减一个周期；返回 authorizationId 与扣费结果。 */
+            charge: (authorizationId) => this.http.post('/v1/payment/period/charge', { authorizationId }),
+            /** 查询周期授权状态（剩余额度 / 周期 / 状态）。 */
+            authorization: (authorizationId) => this.http.get('/v1/payment/period/authorization?authorizationId=' + encodeURIComponent(authorizationId)),
+        };
+        /** 托管（escrow）链上按量计费 / 退款。 */
+        this.escrow = {
+            /** relayer 代为签名扣费：`{chain, user, amountWei, reference}`。 */
+            charge: (p) => this.http.post('/v1/payment/escrow/charge', p),
+            /** relayer 代为签名退款：`{chain, user, amountWei, reference}`。 */
+            refund: (p) => this.http.post('/v1/payment/escrow/refund', p),
+            /** 查询托管余额（未配置链返回 `{configured:false, balanceWei:'0'}`）。 */
+            balance: (chain, user) => this.http.get('/v1/payment/escrow/balance?' + new URLSearchParams({ chain, user }).toString()),
+            /** 查询链上托管配置（地址 / 限额）。 */
+            info: (chain) => this.http.get('/v1/payment/escrow/info?chain=' + encodeURIComponent(chain)),
+            /** relayer gas 健康；不传 chain 返回全部已配置链。 */
+            relayerStatus: (chain) => this.http.get('/v1/payment/escrow/relayer-status' + (chain ? '?chain=' + encodeURIComponent(chain) : '')),
+            /** 核验 Solana 原生 SOL 充值并入账（幂等键 `sol:<signature>`）。 */
+            solanaVerify: (p) => this.http.post('/v1/payment/solana/verify', p),
+        };
+    }
+    /** 发起收费（内部路由 x402/a2a/batch/invite）。 */
     charge(params) {
         return this.http.post('/v1/payment/charge', params);
     }
@@ -61,15 +83,11 @@ class PaymentAPI {
     ledgerBalance(params) {
         return this.http.post('/v1/payment/ledger-balance', params);
     }
-    // ── 旧 index MCP 能力补齐：通道发现 / 链上意图 / 批量 / 邀请 / 转账 / MPP ──
+    // ── 旧 index MCP 能力补齐：通道发现 / 链上意图 / 批量 / 邀请 / 转账 ──
     /** 支付通道发现：启用的 rail、各链收款钱包 / 价格 / 托管、各链可接受的稳定币。 */
     info(chain) {
         return this.http.get('/v1/payment/info' + (chain ? '?chain=' + encodeURIComponent(chain) : ''));
     }
-    /** fiat 结账（Stripe）：返回 sessionUrl。mode=payment 为一次性扣款（默认订阅）。 */
-    checkout(params) {
-        return this.http.post('/v1/payment/checkout', params);
-    }
     /** 读取链上订阅详情（active / payToken / amountPaid / 周期 / 试用）。 */
     subscriptionDetail(chain, subscriber, resourceId) {
         return this.http.get('/v1/payment/subscription-detail/' + encodeURIComponent(chain) + '/' + encodeURIComponent(subscriber) + '/' + encodeURIComponent(String(resourceId)));
@@ -78,7 +96,10 @@ class PaymentAPI {
     price(planId, chain) {
         return this.http.get('/v1/payment/price?chain=' + encodeURIComponent(chain || 'bsc') + '&planId=' + encodeURIComponent(String(planId)));
     }
-    /** 创建 a2a 链上支付意图（phase 1）。 */
+    /**
+     * 创建 a2a 支付意图（phase 1）。
+     * `settlementMode: 'direct'` 时 `payee` 必填，settle 只核验 payer → payee 的链上转账。
+     */
     a2aCreate(params) {
         return this.http.post('/v1/payment/a2a', params);
     }
@@ -86,6 +107,14 @@ class PaymentAPI {
     a2aSettle(params) {
         return this.http.post('/v1/payment/a2a/settle', params);
     }
+    /** 结算 direct 意图（phase 2）：按 intent 绑定的 payee/asset/精确金额核验，并按链确认数判定终局。 */
+    a2aDirectSettle(paymentId, txHash) {
+        return this.http.post('/v1/payment/a2a/' + encodeURIComponent(paymentId) + '/settle', { txHash });
+    }
+    /** 取消未结算的 direct 意图（幂等）。 */
+    a2aCancel(paymentId) {
+        return this.http.post('/v1/payment/a2a/' + encodeURIComponent(paymentId) + '/cancel', {});
+    }
     /** 创建批量收款意图（一付款人对多收款人）。 */
     batchCreate(params) {
         return this.http.post('/v1/payment/batch', params);
@@ -149,29 +178,5 @@ class PaymentAPI {
     transferCancel(transferId) {
         return this.http.post('/v1/payment/transfers/' + encodeURIComponent(transferId) + '/cancel');
     }
-    /** 打开 MPP 支付通道（校验充值交易）。 */
-    mppOpen(params) {
-        return this.http.post('/v1/payment/mpp/open', params);
-    }
-    /** 提交 MPP 累计凭证（EIP-712 签名）。 */
-    mppVoucher(params) {
-        return this.http.post('/v1/payment/mpp/voucher', params);
-    }
-    /** 为 MPP 通道追加充值。 */
-    mppTopup(params) {
-        return this.http.post('/v1/payment/mpp/topup', params);
-    }
-    /** 批量结算 MPP 通道未结消费。 */
-    mppSettle(channelId) {
-        return this.http.post('/v1/payment/mpp/settle', { channelId });
-    }
-    /** 关闭 MPP 通道（先结算尾部）。 */
-    mppClose(channelId) {
-        return this.http.post('/v1/payment/mpp/close', { channelId });
-    }
-    /** 读取 MPP 通道当前状态。 */
-    mppSession(channelId) {
-        return this.http.get('/v1/payment/mpp/session?channelId=' + encodeURIComponent(channelId));
-    }
 }
 exports.PaymentAPI = PaymentAPI;

package/dist/types.d.ts

@@ -13,6 +13,8 @@ export interface KeelConfig {
     baseUrl?: string;
     /** Bearer API key（按模块订阅签发，`sk_<module>_*`） */
     apiKey?: string;
+    /** 租户级 `x-api-key`（WAAS 租户资源面：余额 / 流水 / 提现列表等）。 */
+    tenantApiKey?: string;
     /** 内部服务鉴权 key（`X-Service-Key`）；供网关服务级旁路放行可信内部组件（如 keel-mcp）。 */
     serviceKey?: string;
     /** 请求超时（ms），默认 30000 */

package/dist/wallet/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types';
+export * from './solana-account-types';
+export * from './solana-execution-types';
+export * from './mpc-types';
+export * from './wallet-api';

package/dist/wallet/index.js

@@ -0,0 +1,24 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// @keelcodes/sdk — wallet 模块
+// ---------------------------------------------------------------------------
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./solana-account-types"), exports);
+__exportStar(require("./solana-execution-types"), exports);
+__exportStar(require("./mpc-types"), exports);
+__exportStar(require("./wallet-api"), exports);

package/dist/wallet/mpc-types.d.ts

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

package/dist/wallet/mpc-types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/wallet/solana-account-types.d.ts

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

package/dist/wallet/solana-account-types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/wallet/solana-execution-types.d.ts

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

package/dist/wallet/solana-execution-types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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.d.ts → wallet/wallet-api.d.ts}

@@ -1,109 +1,8 @@
-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 WalletBalanceResult {
-    balance: 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;
-}
+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);
@@ -131,6 +30,27 @@ export declare class WalletAPI {
     /** 链上读写（读 + 广播统一，走 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 网关池状态（各链健康 / 活跃端点，脱敏）。 */
@@ -216,6 +136,32 @@ export declare class WalletAPI {
         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: {

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 {
@@ -56,6 +53,32 @@ class WalletAPI {
             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 = {
@@ -112,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": "1.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",