@keelcodes/sdk 2.1.3 → 2.3.0

package/dist/aa/x402.js

@@ -0,0 +1,185 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// x402 v2 客户端：解 challenge / 选 accept / 组 EIP-712 / 出 PAYMENT-SIGNATURE
+//
+// 与 payments 服务端（`protocol/x402-v2.ts`）逐字段对齐：
+//   domain = { name:'x402', version:'2', chainId, verifyingContract: payTo }
+//   types  = Payment{ scheme, network, amount, asset, payTo, method, url, salt, txHash }
+//   header = base64(JSON({ x402Version, resource, accepted, payload:{method,url,salt,txHash}, signature }))
+//
+// 两条用法：
+//   1. 自己已有 txHash（例如用 session key / 任意钱包先发了转账）→ `buildX402Payment` +
+//      `buildX402TypedData` + `encodePaymentSignature`
+//   2. 由 SDK 驱动付款（回调里发 tx）→ `payX402`
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.X402_TYPES = exports.X402_DOMAIN_VERSION = exports.X402_DOMAIN_NAME = void 0;
+exports.decodePaymentRequired = decodePaymentRequired;
+exports.selectX402Accept = selectX402Accept;
+exports.buildX402Payment = buildX402Payment;
+exports.buildX402TypedData = buildX402TypedData;
+exports.encodePaymentSignature = encodePaymentSignature;
+exports.buildX402Payload = buildX402Payload;
+exports.payX402 = payX402;
+exports.toX402Salt = toX402Salt;
+exports.toBase64 = toBase64;
+const viem_1 = require("viem");
+const TRANSFER_ABI = [
+    {
+        type: 'function',
+        name: 'transfer',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'to', type: 'address' },
+            { name: 'amount', type: 'uint256' },
+        ],
+        outputs: [{ name: '', type: 'bool' }],
+    },
+];
+exports.X402_DOMAIN_NAME = 'x402';
+exports.X402_DOMAIN_VERSION = '2';
+exports.X402_TYPES = {
+    Payment: [
+        { name: 'scheme', type: 'string' },
+        { name: 'network', type: 'string' },
+        { name: 'amount', type: 'string' },
+        { name: 'asset', type: 'address' },
+        { name: 'payTo', type: 'address' },
+        { name: 'method', type: 'string' },
+        { name: 'url', type: 'string' },
+        { name: 'salt', type: 'string' },
+        { name: 'txHash', type: 'string' },
+    ],
+};
+/** 解 `PAYMENT-REQUIRED` 头（base64 或直接 JSON）。 */
+function decodePaymentRequired(header) {
+    const raw = header.trim();
+    const text = raw.startsWith('{') ? raw : fromBase64(raw);
+    const parsed = JSON.parse(text);
+    if (parsed?.x402Version !== 2 || !Array.isArray(parsed.accepts) || parsed.accepts.length === 0) {
+        throw new Error('[keel-sdk] PAYMENT-REQUIRED is not a valid x402 v2 challenge');
+    }
+    return parsed;
+}
+/** 选 accept：优先 exact，其次按传入的 asset / network 过滤。 */
+function selectX402Accept(challenge, opts = {}) {
+    const matches = challenge.accepts.filter((a) => (opts.asset === undefined || a.asset.toLowerCase() === opts.asset.toLowerCase()) &&
+        (opts.network === undefined || a.network === opts.network));
+    const pick = matches.find((a) => a.scheme === 'exact') ?? matches[0];
+    if (!pick)
+        throw new Error('[keel-sdk] no x402 accept matches the requested asset/network');
+    return pick;
+}
+/** 按 accept 组装链上付款参数（native 转账或 ERC20 transfer）。 */
+function buildX402Payment(accept) {
+    const amount = BigInt(accept.amount);
+    if (amount <= 0n)
+        throw new Error('[keel-sdk] x402 amount must be > 0');
+    const asset = accept.asset;
+    const payTo = accept.payTo;
+    const isNative = /^0x0{40}$/i.test(asset);
+    if (isNative)
+        return { to: payTo, value: amount, data: '0x', asset };
+    return {
+        to: asset,
+        value: 0n,
+        data: (0, viem_1.encodeFunctionData)({
+            abi: TRANSFER_ABI,
+            functionName: 'transfer',
+            args: [payTo, amount],
+        }),
+        asset,
+    };
+}
+/** 构造待签的 EIP-712 结构（必须与 payments 侧逐字段一致）。 */
+function buildX402TypedData(payload) {
+    const { accepted } = payload;
+    const chainId = Number(accepted.network.replace('eip155:', ''));
+    if (!Number.isInteger(chainId) || chainId <= 0) {
+        throw new Error(`[keel-sdk] unsupported x402 network: ${accepted.network}`);
+    }
+    return {
+        domain: {
+            name: exports.X402_DOMAIN_NAME,
+            version: exports.X402_DOMAIN_VERSION,
+            chainId,
+            verifyingContract: accepted.payTo,
+        },
+        types: exports.X402_TYPES,
+        primaryType: 'Payment',
+        message: {
+            scheme: accepted.scheme,
+            network: accepted.network,
+            amount: accepted.amount,
+            asset: accepted.asset,
+            payTo: accepted.payTo,
+            method: payload.payload.method,
+            url: payload.payload.url,
+            salt: payload.payload.salt,
+            txHash: payload.payload.txHash,
+        },
+    };
+}
+/**
+ * 已有签名时组装 `PAYMENT-SIGNATURE` 头（base64）。
+ * 配合 {@link buildX402TypedData} + `wallet.signTypedData` 用于纯 EOA 客户端。
+ */
+function encodePaymentSignature(payload) {
+    return toBase64(JSON.stringify(payload));
+}
+/** 由链上付款结果构造未签名的 payload（salt 缺省自动派生）。 */
+function buildX402Payload(args) {
+    return {
+        x402Version: 2,
+        resource: args.challenge.resource,
+        accepted: args.accepted,
+        payload: {
+            method: args.method ?? 'GET',
+            url: args.url ?? args.challenge.resource?.url ?? '',
+            salt: args.salt ??
+                (0, viem_1.keccak256)((0, viem_1.stringToHex)(`${args.txHash}:${Date.now()}:${Math.random().toString(36).slice(2)}`)),
+            txHash: args.txHash,
+        },
+        signature: '0x',
+    };
+}
+/**
+ * 完成一次 x402 付款：发起链上支付 → 等确认 → 构造并签名 PaymentPayload。
+ * @returns `header` 可直接写入 `PAYMENT-SIGNATURE`。
+ */
+async function payX402(params) {
+    const accept = params.accept ?? selectX402Accept(params.challenge);
+    const payment = buildX402Payment(accept);
+    const txHash = await params.sendPayment(payment);
+    if (!/^0x[0-9a-fA-F]{64}$/.test(txHash)) {
+        throw new Error(`[keel-sdk] sendPayment must return a tx hash, got ${txHash}`);
+    }
+    if (params.waitForTransaction)
+        await params.waitForTransaction(txHash);
+    const unsigned = buildX402Payload({
+        challenge: params.challenge,
+        accepted: accept,
+        txHash,
+        method: params.method,
+        url: params.url,
+        salt: params.salt,
+    });
+    unsigned.signature = await params.signTypedData(buildX402TypedData(unsigned));
+    return { header: encodePaymentSignature(unsigned), payload: unsigned, txHash, payment };
+}
+/** 供调试：把任意 32 字节值转成 x402 salt 形态 */
+function toX402Salt(value) {
+    return (0, viem_1.toHex)(BigInt(value), { size: 32 });
+}
+function toBase64(text) {
+    const bytes = new TextEncoder().encode(text);
+    let binary = '';
+    for (const b of bytes)
+        binary += String.fromCharCode(b);
+    return btoa(binary);
+}
+function fromBase64(encoded) {
+    const binary = atob(encoded);
+    const bytes = Uint8Array.from(binary, (c) => c.charCodeAt(0));
+    return new TextDecoder().decode(bytes);
+}

