@keelcodes/sdk 2.1.2 → 2.2.0

package/dist/http.d.ts

@@ -1,6 +1,6 @@
 import type { KeelConfig } from './types';
-/** SDK 版本（契约 §5，基线 2.1.2，随包版本同步）。 */
-export declare const SDK_VERSION = "2.1.2";
+/** SDK 版本（契约 §5，随包版本同步）。 */
+export declare const SDK_VERSION = "2.2.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，基线 2.1.2，随包版本同步）。 */
-exports.SDK_VERSION = '2.1.2';
+/** SDK 版本（契约 §5，随包版本同步）。 */
+exports.SDK_VERSION = '2.2.0';
 /**
  * 钱包签名的复用时长（ms）：首次签名后在该窗口内复用，避免每个请求都触发钱包弹窗。
  * 服务端会话 TTL 为 24h，此处取 1h 留足余量。

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

@@ -10,6 +10,56 @@ export interface MpcBalanceParams {
     chain?: string;
     tokenAddress?: string;
 }
+/** 注册参数：`curve='ed25519'` 时创建 Solana 钱包（可选 seed 导入存量私钥）。 */
+export interface MpcRegisterParams extends MpcVerifyParams {
+    /** 签名曲线，默认 `secp256k1`（EVM）。 */
+    curve?: 'secp256k1' | 'ed25519';
+    /** 仅 ed25519：32B 种子 hex（可带 0x）；导入后 base58 地址与导入前逐字节一致。 */
+    seed?: string;
+    walletAddress?: string;
+}
+/** 注册结果。 */
+export interface MpcRegisterResult {
+    walletId: string;
+    email: string;
+    /** EVM 为 0x 地址；ed25519 为 base58 地址。 */
+    walletAddress: string;
+    curve: string;
+    createdAt: string;
+}
+/** Solana 签名参数。 */
+export interface MpcSolanaSignParams {
+    token: string;
+    /** Solana 交易 message **原文**（hex，可带 0x），不是 32B 摘要（Ed25519ph 不被 Solana 支持）。 */
+    message: string;
+    /** 2-of-3 选片，默认 1。 */
+    partnerIndex?: number;
+}
+/** Solana 签名结果（Ed25519 无 `v` 恢复 id）。 */
+export interface MpcSolanaSignResult {
+    curve: 'ed25519';
+    /** 64B `R‖z`，128 hex，无 0x。 */
+    signature: string;
+    publicKey: string;
+    address: string;
+}
+/** Solana 广播参数。 */
+export interface MpcSolanaSendParams {
+    token: string;
+    /** base64 编码的**已签名**交易（交易构建与签名组装由客户端完成）。 */
+    transaction: string;
+    /** 是否等待确认，默认 true。 */
+    wait?: boolean;
+}
+/** Solana 广播结果。 */
+export interface MpcSolanaSendResult {
+    chain: 'solana';
+    txHash: string | null;
+    from: string;
+    confirmed: boolean;
+    reason: string | null;
+    signatureStatus: string | null;
+}
 export interface MpcSignMessageParams {
     token: string;
     message: string;

package/dist/wallet/types.d.ts

@@ -48,6 +48,45 @@ export interface ChainResult {
     result?: unknown;
     txHash?: string;
 }
+/** session key 托管模式：`client` = 客户自持（relay 不生成、不落库私钥）；`relay` = relay 生成并持久化。 */
+export type SessionKeyCustody = 'client' | 'relay';
+export interface SessionCreateParams {
+    chain: string;
+    /** 智能账户 owner EOA 地址。 */
+    owner: string;
+    /** 权限声明（由链上 session validator 解释）。 */
+    permissions: Array<Record<string, unknown>>;
+    /** 生效截止时间（Unix 秒）。 */
+    validUntil: number;
+    /** 生效起始时间（Unix 秒，缺省 0）。 */
+    validAfter?: number;
+    /** 客户自持的 session key 地址；传入则 relay 不生成、不落库私钥（`/execute` 不可用）。 */
+    signer?: string;
+    /** 租户/产品标识，缺省 `default`。 */
+    product?: string;
+}
+export interface SessionCreated {
+    product: string;
+    accountAddress: string;
+    isDeployed: boolean;
+    isBound: boolean;
+    sessionId: string;
+    /** session key 地址（自持模式即传入的 `signer`）。 */
+    signer: string;
+    /** 仅 `keyCustody: 'relay'` 返回私钥；客户自持模式为 `null`。 */
+    sessionKey: string | null;
+    keyCustody: SessionKeyCustody;
+    /** 十进制字符串（Unix 秒）。 */
+    validAfter: string;
+    /** 十进制字符串（Unix 秒）。 */
+    validUntil: string;
+    permissions: unknown[];
+    /** 链上 validator 副本槽位。 */
+    slot: number;
+    moduleVersion: string;
+    /** owner 侧启用 session 的 calldata。 */
+    enableCallData: string;
+}
 export interface WalletBalanceParams {
     address: string;
     chain?: string;

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

@@ -1,8 +1,9 @@
 import { HttpClient } from '../http';
-import type { CreateWalletParams, WalletCreated, ImportWalletParams, SignParams, SignResult, SendParams, SendResult, ChainParams, ChainResult, WalletBalanceParams, WalletBalanceResult } from './types';
+import type { KeelEnvelope } from '../types';
+import type { CreateWalletParams, WalletCreated, ImportWalletParams, SignParams, SignResult, SendParams, SendResult, ChainParams, ChainResult, WalletBalanceParams, WalletBalanceResult, SessionCreateParams, SessionCreated } 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';
+import type { MpcSendCodeParams, MpcVerifyParams, MpcBalanceParams, MpcSignMessageParams, MpcSignTypedDataParams, MpcSendTransactionParams, MpcContractCallParams, MpcContractWriteParams, MpcGasEstimateParams, MpcRegisterParams, MpcRegisterResult, MpcSolanaSignParams, MpcSolanaSignResult, MpcSolanaSendParams, MpcSolanaSendResult } from './mpc-types';
 export declare class WalletAPI {
     private http;
     constructor(http: HttpClient);
@@ -133,7 +134,8 @@ 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>;
         /** Solana（Squads Smart Account）：构建未签名交易 + 广播已签名交易。 */
@@ -166,7 +168,7 @@ export declare class WalletAPI {
     /** MPC（email 分片钱包）子域：canonical `/v1/wallet/mpc/*`。 */
     mpc: {
         sendCode: (p: MpcSendCodeParams) => Promise<unknown>;
-        register: (p: MpcVerifyParams) => Promise<unknown>;
+        register: (p: MpcRegisterParams) => Promise<KeelEnvelope<MpcRegisterResult>>;
         recover: (p: MpcVerifyParams) => Promise<unknown>;
         status: (email: string) => Promise<unknown>;
         wallets: (email?: string) => Promise<unknown>;
@@ -182,5 +184,13 @@ export declare class WalletAPI {
         contractRead: (p: MpcContractCallParams) => Promise<unknown>;
         contractWrite: (p: MpcContractWriteParams) => Promise<unknown>;
         gasEstimate: (p: MpcGasEstimateParams) => Promise<unknown>;
+        /**
+         * 签 Solana 交易 message **原文**（hex，可带 0x）。
+         * ⚠️ 不能传 32B 摘要：Solana 只认对原文的 Ed25519 签名（Ed25519ph 不被支持）。
+         * 返回 64B `R‖z`（128 hex，**无 0x**），无 `v` 恢复 id，用 `publicKey` 对账。
+         */
+        signSolana: (p: MpcSolanaSignParams) => Promise<KeelEnvelope<MpcSolanaSignResult>>;
+        /** 广播 base64 编码的**已签名**交易（经 chain-rpc `sendTransaction` + `getSignatureStatuses`）。 */
+        sendSolanaTransaction: (p: MpcSolanaSendParams) => Promise<KeelEnvelope<MpcSolanaSendResult>>;
     };
 }

package/dist/wallet/wallet-api.js

@@ -50,6 +50,7 @@ class WalletAPI {
             riskCheck: (p) => this.http.post('/v1/wallet/safe/risk/check', p),
         };
         this.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),
@@ -97,6 +98,15 @@ class WalletAPI {
             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) {

package/package.json

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