@keelcodes/sdk 2.1.1 → 2.1.3

package/dist/account.d.ts

@@ -1,5 +1,5 @@
 import { HttpClient } from './http';
-import type { KeelModule } from './types';
+import type { KeelEnvelope, KeelModule } from './types';
 export interface TenantCreateParams {
     name: string;
     metadata?: Record<string, unknown>;
@@ -10,14 +10,24 @@ export interface TenantResult {
     apiKey: string;
 }
 export interface ApikeyCreateParams {
-    tenantId: string;
     module: KeelModule;
-    /** 幂等键（同 reference 不重复签发）。 */
-    reference?: string;
+    /** 幂等键（同 reference 不重复签发）。必填，≤100 字符。 */
+    reference: string;
+    /** 可选备注名。 */
+    name?: string;
+    /** @deprecated 租户由钱包签名解析，服务端忽略该字段；保留仅为兼容旧调用。 */
+    tenantId?: string;
 }
 export interface ApikeyResult {
-    apiKey: string;
+    /** key id（撤销 / 轮换用，非明文）。 */
+    id: string;
     module: KeelModule;
+    /** 首次签发明文；命中 reference 幂等时为 null。 */
+    apiKey: string | null;
+    /** 掩码后的 key（幂等重放时用于识别）。 */
+    apiKeyMasked?: string;
+    /** true 表示命中幂等，未重新签发。 */
+    reused?: boolean;
 }
 export interface SubscriptionParams {
     module: KeelModule;
@@ -39,7 +49,7 @@ export declare class AccountAPI {
     };
     /** 按模块签发 key（用户订阅哪个模块，就为哪个模块签发）。 */
     apikey: {
-        create: (p: ApikeyCreateParams) => Promise<ApikeyResult>;
+        create: (p: ApikeyCreateParams) => Promise<KeelEnvelope<ApikeyResult>>;
         /** 撤销 key；`id` 为 `GET /v1/account/apikey` 返回的 key id（非明文）。 */
         revoke: (id: string) => Promise<unknown>;
     };

package/dist/http.d.ts

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

package/dist/index.d.ts

@@ -4,7 +4,7 @@ import { DataAPI } from './data';
 import { AccountAPI } from './account';
 import type { KeelConfig } from './types';
 export { KeelApiError, isKeelApiError } from './errors';
-export type { KeelConfig, KeelModule, KeelErrorBody, KeelWalletAuth } from './types';
+export type { KeelConfig, KeelModule, KeelErrorBody, KeelWalletAuth, KeelEnvelope } from './types';
 export declare class Keel {
     readonly payment: PaymentAPI;
     readonly wallet: WalletAPI;

package/dist/types.d.ts

@@ -22,6 +22,12 @@ export interface KeelConfig {
     /** 钱包签名鉴权；设置后自动附加 x-wallet-address/signature/timestamp 请求头。 */
     wallet?: KeelWalletAuth;
 }
+/** 统一信封（WAAS / MPC / Vault / aa-relay / data 自助面 2xx 响应）。 */
+export interface KeelEnvelope<T> {
+    code: number | string;
+    message: string;
+    data: T;
+}
 /** 统一错误体（契约 §3）。 */
 export interface KeelErrorBody {
     code: string;

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

@@ -1,8 +1,9 @@
 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 { 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);
@@ -166,7 +167,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 +183,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

@@ -97,6 +97,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.1",
+  "version": "2.1.3",
   "description": "Keel SDK — unified access to payment / wallet / data / account modules over https://keel.codes",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",