package/dist/account.js

@@ -5,24 +5,25 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AccountAPI = void 0;
 class AccountAPI {
+    http;
     constructor(http) {
         this.http = http;
-        this.tenant = {
-            create: (p) => this.http.post('/v1/account/tenant', p),
-            get: (tenantId) => this.http.get('/v1/account/tenant/' + encodeURIComponent(tenantId)),
-        };
-        /** 按模块签发 key（用户订阅哪个模块，就为哪个模块签发）。 */
-        this.apikey = {
-            create: (p) => this.http.post('/v1/account/apikey', p),
-            /** 撤销 key；`id` 为 `GET /v1/account/apikey` 返回的 key id（非明文）。 */
-            revoke: (id) => this.http.post('/v1/account/apikey/revoke', { id }),
-        };
-        this.subscription = {
-            get: (module) => this.http.get('/v1/account/subscription?module=' + module),
-            subscribe: (p) => this.http.post('/v1/account/subscription', p),
-            cancel: (module) => this.http.post('/v1/account/subscription/cancel', { module }),
-        };
     }
+    tenant = {
+        create: (p) => this.http.post('/v1/account/tenant', p),
+        get: (tenantId) => this.http.get('/v1/account/tenant/' + encodeURIComponent(tenantId)),
+    };
+    /** 按模块签发 key（用户订阅哪个模块，就为哪个模块签发）。 */
+    apikey = {
+        create: (p) => this.http.post('/v1/account/apikey', p),
+        /** 撤销 key；`id` 为 `GET /v1/account/apikey` 返回的 key id（非明文）。 */
+        revoke: (id) => this.http.post('/v1/account/apikey/revoke', { id }),
+    };
+    subscription = {
+        get: (module) => this.http.get('/v1/account/subscription?module=' + module),
+        subscribe: (p) => this.http.post('/v1/account/subscription', p),
+        cancel: (module) => this.http.post('/v1/account/subscription/cancel', { module }),
+    };
     /** 创建提现（钱包签名；启用 TOTP 时需带 `totpCode`）。 */
     withdraw(p) {
         return this.http.post('/v1/account/withdraw', p);

package/dist/data.js

@@ -5,89 +5,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DataAPI = void 0;
 class DataAPI {
+    http;
     constructor(http) {
         this.http = http;
-        /** 用户级数据 Key 自助管理（钱包签名；网关另需 `sk_data_*`）。 */
-        this.myKeys = {
-            /** 列出当前钱包持有的 key（不含明文）。 */
-            list: () => this.http.get('/v1/data/my-keys'),
-            /** 创建 key：`{label, scope?, rate_limit?}`；明文仅本次返回。 */
-            create: (p) => this.http.post('/v1/data/my-keys', p),
-            /** 用一次性认领码换取 key 明文（仅一次可见）。 */
-            claim: (claimCode) => this.http.post('/v1/data/my-keys/claim', { claim_code: claimCode }),
-            /** 轮换 key，返回新的明文。 */
-            rotate: (keyId) => this.http.post('/v1/data/my-keys/' + encodeURIComponent(String(keyId)) + '/rotate'),
-            /** 删除 key。 */
-            remove: (keyId) => this.http.delete('/v1/data/my-keys/' + encodeURIComponent(String(keyId))),
-        };
-        // ── Market 子域（DEX 行情 / 监控 / 订阅）：canonical `/v1/data/market*` ──
-        this.market = {
-            /** 按名称/符号搜索 DEX 代币（DexScreener）。 */
-            search: (p) => {
-                const q = new URLSearchParams({ keyword: p.keyword });
-                if (p.chainIndex)
-                    q.set('chainIndex', p.chainIndex);
-                if (p.limit)
-                    q.set('limit', p.limit);
-                return this.http.get('/v1/data/market/token-search?' + q.toString());
-            },
-            /** 热门 DEX 池（GeckoTerminal trending）。 */
-            hot: (p = {}) => {
-                const q = new URLSearchParams();
-                if (p.chainIndex)
-                    q.set('chainIndex', p.chainIndex);
-                if (p.limit)
-                    q.set('limit', p.limit);
-                return this.http.get('/v1/data/market/hot-tokens?' + q.toString());
-            },
-            /** K 线（OHLCV）。 */
-            candles: (p) => {
-                const q = new URLSearchParams({ chainIndex: p.chainIndex, tokenAddress: p.tokenAddress });
-                if (p.period)
-                    q.set('period', p.period);
-                if (p.limit)
-                    q.set('limit', p.limit);
-                return this.http.get('/v1/data/market/candles?' + q.toString());
-            },
-            /** 实时 DEX 价。 */
-            price: (p) => this.http.get('/v1/data/market/price?' + new URLSearchParams({ chainIndex: p.chainIndex, tokenAddress: p.tokenAddress }).toString()),
-            /** 加入监控列表（自动采集 K 线 / 快照）。 */
-            trackToken: (p) => this.http.post('/v1/data/market/tracked-tokens', p),
-            /** 列出监控中的代币。 */
-            listTracked: (chain) => this.http.get('/v1/data/market/tracked-tokens' + (chain ? '?chain=' + encodeURIComponent(chain) : '')),
-            /** 注册自定义事件签名（topicHash + eventType，可选 ABI）。 */
-            registerEvent: (p) => this.http.post('/v1/data/market/custom-sigs', p),
-            /** Market 订阅套餐价目（公开）。 */
-            subscriptionPlans: () => this.http.get('/v1/data/market-subscription/plans'),
-            /** 发起 Market 订阅支付（免费即时生效；付费返支付意图）。 */
-            subscriptionCheckout: (p) => this.http.post('/v1/data/market-subscription/checkout', p),
-            /** 轮询 Market 订阅支付状态。 */
-            subscriptionPaymentCheck: (p = {}) => this.http.post('/v1/data/market-subscription/payment-check', p),
-            /** 确认 Market 订阅的 x402 支付（提交 txHash）。 */
-            subscriptionVerify: (p) => this.http.post('/v1/data/market-subscription/verify', p),
-            /** 读取 Market 订阅用量。 */
-            subscriptionUsage: () => this.http.get('/v1/data/market-subscription/usage'),
-        };
-        // ── Factor 工厂（因子挖掘）：canonical `/v1/data/factor-factory/*`（由 ml-service 承载）──
-        this.factorFactory = {
-            /** 创建因子挖掘任务（结构化 preferences/constraints/formulas；intent 走 LLM 解析）。返回 job_id。 */
-            start: (p = {}) => {
-                const body = { preferences: p.preferences ?? {}, constraints: p.constraints ?? {} };
-                if (p.formulas?.length)
-                    body.formulas = p.formulas;
-                return p.intent
-                    ? this.http.post('/v1/data/factor-factory/mine', { ...body, intent: p.intent })
-                    : this.http.post('/v1/data/factor-factory/start', body);
-            },
-            /** 查询挖掘任务状态（含 stage 细分：pool/eval/select/persist）。 */
-            status: (jobId) => this.http.get('/v1/data/factor-factory/status?job_id=' + encodeURIComponent(jobId)),
-            /** 查询挖掘任务结果（合格因子列表 + 统计）。 */
-            result: (jobId) => this.http.get('/v1/data/factor-factory/result?job_id=' + encodeURIComponent(jobId)),
-            /** 最近挖掘任务列表。 */
-            list: (limit) => this.http.get('/v1/data/factor-factory/list' + (limit ? '?limit=' + limit : '')),
-            /** 取消挖掘任务（排队/运行中可取消）。 */
-            cancel: (jobId) => this.http.post('/v1/data/factor-factory/cancel?job_id=' + encodeURIComponent(jobId)),
-        };
     }
     bars(params) {
         const q = new URLSearchParams({ symbol: params.symbol });
@@ -171,6 +91,19 @@ class DataAPI {
         }
         return this.http.stream('/v1/data/stream?' + q.toString());
     }
+    /** 用户级数据 Key 自助管理（钱包签名；网关另需 `sk_data_*`）。 */
+    myKeys = {
+        /** 列出当前钱包持有的 key（不含明文）。 */
+        list: () => this.http.get('/v1/data/my-keys'),
+        /** 创建 key：`{label, scope?, rate_limit?}`；明文仅本次返回。 */
+        create: (p) => this.http.post('/v1/data/my-keys', p),
+        /** 用一次性认领码换取 key 明文（仅一次可见）。 */
+        claim: (claimCode) => this.http.post('/v1/data/my-keys/claim', { claim_code: claimCode }),
+        /** 轮换 key，返回新的明文。 */
+        rotate: (keyId) => this.http.post('/v1/data/my-keys/' + encodeURIComponent(String(keyId)) + '/rotate'),
+        /** 删除 key。 */
+        remove: (keyId) => this.http.delete('/v1/data/my-keys/' + encodeURIComponent(String(keyId))),
+    };
     // ── 行情 / 符号 / 快照（旧 hub MCP 能力）──
     /** 取单符号最新行情（ticker）。 */
     ticker(symbol) {
@@ -274,5 +207,73 @@ class DataAPI {
     subscriptionUsage(walletAddress) {
         return this.http.get('/v1/data/usage', { 'x-wallet-address': walletAddress });
     }
+    // ── Market 子域（DEX 行情 / 监控 / 订阅）：canonical `/v1/data/market*` ──
+    market = {
+        /** 按名称/符号搜索 DEX 代币（DexScreener）。 */
+        search: (p) => {
+            const q = new URLSearchParams({ keyword: p.keyword });
+            if (p.chainIndex)
+                q.set('chainIndex', p.chainIndex);
+            if (p.limit)
+                q.set('limit', p.limit);
+            return this.http.get('/v1/data/market/token-search?' + q.toString());
+        },
+        /** 热门 DEX 池（GeckoTerminal trending）。 */
+        hot: (p = {}) => {
+            const q = new URLSearchParams();
+            if (p.chainIndex)
+                q.set('chainIndex', p.chainIndex);
+            if (p.limit)
+                q.set('limit', p.limit);
+            return this.http.get('/v1/data/market/hot-tokens?' + q.toString());
+        },
+        /** K 线（OHLCV）。 */
+        candles: (p) => {
+            const q = new URLSearchParams({ chainIndex: p.chainIndex, tokenAddress: p.tokenAddress });
+            if (p.period)
+                q.set('period', p.period);
+            if (p.limit)
+                q.set('limit', p.limit);
+            return this.http.get('/v1/data/market/candles?' + q.toString());
+        },
+        /** 实时 DEX 价。 */
+        price: (p) => this.http.get('/v1/data/market/price?' + new URLSearchParams({ chainIndex: p.chainIndex, tokenAddress: p.tokenAddress }).toString()),
+        /** 加入监控列表（自动采集 K 线 / 快照）。 */
+        trackToken: (p) => this.http.post('/v1/data/market/tracked-tokens', p),
+        /** 列出监控中的代币。 */
+        listTracked: (chain) => this.http.get('/v1/data/market/tracked-tokens' + (chain ? '?chain=' + encodeURIComponent(chain) : '')),
+        /** 注册自定义事件签名（topicHash + eventType，可选 ABI）。 */
+        registerEvent: (p) => this.http.post('/v1/data/market/custom-sigs', p),
+        /** Market 订阅套餐价目（公开）。 */
+        subscriptionPlans: () => this.http.get('/v1/data/market-subscription/plans'),
+        /** 发起 Market 订阅支付（免费即时生效；付费返支付意图）。 */
+        subscriptionCheckout: (p) => this.http.post('/v1/data/market-subscription/checkout', p),
+        /** 轮询 Market 订阅支付状态。 */
+        subscriptionPaymentCheck: (p = {}) => this.http.post('/v1/data/market-subscription/payment-check', p),
+        /** 确认 Market 订阅的 x402 支付（提交 txHash）。 */
+        subscriptionVerify: (p) => this.http.post('/v1/data/market-subscription/verify', p),
+        /** 读取 Market 订阅用量。 */
+        subscriptionUsage: () => this.http.get('/v1/data/market-subscription/usage'),
+    };
+    // ── Factor 工厂（因子挖掘）：canonical `/v1/data/factor-factory/*`（由 ml-service 承载）──
+    factorFactory = {
+        /** 创建因子挖掘任务（结构化 preferences/constraints/formulas；intent 走 LLM 解析）。返回 job_id。 */
+        start: (p = {}) => {
+            const body = { preferences: p.preferences ?? {}, constraints: p.constraints ?? {} };
+            if (p.formulas?.length)
+                body.formulas = p.formulas;
+            return p.intent
+                ? this.http.post('/v1/data/factor-factory/mine', { ...body, intent: p.intent })
+                : this.http.post('/v1/data/factor-factory/start', body);
+        },
+        /** 查询挖掘任务状态（含 stage 细分：pool/eval/select/persist）。 */
+        status: (jobId) => this.http.get('/v1/data/factor-factory/status?job_id=' + encodeURIComponent(jobId)),
+        /** 查询挖掘任务结果（合格因子列表 + 统计）。 */
+        result: (jobId) => this.http.get('/v1/data/factor-factory/result?job_id=' + encodeURIComponent(jobId)),
+        /** 最近挖掘任务列表。 */
+        list: (limit) => this.http.get('/v1/data/factor-factory/list' + (limit ? '?limit=' + limit : '')),
+        /** 取消挖掘任务（排队/运行中可取消）。 */
+        cancel: (jobId) => this.http.post('/v1/data/factor-factory/cancel?job_id=' + encodeURIComponent(jobId)),
+    };
 }
 exports.DataAPI = DataAPI;

package/dist/errors.js

@@ -7,6 +7,10 @@ exports.KeelApiError = void 0;
 exports.isKeelApiError = isKeelApiError;
 /** 引擎返回非 2xx 时抛出。`status` 为 HTTP 状态码，`code` 为契约错误码。 */
 class KeelApiError extends Error {
+    path;
+    status;
+    code;
+    body;
     constructor(path, status, code, body) {
         super(`[keel-sdk] ${path} ${status} (${code}): ${body?.message ?? 'request failed'}`);
         this.path = path;

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.3.0";
 export declare class HttpClient {
     private baseUrl;
     private headers;

package/dist/http.js

@@ -5,14 +5,19 @@
 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.3.0';
 /**
  * 钱包签名的复用时长（ms）：首次签名后在该窗口内复用，避免每个请求都触发钱包弹窗。
  * 服务端会话 TTL 为 24h，此处取 1h 留足余量。
  */
 const WALLET_TOKEN_TTL_MS = 60 * 60 * 1000;
 class HttpClient {
+    baseUrl;
+    headers;
+    timeout;
+    wallet;
+    walletToken;
     constructor(config = {}) {
         this.baseUrl = (config.baseUrl ?? 'https://keel.codes').replace(/\/+$/, '');
         this.timeout = config.timeout ?? 30000;

package/dist/index.d.ts

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

package/dist/index.js

@@ -6,6 +6,20 @@
 //   import { Keel } from '@keelcodes/sdk'                 // 全家桶
 //   import { PaymentAPI } from '@keelcodes/sdk/payment'    // 按域 tree-shaking
 // ---------------------------------------------------------------------------
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Keel = exports.isKeelApiError = exports.KeelApiError = void 0;
 const http_1 = require("./http");
@@ -16,7 +30,13 @@ const account_1 = require("./account");
 var errors_1 = require("./errors");
 Object.defineProperty(exports, "KeelApiError", { enumerable: true, get: function () { return errors_1.KeelApiError; } });
 Object.defineProperty(exports, "isKeelApiError", { enumerable: true, get: function () { return errors_1.isKeelApiError; } });
+__exportStar(require("./aa"), exports);
 class Keel {
+    payment;
+    wallet;
+    data;
+    account;
+    http;
     constructor(config = {}) {
         this.http = new http_1.HttpClient(config);
         this.payment = new payment_1.PaymentAPI(this.http);

package/dist/payment.js

@@ -5,30 +5,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PaymentAPI = void 0;
 class PaymentAPI {
+    http;
     constructor(http) {
         this.http = http;
-        /** 周期订阅扣费（基于已创建的 authorization）。 */
-        this.period = {
-            /** 扣减一个周期；返回 authorizationId 与扣费结果。 */
-            charge: (authorizationId) => this.http.post('/v1/payment/period/charge', { authorizationId }),
-            /** 查询周期授权状态（剩余额度 / 周期 / 状态）。 */
-            authorization: (authorizationId) => this.http.get('/v1/payment/period/authorization?authorizationId=' + encodeURIComponent(authorizationId)),
-        };
-        /** 托管（escrow）链上按量计费 / 退款。 */
-        this.escrow = {
-            /** relayer 代为签名扣费：`{chain, user, amountWei, reference}`。 */
-            charge: (p) => this.http.post('/v1/payment/escrow/charge', p),
-            /** relayer 代为签名退款：`{chain, user, amountWei, reference}`。 */
-            refund: (p) => this.http.post('/v1/payment/escrow/refund', p),
-            /** 查询托管余额（未配置链返回 `{configured:false, balanceWei:'0'}`）。 */
-            balance: (chain, user) => this.http.get('/v1/payment/escrow/balance?' + new URLSearchParams({ chain, user }).toString()),
-            /** 查询链上托管配置（地址 / 限额）。 */
-            info: (chain) => this.http.get('/v1/payment/escrow/info?chain=' + encodeURIComponent(chain)),
-            /** relayer gas 健康；不传 chain 返回全部已配置链。 */
-            relayerStatus: (chain) => this.http.get('/v1/payment/escrow/relayer-status' + (chain ? '?chain=' + encodeURIComponent(chain) : '')),
-            /** 核验 Solana 原生 SOL 充值并入账（幂等键 `sol:<signature>`）。 */
-            solanaVerify: (p) => this.http.post('/v1/payment/solana/verify', p),
-        };
     }
     /** 发起收费（内部路由 x402/a2a/batch/invite）。 */
     charge(params) {
@@ -178,5 +157,27 @@ class PaymentAPI {
     transferCancel(transferId) {
         return this.http.post('/v1/payment/transfers/' + encodeURIComponent(transferId) + '/cancel');
     }
+    /** 周期订阅扣费（基于已创建的 authorization）。 */
+    period = {
+        /** 扣减一个周期；返回 authorizationId 与扣费结果。 */
+        charge: (authorizationId) => this.http.post('/v1/payment/period/charge', { authorizationId }),
+        /** 查询周期授权状态（剩余额度 / 周期 / 状态）。 */
+        authorization: (authorizationId) => this.http.get('/v1/payment/period/authorization?authorizationId=' + encodeURIComponent(authorizationId)),
+    };
+    /** 托管（escrow）链上按量计费 / 退款。 */
+    escrow = {
+        /** relayer 代为签名扣费：`{chain, user, amountWei, reference}`。 */
+        charge: (p) => this.http.post('/v1/payment/escrow/charge', p),
+        /** relayer 代为签名退款：`{chain, user, amountWei, reference}`。 */
+        refund: (p) => this.http.post('/v1/payment/escrow/refund', p),
+        /** 查询托管余额（未配置链返回 `{configured:false, balanceWei:'0'}`）。 */
+        balance: (chain, user) => this.http.get('/v1/payment/escrow/balance?' + new URLSearchParams({ chain, user }).toString()),
+        /** 查询链上托管配置（地址 / 限额）。 */
+        info: (chain) => this.http.get('/v1/payment/escrow/info?chain=' + encodeURIComponent(chain)),
+        /** relayer gas 健康；不传 chain 返回全部已配置链。 */
+        relayerStatus: (chain) => this.http.get('/v1/payment/escrow/relayer-status' + (chain ? '?chain=' + encodeURIComponent(chain) : '')),
+        /** 核验 Solana 原生 SOL 充值并入账（幂等键 `sol:<signature>`）。 */
+        solanaVerify: (p) => this.http.post('/v1/payment/solana/verify', p),
+    };
 }
 exports.PaymentAPI = PaymentAPI;

package/dist/wallet/index.d.ts

@@ -3,3 +3,4 @@ export * from './solana-account-types';
 export * from './solana-execution-types';
 export * from './mpc-types';
 export * from './wallet-api';
+export * from '../aa';

package/dist/wallet/index.js

@@ -22,3 +22,4 @@ __exportStar(require("./solana-account-types"), exports);
 __exportStar(require("./solana-execution-types"), exports);
 __exportStar(require("./mpc-types"), exports);
 __exportStar(require("./wallet-api"), exports);
+__exportStar(require("../aa"), exports);

package/dist/wallet/types.d.ts

@@ -48,6 +48,84 @@ 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;
+}
+/** token paymaster 发现信息（不暴露私钥）。 */
+export interface PaymasterInfo {
+    chainId: number;
+    paymaster: string;
+    /** voucher 签发地址（仅用于核对）。 */
+    signer: string;
+    voucher: {
+        maxCostWei: string;
+        ttlSec: number;
+        maxTtlSec: number;
+        perSenderPerDay: number;
+        /** 固定意图：只赞助 `approve(paymaster, amount)`。 */
+        intent: string;
+    };
+}
+/** 首笔授权 voucher 申请（无需 native、无需已有 allowance）。 */
+export interface PaymasterVoucherParams {
+    sender: string;
+    /** 待赞助的 callData（`approve(paymaster, amount)`，直连或包在 execute 里）。 */
+    callData: string;
+    /** 本笔 op 的最大 gas 成本（wei，十进制字符串）。 */
+    maxCost: string | bigint;
+    /** Unix 秒；缺省按服务端 TTL。 */
+    validUntil?: number;
+    chainId?: number;
+}
+export interface PaymasterVoucher {
+    chainId: number;
+    paymaster: string;
+    sender: string;
+    nonce: string;
+    validUntil: number;
+    maxCost: string;
+    callDataHash: string;
+    digest: string;
+    signature: string;
+    /** 直接放进 UserOp 的 `paymasterData`。 */
+    paymasterData: string;
+}
 export interface WalletBalanceParams {
     address: string;
     chain?: string;