gatepay-local-mcp 1.0.0 → 1.0.2

package/dist/src/modes/input-normalizer.d.ts

@@ -0,0 +1,17 @@
+import type { SignModeId } from "./types.js";
+export interface RawX402RequestInput {
+    url?: unknown;
+    method?: unknown;
+    body?: unknown;
+    sign_mode?: unknown;
+    wallet_login_provider?: unknown;
+}
+export interface NormalizedX402RequestInput {
+    url: string;
+    method: string;
+    body?: string;
+    signMode?: SignModeId | string;
+    walletLoginProvider: "google" | "gate";
+}
+export declare function normalizeX402RequestInput(input: RawX402RequestInput): NormalizedX402RequestInput;
+//# sourceMappingURL=input-normalizer.d.ts.map

package/dist/src/modes/input-normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-normalizer.d.ts","sourceRoot":"","sources":["../../../src/modes/input-normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,0BAA0B;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IAC/B,mBAAmB,EAAE,QAAQ,GAAG,MAAM,CAAC;CACxC;AAQD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,mBAAmB,GACzB,0BAA0B,CAgB5B"}

package/dist/src/modes/input-normalizer.js

@@ -0,0 +1,22 @@
+function normalizeOptionalString(value) {
+    if (value == null)
+        return undefined;
+    const text = String(value).trim();
+    return text ? text : undefined;
+}
+export function normalizeX402RequestInput(input) {
+    const signMode = normalizeOptionalString(input.sign_mode);
+    const method = normalizeOptionalString(input.method)?.toUpperCase() ?? "POST";
+    const body = normalizeOptionalString(input.body);
+    const walletLoginProvider = normalizeOptionalString(input.wallet_login_provider)?.toLowerCase() === "google"
+        ? "google"
+        : "gate";
+    return {
+        url: normalizeOptionalString(input.url) ?? "",
+        method,
+        body,
+        signMode,
+        walletLoginProvider,
+    };
+}
+//# sourceMappingURL=input-normalizer.js.map

package/dist/src/modes/input-normalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-normalizer.js","sourceRoot":"","sources":["../../../src/modes/input-normalizer.ts"],"names":[],"mappings":"AAkBA,SAAS,uBAAuB,CAAC,KAAc;IAC7C,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IACpC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IAClC,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,KAA0B;IAE1B,MAAM,QAAQ,GAAG,uBAAuB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,MAAM,CAAC;IAC9E,MAAM,IAAI,GAAG,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,mBAAmB,GACvB,uBAAuB,CAAC,KAAK,CAAC,qBAAqB,CAAC,EAAE,WAAW,EAAE,KAAK,QAAQ;QAC9E,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,MAAM,CAAC;IAEb,OAAO;QACL,GAAG,EAAE,uBAAuB,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE;QAC7C,MAAM;QACN,IAAI;QACJ,QAAQ;QACR,mBAAmB;KACpB,CAAC;AACJ,CAAC"}

package/dist/src/modes/local-private-key.d.ts

@@ -0,0 +1,9 @@
+import type { ResolvedSignerSession, SignModeAvailability, SignModeDefinition } from "./types.js";
+export declare class LocalPrivateKeyMode implements SignModeDefinition {
+    readonly id: "local_private_key";
+    readonly priority = 10;
+    checkAvailability(): SignModeAvailability;
+    resolveSigner(): Promise<ResolvedSignerSession>;
+    getCacheKey(): string;
+}
+//# sourceMappingURL=local-private-key.d.ts.map

package/dist/src/modes/local-private-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-private-key.d.ts","sourceRoot":"","sources":["../../../src/modes/local-private-key.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,qBAAa,mBAAoB,YAAW,kBAAkB;IAC5D,QAAQ,CAAC,EAAE,EAAG,mBAAmB,CAAU;IAC3C,QAAQ,CAAC,QAAQ,MAAM;IAEvB,iBAAiB,IAAI,oBAAoB;IAgBnC,aAAa,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAYrD,WAAW,IAAI,MAAM;CAGtB"}

