@keelcodes/sdk 1.0.0 → 2.0.0

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.0.0，随包版本同步）。 */
+export declare const SDK_VERSION = "2.0.0";
 export declare class HttpClient {
     private baseUrl;
     private headers;

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.0.0，随包版本同步）。 */
+exports.SDK_VERSION = '2.0.0';
 /**
  * 钱包签名的复用时长（ms）：首次签名后在该窗口内复用，避免每个请求都触发钱包弹窗。
  * 服务端会话 TTL 为 24h，此处取 1h 留足余量。

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,4 @@ 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>>;
 }

package/dist/payment.js

@@ -8,7 +8,7 @@ class PaymentAPI {
     constructor(http) {
         this.http = http;
     }
-    /** 发起收费（内部路由 fiat/x402/a2a/batch/invite）。 */
+    /** 发起收费（内部路由 x402/a2a/batch/invite）。 */
     charge(params) {
         return this.http.post('/v1/payment/charge', params);
     }
@@ -61,15 +61,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 +74,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 +85,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 +156,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/wallet.d.ts

@@ -54,8 +54,232 @@ export interface WalletBalanceParams {
     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 {
-    balance: string;
+    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;
@@ -216,6 +440,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

@@ -56,6 +56,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 = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keelcodes/sdk",
-  "version": "1.0.0",
+  "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",