@keelcodes/sdk 2.1.3 → 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/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,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 } 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,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）：构建未签名交易 + 广播已签名交易。 */

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),

package/package.json

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