package/dist/src/modes/local-private-key.js

@@ -0,0 +1,35 @@
+import { createLocalPrivateKeySigner } from "./signers.js";
+export class LocalPrivateKeyMode {
+    constructor() {
+        this.id = "local_private_key";
+        this.priority = 10;
+    }
+    checkAvailability() {
+        const privateKey = process.env.EVM_PRIVATE_KEY?.trim();
+        if (!privateKey) {
+            return {
+                status: "not_configured",
+                summary: "本地私钥模式未配置 EVM_PRIVATE_KEY。",
+                missing: ["EVM_PRIVATE_KEY"],
+            };
+        }
+        return {
+            status: "ready",
+            summary: "本地私钥模式可直接使用。",
+        };
+    }
+    async resolveSigner() {
+        const raw = process.env.EVM_PRIVATE_KEY?.trim();
+        if (!raw) {
+            throw new Error("EVM_PRIVATE_KEY is not set.");
+        }
+        const privateKey = (raw.startsWith("0x") ? raw : `0x${raw}`);
+        return {
+            signer: createLocalPrivateKeySigner(privateKey),
+        };
+    }
+    getCacheKey() {
+        return this.id;
+    }
+}
+//# sourceMappingURL=local-private-key.js.map

package/dist/src/modes/local-private-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-private-key.js","sourceRoot":"","sources":["../../../src/modes/local-private-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAO3D,MAAM,OAAO,mBAAmB;IAAhC;QACW,OAAE,GAAG,mBAA4B,CAAC;QAClC,aAAQ,GAAG,EAAE,CAAC;IAiCzB,CAAC;IA/BC,iBAAiB;QACf,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC;QACvD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO;gBACL,MAAM,EAAE,gBAAgB;gBACxB,OAAO,EAAE,4BAA4B;gBACrC,OAAO,EAAE,CAAC,iBAAiB,CAAC;aAC7B,CAAC;QACJ,CAAC;QAED,OAAO;YACL,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,cAAc;SACxB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC;QAChD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAkB,CAAC;QAC9E,OAAO;YACL,MAAM,EAAE,2BAA2B,CAAC,UAAU,CAAC;SAChD,CAAC;IACJ,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;CACF"}

package/dist/src/modes/plugin-wallet.d.ts

@@ -0,0 +1,19 @@
+import { type PluginWalletClient } from "../wallets/plugin-wallet-client.js";
+import type { ResolveSignerContext, ResolvedSignerSession, SignModeAvailability, SignModeDefinition } from "./types.js";
+export interface PluginWalletModeOptions {
+    serverUrl?: string;
+    clientFactory?: (serverUrl: string) => Promise<PluginWalletClient>;
+}
+export declare class PluginWalletMode implements SignModeDefinition {
+    private readonly options;
+    readonly id: "plugin_wallet";
+    readonly priority = 30;
+    constructor(options?: PluginWalletModeOptions);
+    checkAvailability(): Promise<SignModeAvailability>;
+    resolveSigner(context: ResolveSignerContext): Promise<ResolvedSignerSession>;
+    getCacheKey(): string;
+    private getServerUrl;
+    private getClient;
+    private resolveAddress;
+}
+//# sourceMappingURL=plugin-wallet.d.ts.map

package/dist/src/modes/plugin-wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-wallet.d.ts","sourceRoot":"","sources":["../../../src/modes/plugin-wallet.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACpE;AAED,qBAAa,gBAAiB,YAAW,kBAAkB;IAI7C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,EAAE,EAAG,eAAe,CAAU;IACvC,QAAQ,CAAC,QAAQ,MAAM;gBAEM,OAAO,GAAE,uBAA4B;IAE5D,iBAAiB,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAgClD,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAiBlF,WAAW,IAAI,MAAM;IAIrB,OAAO,CAAC,YAAY;YASN,SAAS;YAQT,cAAc;CAqB7B"}

