@keelcodes/sdk 2.1.3 → 2.3.0

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

@@ -1,6 +1,6 @@
 import { HttpClient } from '../http';
 import type { KeelEnvelope } from '../types';
-import type { CreateWalletParams, WalletCreated, ImportWalletParams, SignParams, SignResult, SendParams, SendResult, ChainParams, ChainResult, WalletBalanceParams, WalletBalanceResult } from './types';
+import type { CreateWalletParams, WalletCreated, ImportWalletParams, SignParams, SignResult, SendParams, SendResult, ChainParams, ChainResult, WalletBalanceParams, WalletBalanceResult, SessionCreateParams, SessionCreated, PaymasterInfo, PaymasterVoucherParams, PaymasterVoucher } 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, MpcRegisterParams, MpcRegisterResult, MpcSolanaSignParams, MpcSolanaSignResult, MpcSolanaSendParams, MpcSolanaSendResult } from './mpc-types';
@@ -134,9 +134,18 @@ export declare class WalletAPI {
         }) => Promise<unknown>;
     };
     session: {
-        create: (p: Record<string, unknown>) => Promise<unknown>;
+        /** 创建链上 session；传 `signer` 为客户自持 session key（relay 不生成、不落库私钥）。 */
+        create: (p: SessionCreateParams) => Promise<KeelEnvelope<SessionCreated>>;
         revoke: (sessionId: string) => Promise<unknown>;
         execute: (p: Record<string, unknown>) => Promise<unknown>;
+        /**
+         * KeelTokenPaymaster：gas 由 paymaster deposit 垫付，账户以稳定币结算（零 native）。
+         * `info` 用于发现配置；`voucher` 赞助「首笔 approve」（解决 allowance 循环依赖）。
+         */
+        paymaster: {
+            info: () => Promise<KeelEnvelope<PaymasterInfo>>;
+            voucher: (p: PaymasterVoucherParams) => Promise<KeelEnvelope<PaymasterVoucher>>;
+        };
         /** Solana（Squads Smart Account）：构建未签名交易 + 广播已签名交易。 */
         solana: {
             deriveAccount: (p: SolanaDeriveAccountParams) => Promise<SolanaDerivedAccount>;

package/dist/wallet/wallet-api.js

@@ -2,111 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WalletAPI = void 0;
 class WalletAPI {
+    http;
     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),
-            // ── Solana（Ed25519 / FROST 2-of-3）──────────────────────────────────
-            /**
-             * 签 Solana 交易 message **原文**（hex，可带 0x）。
-             * ⚠️ 不能传 32B 摘要：Solana 只认对原文的 Ed25519 签名（Ed25519ph 不被支持）。
-             * 返回 64B `R‖z`（128 hex，**无 0x**），无 `v` 恢复 id，用 `publicKey` 对账。
-             */
-            signSolana: (p) => this.http.post('/v1/wallet/mpc/solana/sign', p),
-            /** 广播 base64 编码的**已签名**交易（经 chain-rpc `sendTransaction` + `getSignatureStatuses`）。 */
-            sendSolanaTransaction: (p) => this.http.post('/v1/wallet/mpc/solana/send-transaction', p),
-        };
     }
     create(params) {
         return this.http.post('/v1/wallet/create', params);
@@ -172,5 +70,117 @@ class WalletAPI {
     batchProgress(batchId) {
         return this.http.get('/v1/wallet/batch/' + encodeURIComponent(batchId) + '/progress');
     }
+    /** Chain-RPC 子域：池状态 / 读套餐订阅面（canonical `/v1/wallet/chain/*`）。 */
+    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 }),
+        },
+    };
+    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),
+    };
+    session = {
+        /** 创建链上 session；传 `signer` 为客户自持 session key（relay 不生成、不落库私钥）。 */
+        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),
+        /**
+         * KeelTokenPaymaster：gas 由 paymaster deposit 垫付，账户以稳定币结算（零 native）。
+         * `info` 用于发现配置；`voucher` 赞助「首笔 approve」（解决 allowance 循环依赖）。
+         */
+        paymaster: {
+            info: () => this.http.get('/v1/wallet/session/paymaster/info'),
+            voucher: (p) => this.http.post('/v1/wallet/session/paymaster/voucher', 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/*`。 */
+    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),
+        // ── Solana（Ed25519 / FROST 2-of-3）──────────────────────────────────
+        /**
+         * 签 Solana 交易 message **原文**（hex，可带 0x）。
+         * ⚠️ 不能传 32B 摘要：Solana 只认对原文的 Ed25519 签名（Ed25519ph 不被支持）。
+         * 返回 64B `R‖z`（128 hex，**无 0x**），无 `v` 恢复 id，用 `publicKey` 对账。
+         */
+        signSolana: (p) => this.http.post('/v1/wallet/mpc/solana/sign', p),
+        /** 广播 base64 编码的**已签名**交易（经 chain-rpc `sendTransaction` + `getSignatureStatuses`）。 */
+        sendSolanaTransaction: (p) => this.http.post('/v1/wallet/mpc/solana/send-transaction', p),
+    };
 }
 exports.WalletAPI = WalletAPI;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keelcodes/sdk",
-  "version": "2.1.3",
+  "version": "2.3.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",
@@ -24,6 +24,10 @@
     "./account": {
       "types": "./dist/account.d.ts",
       "default": "./dist/account.js"
+    },
+    "./aa": {
+      "types": "./dist/aa/index.d.ts",
+      "default": "./dist/aa/index.js"
     }
   },
   "files": [
@@ -49,6 +53,9 @@
   ],
   "license": "MIT",
   "author": "Keel",
+  "dependencies": {
+    "viem": "^2.55.0"
+  },
   "devDependencies": {
     "typescript": "^5.0.0"
   }