package/dist/src/modes/plugin-wallet.js

@@ -0,0 +1,153 @@
+import { createPluginWalletSigner } from "./signers.js";
+import { getPluginWalletClient, getPluginWalletServerUrl, } from "../wallets/plugin-wallet-client.js";
+export class PluginWalletMode {
+    constructor(options = {}) {
+        this.options = options;
+        this.id = "plugin_wallet";
+        this.priority = 30;
+    }
+    async checkAvailability() {
+        const serverUrl = this.getServerUrl();
+        if (!serverUrl) {
+            return {
+                status: "not_configured",
+                summary: "plugin_wallet 未配置 PLUGIN_WALLET_URL。",
+                missing: ["PLUGIN_WALLET_URL"],
+            };
+        }
+        try {
+            const client = await this.getClient(serverUrl);
+            const statusResult = await client.walletStatus();
+            const statusData = parseToolResult(statusResult);
+            if (isPluginWalletConnected(statusData)) {
+                return {
+                    status: "ready",
+                    summary: "plugin_wallet 已连接可用浏览器钱包。",
+                };
+            }
+        }
+        catch (error) {
+            const message = getErrorMessage(error);
+            console.error(`[plugin_wallet] checkAvailability failed: ${message}`);
+        }
+        return {
+            status: "needs_login",
+            summary: "plugin_wallet 需要先连接浏览器钱包。",
+            missing: ["browser_wallet_connection"],
+        };
+    }
+    async resolveSigner(context) {
+        void context;
+        const serverUrl = this.getServerUrl();
+        if (!serverUrl) {
+            throw new Error("PLUGIN_WALLET_URL is not set.");
+        }
+        const client = await this.getClient(serverUrl);
+        const connectResult = await client.connectWallet();
+        console.log("connectResult", connectResult);
+        const address = await this.resolveAddress(client, connectResult);
+        return {
+            signer: createPluginWalletSigner(client, address),
+        };
+    }
+    getCacheKey() {
+        return `${this.id}:${this.getServerUrl() ?? "missing-url"}`;
+    }
+    getServerUrl() {
+        const fromOptions = this.options.serverUrl?.trim();
+        if (fromOptions) {
+            return fromOptions;
+        }
+        return getPluginWalletServerUrl();
+    }
+    async getClient(serverUrl) {
+        if (this.options.clientFactory) {
+            return this.options.clientFactory(serverUrl);
+        }
+        return getPluginWalletClient({ serverUrl });
+    }
+    async resolveAddress(client, connectResult) {
+        const connectData = parseToolResult(connectResult);
+        const connectedAddress = extractEvmAddress(connectData);
+        if (connectedAddress) {
+            return connectedAddress;
+        }
+        const accountsResult = await client.getAccounts();
+        const accountsData = parseToolResult(accountsResult);
+        const accountAddress = extractEvmAddress(accountsData);
+        if (accountAddress) {
+            return accountAddress;
+        }
+        const hint = getExtensionHint(connectData) ?? getExtensionHint(accountsData)
+            ?? "请先在浏览器中打开 Gate Wallet 扩展并连接，或打开与 PLUGIN_WALLET_URL 同会话的页面后再重试。";
+        throw new Error(`plugin_wallet 未获取到 EVM 地址。${hint}`);
+    }
+}
+function getErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/** 从 MCP 返回里取出与「扩展未连接」相关的提示，用于抛错时附带说明。 */
+function getExtensionHint(data) {
+    if (!data || typeof data.error !== "string")
+        return null;
+    const msg = data.error.trim();
+    if (!msg)
+        return null;
+    return msg.includes("扩展") || msg.includes("extension") || msg.includes("连接")
+        ? ` ${msg}`
+        : null;
+}
+function parseToolResult(result) {
+    if (result == null || typeof result !== "object" || !("content" in result)) {
+        return null;
+    }
+    const content = result.content;
+    if (!Array.isArray(content) || content.length === 0) {
+        return null;
+    }
+    const first = content[0];
+    if (!first || first.type !== "text" || typeof first.text !== "string") {
+        return null;
+    }
+    try {
+        let parsed = JSON.parse(first.text);
+        if (typeof parsed === "string") {
+            parsed = JSON.parse(parsed);
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function isPluginWalletConnected(data) {
+    if (!data) {
+        return false;
+    }
+    if (typeof data.connected === "boolean") {
+        return data.connected;
+    }
+    return extractEvmAddress(data) !== null;
+}
+function extractEvmAddress(data) {
+    if (!data) {
+        return null;
+    }
+    const candidates = [];
+    if (typeof data.address === "string") {
+        candidates.push(data.address);
+    }
+    if (Array.isArray(data.accounts)) {
+        candidates.push(...data.accounts);
+    }
+    if (Array.isArray(data.addresses)) {
+        candidates.push(...data.addresses);
+    }
+    for (const candidate of candidates) {
+        if (typeof candidate === "string" && /^0x[a-fA-F0-9]{40}$/.test(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=plugin-wallet.js.map

package/dist/src/modes/plugin-wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-wallet.js","sourceRoot":"","sources":["../../../src/modes/plugin-wallet.ts"],"names":[],"mappings":"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"}

package/dist/src/modes/quick-wallet.d.ts

@@ -0,0 +1,15 @@
+import type { ResolveSignerContext, ResolvedSignerSession, SignModeAvailability, SignModeDefinition } from "./types.js";
+export interface QuickWalletModeOptions {
+    mcpWalletUrl: string;
+    mcpApiKey?: string;
+}
+export declare class QuickWalletMode implements SignModeDefinition {
+    private readonly options;
+    readonly id: "quick_wallet";
+    readonly priority = 20;
+    constructor(options: QuickWalletModeOptions);
+    checkAvailability(): Promise<SignModeAvailability>;
+    resolveSigner(context: ResolveSignerContext): Promise<ResolvedSignerSession>;
+    getCacheKey(): string;
+}
+//# sourceMappingURL=quick-wallet.d.ts.map

package/dist/src/modes/quick-wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-wallet.d.ts","sourceRoot":"","sources":["../../../src/modes/quick-wallet.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAgCD,qBAAa,eAAgB,YAAW,kBAAkB;IAI5C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,EAAE,EAAG,cAAc,CAAU;IACtC,QAAQ,CAAC,QAAQ,MAAM;gBAEM,OAAO,EAAE,sBAAsB;IAEtD,iBAAiB,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAsBlD,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA4ClF,WAAW,IAAI,MAAM;CAGtB"}

package/dist/src/modes/quick-wallet.js

@@ -0,0 +1,94 @@
+import { createQuickWalletSigner } from "./signers.js";
+import { loginWithDeviceFlow } from "../wallets/device-flow-login.js";
+import { getMcpClient } from "../wallets/wallet-mcp-clients.js";
+function parseMcpPayload(text) {
+    try {
+        const parsed = JSON.parse(text);
+        if (typeof parsed === "string") {
+            try {
+                return JSON.parse(parsed);
+            }
+            catch {
+                return parsed;
+            }
+        }
+        return parsed;
+    }
+    catch {
+        return undefined;
+    }
+}
+function extractAddressPayload(result) {
+    if (result == null || typeof result !== "object" || !("content" in result)) {
+        return result;
+    }
+    const content = result.content;
+    const first = Array.isArray(content)
+        ? content[0]
+        : undefined;
+    if (!first || first.type !== "text" || typeof first.text !== "string") {
+        return result;
+    }
+    return parseMcpPayload(first.text) ?? first.text;
+}
+export class QuickWalletMode {
+    constructor(options) {
+        this.options = options;
+        this.id = "quick_wallet";
+        this.priority = 20;
+    }
+    async checkAvailability() {
+        try {
+            const mcp = await getMcpClient({
+                serverUrl: this.options.mcpWalletUrl,
+                apiKey: this.options.mcpApiKey,
+            });
+            if (mcp.isMcpTokenUsable()) {
+                return {
+                    status: "ready",
+                    summary: "quick_wallet 进程内已有有效 MCP 登录态。",
+                };
+            }
+        }
+        catch {
+            // 连接失败时不阻断显式选择 quick_wallet，交由 resolveSigner 再试
+        }
+        return {
+            status: "needs_login",
+            summary: "quick_wallet 需设备流登录（无有效进程内 token 或已过期）。",
+            missing: ["mcp_token"],
+        };
+    }
+    async resolveSigner(context) {
+        const mcp = await getMcpClient({
+            serverUrl: this.options.mcpWalletUrl,
+            apiKey: this.options.mcpApiKey,
+        });
+        if (!mcp.isMcpTokenUsable()) {
+            const isGoogle = context.walletLoginProvider === "google";
+            const providerLabel = isGoogle ? "Google" : "Gate";
+            console.error(`[x402_request] quick_wallet: 无有效 MCP token（缺失或已过期），开始 ${providerLabel} 设备流登录…`);
+            const loginOk = await loginWithDeviceFlow(mcp, this.options.mcpWalletUrl, isGoogle, providerLabel, {
+                saveToken: false,
+                reportAddresses: false,
+            });
+            if (!loginOk) {
+                throw new Error("quick_wallet login did not complete (cancelled, failed, or timed out)");
+            }
+            const addressResult = await mcp.walletGetAddresses();
+            const addresses = extractAddressPayload(addressResult);
+            throw new Error([
+                "quick_wallet 登录成功。",
+                `钱包地址信息：${JSON.stringify(addresses, null, 2)}`,
+                "如果你想继续用这个接口进行支付，请回复yes",
+            ].join("\n"));
+        }
+        return {
+            signer: await createQuickWalletSigner(mcp),
+        };
+    }
+    getCacheKey() {
+        return this.id;
+    }
+}
+//# sourceMappingURL=quick-wallet.js.map

package/dist/src/modes/quick-wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-wallet.js","sourceRoot":"","sources":["../../../src/modes/quick-wallet.ts"],"names":[],"mappings":"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"}

package/dist/src/modes/registry.d.ts

@@ -0,0 +1,26 @@
+import type { PayFetchFactory, ResolveSignerContext, SelectModeResult, SignModeDefinition, SignModeId } from "./types.js";
+type SelectionErrorCode = "unknown_mode" | "no_mode_available" | "mode_not_ready" | "mode_init_failed";
+export declare class SignModeSelectionError extends Error {
+    readonly code: SelectionErrorCode;
+    readonly mode?: string;
+    readonly supportedModes?: string[];
+    readonly missing?: string[];
+    readonly availableHints?: string[];
+    constructor(params: {
+        code: SelectionErrorCode;
+        message: string;
+        mode?: string;
+        supportedModes?: string[];
+        missing?: string[];
+        availableHints?: string[];
+    });
+}
+export interface SignModeRegistry {
+    selectMode(requestedMode?: string): Promise<SelectModeResult>;
+    getOrCreatePayFetch(mode: SignModeDefinition, context: ResolveSignerContext): Promise<typeof fetch>;
+    listSupportedModes(): SignModeId[];
+}
+export declare function createSignModeRegistry(modes: SignModeDefinition[], payFetchFactory?: PayFetchFactory): SignModeRegistry;
+export declare function formatSignModeSelectionError(error: unknown): string;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/src/modes/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/modes/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,KAAK,kBAAkB,GACnB,cAAc,GACd,mBAAmB,GACnB,gBAAgB,GAChB,kBAAkB,CAAC;AAEvB,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;gBAEvB,MAAM,EAAE;QAClB,IAAI,EAAE,kBAAkB,CAAC;QACzB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;KAC3B;CASF;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC9D,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,KAAK,CAAC,CAAC;IACpG,kBAAkB,IAAI,UAAU,EAAE,CAAC;CACpC;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,kBAAkB,EAAE,EAC3B,eAAe,GAAE,eAA8C,GAC9D,gBAAgB,CAyGlB;AAaD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAuBnE"}

package/dist/src/modes/registry.js

@@ -0,0 +1,126 @@
+import { DefaultPayFetchFactory } from "./build-pay-fetch.js";
+export class SignModeSelectionError extends Error {
+    constructor(params) {
+        super(params.message);
+        this.name = "SignModeSelectionError";
+        this.code = params.code;
+        this.mode = params.mode;
+        this.supportedModes = params.supportedModes;
+        this.missing = params.missing;
+        this.availableHints = params.availableHints;
+    }
+}
+export function createSignModeRegistry(modes, payFetchFactory = new DefaultPayFetchFactory()) {
+    const registeredModes = new Map();
+    const readyFetchCache = new Map();
+    const initPromiseCache = new Map();
+    for (const mode of modes) {
+        registeredModes.set(mode.id, mode);
+    }
+    async function selectMode(requestedMode) {
+        if (requestedMode) {
+            const mode = registeredModes.get(requestedMode);
+            if (!mode) {
+                throw new SignModeSelectionError({
+                    code: "unknown_mode",
+                    message: `Unknown sign_mode: ${requestedMode}`,
+                    mode: requestedMode,
+                    supportedModes: listSupportedModes(),
+                });
+            }
+            const availability = await mode.checkAvailability();
+            if (availability.status === "not_configured") {
+                throw new SignModeSelectionError({
+                    code: "mode_not_ready",
+                    message: availability.summary,
+                    mode: mode.id,
+                    missing: availability.missing,
+                });
+            }
+            return { mode, availability };
+        }
+        const checkedModes = await Promise.all(listSupportedModes().map(async (modeId) => {
+            const mode = registeredModes.get(modeId);
+            const availability = await mode.checkAvailability();
+            return { mode, availability };
+        }));
+        const readyModes = checkedModes
+            .filter((item) => item.availability.status === "ready")
+            .sort((left, right) => left.mode.priority - right.mode.priority);
+        if (readyModes.length === 0) {
+            throw new SignModeSelectionError({
+                code: "no_mode_available",
+                message: "No sign mode is currently ready.",
+                availableHints: checkedModes.map(({ mode, availability }) => `${mode.id}: ${availability.summary}`),
+            });
+        }
+        return readyModes[0];
+    }
+    async function getOrCreatePayFetch(mode, context) {
+        const cacheKey = await getModeCacheKey(mode, context);
+        const cached = readyFetchCache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        const pending = initPromiseCache.get(cacheKey);
+        if (pending) {
+            return pending;
+        }
+        const initPromise = (async () => {
+            try {
+                const session = await mode.resolveSigner(context);
+                const payFetch = payFetchFactory.build({ signer: session.signer });
+                readyFetchCache.set(cacheKey, payFetch);
+                return payFetch;
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                throw new SignModeSelectionError({
+                    code: "mode_init_failed",
+                    message,
+                    mode: mode.id,
+                });
+            }
+            finally {
+                initPromiseCache.delete(cacheKey);
+            }
+        })();
+        initPromiseCache.set(cacheKey, initPromise);
+        return initPromise;
+    }
+    function listSupportedModes() {
+        return [...registeredModes.keys()];
+    }
+    return {
+        selectMode,
+        getOrCreatePayFetch,
+        listSupportedModes,
+    };
+}
+async function getModeCacheKey(mode, context) {
+    if (mode.getCacheKey) {
+        return await mode.getCacheKey(context);
+    }
+    return mode.id;
+}
+export function formatSignModeSelectionError(error) {
+    if (!(error instanceof SignModeSelectionError)) {
+        return error instanceof Error ? error.message : String(error);
+    }
+    if (error.code === "unknown_mode") {
+        const supported = error.supportedModes?.join(", ") ?? "";
+        return `未知 sign_mode: ${error.mode}。支持的模式：${supported}`;
+    }
+    if (error.code === "no_mode_available") {
+        const hints = error.availableHints?.join("；") ?? "";
+        return `当前没有可自动选择的 sign_mode。请先配置可用的 token、session 或本地私钥。${hints ? ` 状态：${hints}` : ""}`;
+    }
+    if (error.code === "mode_not_ready") {
+        const missing = error.missing?.join(", ");
+        return missing
+            ? `sign_mode ${error.mode} 当前不可直接使用：${error.message} 缺失项：${missing}`
+            : `sign_mode ${error.mode} 当前不可直接使用：${error.message}`;
+    }
+    return `sign_mode ${error.mode} 初始化失败：${error.message}`;
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/modes/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/modes/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAe9D,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAO/C,YAAY,MAOX;QACC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;QAC5C,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;IAC9C,CAAC;CACF;AAQD,MAAM,UAAU,sBAAsB,CACpC,KAA2B,EAC3B,kBAAmC,IAAI,sBAAsB,EAAE;IAE/D,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkC,CAAC;IAClE,MAAM,eAAe,GAAG,IAAI,GAAG,EAAwB,CAAC;IACxD,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAiC,CAAC;IAElE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,UAAU,UAAU,CAAC,aAAsB;QAC9C,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,aAA2B,CAAC,CAAC;YAC9D,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,sBAAsB,CAAC;oBAC/B,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,sBAAsB,aAAa,EAAE;oBAC9C,IAAI,EAAE,aAAa;oBACnB,cAAc,EAAE,kBAAkB,EAAE;iBACrC,CAAC,CAAC;YACL,CAAC;YAED,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACpD,IAAI,YAAY,CAAC,MAAM,KAAK,gBAAgB,EAAE,CAAC;gBAC7C,MAAM,IAAI,sBAAsB,CAAC;oBAC/B,IAAI,EAAE,gBAAgB;oBACtB,OAAO,EAAE,YAAY,CAAC,OAAO;oBAC7B,IAAI,EAAE,IAAI,CAAC,EAAE;oBACb,OAAO,EAAE,YAAY,CAAC,OAAO;iBAC9B,CAAC,CAAC;YACL,CAAC;YAED,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;QAChC,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CACpC,kBAAkB,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YACxC,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC;YAC1C,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACpD,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;QAChC,CAAC,CAAC,CACH,CAAC;QAEF,MAAM,UAAU,GAAG,YAAY;aAC5B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,KAAK,OAAO,CAAC;aACtD,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEnE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,sBAAsB,CAAC;gBAC/B,IAAI,EAAE,mBAAmB;gBACzB,OAAO,EAAE,kCAAkC;gBAC3C,cAAc,EAAE,YAAY,CAAC,GAAG,CAC9B,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,KAAK,YAAY,CAAC,OAAO,EAAE,CAClE;aACF,CAAC,CAAC;QACL,CAAC;QAED,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAED,KAAK,UAAU,mBAAmB,CAChC,IAAwB,EACxB,OAA6B;QAE7B,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,MAAM,WAAW,GAAG,CAAC,KAAK,IAAI,EAAE;YAC9B,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gBAClD,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;gBACnE,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBACxC,OAAO,QAAQ,CAAC;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,MAAM,IAAI,sBAAsB,CAAC;oBAC/B,IAAI,EAAE,kBAAkB;oBACxB,OAAO;oBACP,IAAI,EAAE,IAAI,CAAC,EAAE;iBACd,CAAC,CAAC;YACL,CAAC;oBAAS,CAAC;gBACT,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACpC,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC5C,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,SAAS,kBAAkB;QACzB,OAAO,CAAC,GAAG,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,OAAO;QACL,UAAU;QACV,mBAAmB;QACnB,kBAAkB;KACnB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,IAAwB,EACxB,OAA6B;IAE7B,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,IAAI,CAAC,EAAE,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,KAAc;IACzD,IAAI,CAAC,CAAC,KAAK,YAAY,sBAAsB,CAAC,EAAE,CAAC;QAC/C,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACzD,OAAO,iBAAiB,KAAK,CAAC,IAAI,UAAU,SAAS,EAAE,CAAC;IAC1D,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACpD,OAAO,oDAAoD,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC3F,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,OAAO;YACZ,CAAC,CAAC,aAAa,KAAK,CAAC,IAAI,aAAa,KAAK,CAAC,OAAO,QAAQ,OAAO,EAAE;YACpE,CAAC,CAAC,aAAa,KAAK,CAAC,IAAI,aAAa,KAAK,CAAC,OAAO,EAAE,CAAC;IAC1D,CAAC;IAED,OAAO,aAAa,KAAK,CAAC,IAAI,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC;AAC1D,CAAC"}

package/dist/src/modes/signers.d.ts

@@ -0,0 +1,40 @@
+import type { Hex } from "viem";
+import type { ClientEvmSigner } from "../x402/types.js";
+import type { PluginWalletClient } from "../wallets/plugin-wallet-client.js";
+import type { GateMcpClient } from "../wallets/wallet-mcp-clients.js";
+/**
+ * 创建本地私钥 Signer (用于 local_private_key 签名模式)
+ *
+ * 特点：
+ * - 完全本地签名，不依赖远程服务
+ * - 支持 signTypedData (EIP-712) 和 signDigest
+ * - 适用于开发环境和对安全性要求高的场景
+ */
+export declare function createLocalPrivateKeySigner(privateKey: Hex): ClientEvmSigner;
+export declare const createSignerFromPrivateKey: typeof createLocalPrivateKeySigner;
+/**
+ * 创建插件钱包 Signer (用于 plugin_wallet 签名模式)
+ *
+ * 特点：
+ * - 通过浏览器插件钱包 (如 Gate Wallet) 进行签名
+ * - signTypedData: 传递完整的 EIP-712 四字段 JSON 给插件钱包处理
+ * - signDigest: 直接传递 digest 给插件钱包的 sign_message
+ * - 需要用户在浏览器中手动确认签名
+ */
+export declare function createPluginWalletSigner(client: PluginWalletClient, address: `0x${string}`): ClientEvmSigner;
+export declare const createSignerFromPluginWallet: typeof createPluginWalletSigner;
+/**
+ * 创建快速托管钱包 Signer (用于 quick_wallet 签名模式)
+ *
+ * 特点：
+ * - 通过远程 MCP 托管钱包服务进行签名
+ * - signDigest: 使用 wallet.sign_message
+ * - signTypedData: 使用 wallet.sign_transaction 传递序列化的 typed data
+ * - 需要用户通过 OAuth (Google/Gate) 登录并获得 mcp_token
+ * - 完全托管，用户无需管理私钥
+ */
+export declare function createQuickWalletSigner(mcp: GateMcpClient, options?: {
+    evmAddress?: `0x${string}`;
+}): Promise<ClientEvmSigner>;
+export declare const createSignerFromMcpWallet: typeof createQuickWalletSigner;
+//# sourceMappingURL=signers.d.ts.map

package/dist/src/modes/signers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signers.d.ts","sourceRoot":"","sources":["../../../src/modes/signers.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAGhC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAE7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AA4HtE;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,GAAG,GAAG,eAAe,CAQ5E;AAGD,eAAO,MAAM,0BAA0B,oCAA8B,CAAC;AAMtE;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACpC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,KAAK,MAAM,EAAE,GACvB,eAAe,CAoDjB;AAGD,eAAO,MAAM,4BAA4B,iCAA2B,CAAC;AAMrE;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CACzC,GAAG,EAAE,aAAa,EAClB,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,KAAK,MAAM,EAAE,CAAA;CAAE,GACzC,OAAO,CAAC,eAAe,CAAC,CAkE1B;AAGD,eAAO,MAAM,yBAAyB,gCAA0B,CAAC"}