gatepay-local-mcp 1.0.10 → 1.2.0

package/Readme.md

@@ -1,11 +1,12 @@
 # gatepay-local-mcp
 
-`gatepay-local-mcp` is a local `stdio` MCP server for calling **X402 payment-protected** HTTP endpoints. It provides a suite of MCP tools to handle the complete X402 payment workflow, from placing orders to signing payments and submitting them to merchants.
+`gatepay-local-mcp` is a local `stdio` MCP server for calling **X402** and **MPP (Base + USDC)** payment-protected HTTP endpoints. It exposes MCP tools for X402 (`PAYMENT-REQUIRED`), Gate Pay centralized settlement, and MPP session flows (`WWW-Authenticate`, on-chain escrow, HTTP close / optional chain withdraw).
 
 ## Features
 
-- **7 MCP Tools** covering order placement, signature flows, quick wallet / Gate Pay auth, and centralized payment retries
+- **12 MCP Tools**: X402 order + signature flows, Gate Pay centralized payment, and **MPP (Base + USDC)** session tools (`mpp_*`)
 - Built-in X402 payment flow under `src/x402/`
+- **MPP session flow** under `src/mpp-base/` + `mppx`: on-chain escrow channel, `402` / `WWW-Authenticate` handling, HTTP settlement, and optional on-chain `requestClose` / `withdraw`
 - **Multiple signing modes**: `local_private_key`, `quick_wallet`, `plugin_wallet`
 - **Multi-chain support**: EVM (Ethereum, Base, Polygon, etc.) and Solana
 - Works with Cursor, Claude Desktop, and other MCP clients
@@ -18,7 +19,7 @@
 
 Send an HTTP request and return complete response information including headers, body, and the original request details.
 
-**Use case**: Initial request to a payment-protected endpoint that returns `402 Payment Required`.
+**Use case**: Probe a URL that may return `402 Payment Required` — detect whether the merchant uses **X402** (`PAYMENT-REQUIRED`) or **MPP** (`WWW-Authenticate`) before choosing tools.
 
 **Parameters**:
 ```typescript
@@ -31,7 +32,10 @@ Send an HTTP request and return complete response information including headers,
 }
 ```
 
-**Returns**: Complete response with status code, headers (including `PAYMENT-REQUIRED`), body, and original request details.
+**Returns**: Complete response with status code, headers, body, original request details, and **`paymentType`** when detectable:
+
+- **`x402`**: response includes a `PAYMENT-REQUIRED` header — use the X402 tools below (`x402_sign_payment`, or split create/submit).
+- **`mpp`**: response includes `WWW-Authenticate` — **do not** use X402 signing tools; run **`mpp_init_session`** then **`mpp_fetch`** (see MPP sections).
 
 ---
 
@@ -137,6 +141,9 @@ Parse the Base64-encoded `PAYMENT-REQUIRED` header and complete the Gate Pay cen
 ```typescript
 {
   payment_required_header: string; // Base64-encoded PAYMENT-REQUIRED header (required)
+  resource_url: string; // Full http/https merchant URL after pay — same rules as x402_place_order `url` (required)
+  method?: "GET" | "POST" | "PUT" | "PATCH"; // default POST
+  body?: string; // JSON string for POST/PUT/PATCH; omit for GET
 }
 ```
 
@@ -144,6 +151,112 @@ Parse the Base64-encoded `PAYMENT-REQUIRED` header and complete the Gate Pay cen
 
 ---
 
+## MPP tools (Base + USDC session)
+
+MPP (multi-party payment over an on-chain escrow channel) is separate from X402’s `PAYMENT-REQUIRED` header flow. The server caches one **session per EVM address** after `mpp_init_session`. Signing modes are the same three as X402 for EVM operations: `local_private_key`, `quick_wallet`, `plugin_wallet` (with `quick_wallet` / `plugin_wallet` needing `signTransaction` for on-chain channel steps).
+
+**Important**
+
+- Serialize **`mpp_fetch`** calls for a given session (one in flight at a time) so vouchers and channel state stay consistent.
+- **`mpp_close_session`** (HTTP): merchant billing + `Payment-Receipt`, then clears the local cache.
+- **`mpp_request_close`** / **`mpp_withdraw`**: **on-chain only**; they do not replace HTTP close. After `mpp_request_close`, wait for the contract-defined period before `mpp_withdraw`.
+
+---
+
+### 8. `mpp_init_session`
+
+Initialize the cached MPP session manager (max deposit, signer selection). Call this **before** any `mpp_fetch`.
+
+**Use case**: First step for merchants that return `402` with `WWW-Authenticate` (MPP challenges).
+
+**Parameters**:
+```typescript
+{
+  max_deposit?: string;     // Human-readable max deposit, e.g. "10" (default "1")
+  sign_mode?: "local_private_key" | "quick_wallet" | "plugin_wallet"; // omit = auto: local → quick → plugin
+  wallet_login_provider?: "google" | "gate"; // when quick_wallet is used (default: gate)
+  decimals?: number;        // Token decimals (default 6)
+}
+```
+
+**Returns**: `sessionId`, effective `signMode`, `loadStrategy`, `loadAttempts` (explains auto-selection when `sign_mode` was omitted).
+
+---
+
+### 9. `mpp_fetch`
+
+Perform an HTTP request through the cached MPP client: handles `402` / `WWW-Authenticate`, builds credentials, retries after payment negotiation.
+
+**Use case**: Call the merchant URL after `mpp_init_session`. The first successful `402` flow establishes or confirms the on-chain escrow **channel**.
+
+**Parameters**:
+```typescript
+{
+  url: string;              // Full http/https resource URL (required)
+  method?: "GET" | "POST" | "PUT" | "PATCH"; // default POST
+  body?: string;            // JSON string body (optional)
+  headers?: string;         // Extra headers as JSON object string (optional)
+}
+```
+
+**Returns**: HTTP result from the merchant after MPP negotiation (and receipt metadata when present).
+
+---
+
+### 10. `mpp_close_session`
+
+HTTP-side settlement: sign a **close** credential, `POST` to the **same resource URL last used by `mpp_fetch`**, parse `Payment-Receipt`, then clear the local session.
+
+**Use case**: Normal end-of-session cleanup when the merchant should finalize billing and you want to drop the local MPP cache.
+
+**Parameters**:
+```typescript
+{
+  account_address?: string; // Optional EVM address; if omitted, closes one active cached session
+}
+```
+
+**Returns**: Close / receipt outcome; local session cleared for that account.
+
+---
+
+### 11. `mpp_request_close`
+
+On-chain only: call the escrow contract’s **`requestClose(channelId)`** to start closing the channel on Base.
+
+**Use case**: Begin on-chain closure after you no longer need paid fetches; does **not** call the merchant, does **not** return `Payment-Receipt`, does **not** clear the local session.
+
+**Parameters**:
+```typescript
+{
+  account_address?: string; // Optional EVM address for the cached session
+  rpc_url?: string;         // Optional JSON-RPC override (else `MPP_BASE_RPC_URL` / `BASE_RPC_URL` or built-in defaults)
+}
+```
+
+**Returns**: Transaction / chain result for `requestClose`.
+
+---
+
+### 12. `mpp_withdraw`
+
+On-chain only: call **`withdraw(channelId)`** after `mpp_request_close` **and** the contract wait period — recovers remaining escrowed funds.
+
+**Use case**: Recover on-chain balance after the channel is closable; too early and the contract reverts.
+
+**Parameters**:
+```typescript
+{
+  account_address?: string; // Optional EVM address
+  channel_id?: string;      // Optional 0x + 64 hex; omit if channel is still in local cache after paid fetches
+  rpc_url?: string;         // Optional JSON-RPC override
+}
+```
+
+**Returns**: Transaction / chain result for `withdraw`.
+
+---
+
 ## Workflow Examples
 
 ### Single-Step Workflow (Recommended)
@@ -176,7 +289,24 @@ Parse the Base64-encoded `PAYMENT-REQUIRED` header and complete the Gate Pay cen
 2. x402_place_order         → Receive PAYMENT-REQUIRED header that encodes Gate Pay order info
 3. x402_submit_payment      → Use payment_signature + sign_mode: "centralized_payment" to call the merchant with Authorization: Bearer
    或
-3. x402_centralized_payment → Pass payment_required_header directly for all-in-one centralized settlement
+3. x402_centralized_payment → payment_required_header + resource_url (full http/https); pays then retries merchant with X-GatePay-Centralized-Merchant-No
+```
+
+### MPP (WWW-Authenticate / Base escrow)
+
+```
+1. x402_place_order          → If paymentType is mpp, note WWW-Authenticate / 402 body
+2. mpp_init_session          → Cache session + signer (local_private_key, quick_wallet, or plugin_wallet)
+3. mpp_fetch                 → Same merchant URL/method/body; handles 402 + channel (serialize calls)
+4. mpp_close_session         → HTTP settlement + Payment-Receipt; clears local session
+```
+
+Optional on-chain teardown (after you are done with HTTP billing and understand contract timing):
+
+```
+5. mpp_request_close         → Escrow requestClose on-chain (session cache unchanged)
+6. (wait for contract period)
+7. mpp_withdraw              → On-chain withdraw of remaining deposit
 ```
 
 ## Signing Modes
@@ -298,7 +428,7 @@ Use this when merchants expect Gate Pay centralized settlement instead of user-o
 
 - Run `x402_gate_pay_auth` once per token lifecycle; it opens the Gate consent page and exchanges the code automatically.
 - Use `x402_submit_payment` with `sign_mode: "centralized_payment"` after you create a `PAYMENT-SIGNATURE`, or
-- Call `x402_centralized_payment` directly with the Base64 `PAYMENT-REQUIRED` header when you prefer a single-step helper.
+- Call `x402_centralized_payment` with the Base64 `PAYMENT-REQUIRED` header plus required `resource_url` (same http/https rules as `x402_place_order`) when you prefer a single-step helper.
 
 ### Cursor / Claude Desktop with plugin wallet
 
@@ -339,6 +469,21 @@ The server loads `.env` from the repository or package root at startup.
 | `QUICK_WALLET_API_KEY`    | `quick_wallet`      | API key for MCP wallet service (optional)                                   |
 | `PLUGIN_WALLET_TOKEN`     | `plugin_wallet`     | MCP token from browser extension wallet                                     |
 
+### MPP (Base session)
+
+| Variable                     | Description                                                                 |
+| ---------------------------- | --------------------------------------------------------------------------- |
+| `MPP_BASE_CHAIN_ID`          | Base chain id for the MPP session (overrides `BASE_CHAIN_ID` and `GATE_PAY_ENV` preset) |
+| `BASE_CHAIN_ID`              | Fallback chain id when `MPP_BASE_CHAIN_ID` is unset                         |
+| `GATE_PAY_ENV`               | Preset when neither chain id is set: `test` → Base Sepolia `84532`, else Base mainnet `8453` |
+| `MPP_BASE_ESCROW_CONTRACT`   | Override escrow contract address (else `BASE_ESCROW_CONTRACT` or mpp-base default) |
+| `BASE_ESCROW_CONTRACT`       | Alternate env name for escrow contract override                             |
+| `MPP_BASE_RPC_URL`           | JSON-RPC URL for Base on-chain writes (`requestClose` / `withdraw`, channel reads) |
+| `BASE_RPC_URL`               | Fallback RPC URL when `MPP_BASE_RPC_URL` is unset                         |
+| `QUICK_WALLET_MPP_EVM_CHAIN` | Gate MCP chain label for Quick Wallet tx signing (default `BASE`) when using `quick_wallet` with MPP |
+
+`local_private_key` for MPP requires **`EVM_PRIVATE_KEY`** (or **`PRIVATE_KEY`**) for Base signing. `quick_wallet` / `plugin_wallet` must expose the signing APIs required for typed data and contract calls (see server errors if misconfigured).
+
 ### Gate Pay Centralized Payment
 
 | Variable                          | Description                                                                                   |
@@ -363,6 +508,9 @@ The server loads `.env` from the repository or package root at startup.
 | `RESOURCE_SERVER_URL`         | `test/privateKey.test.ts`       | `http://localhost:8080` | Base URL for the local private-key flow test    |
 | `ENDPOINT_PATH`               | `test/privateKey.test.ts`       | `/flight/order`         | Endpoint path appended to `RESOURCE_SERVER_URL` |
 | `GATEPAY_MCP_TEST_TIMEOUT_MS` | `test/mcp-x402-request-tool.ts` | `180000`                | Timeout for the MCP tool integration test       |
+| `MPP_SESSION_TEST_URL`        | `test/mpp-session.manual.ts`    | `http://localhost:8080/api/image/generate` | Full URL for MPP manual init/fetch/close script |
+| `MPP_SESSION_TEST_BODY`       | `test/mpp-session.manual.ts`    | `{"prompt":"mpp-session-manual-test"}`       | POST body JSON string for the MPP manual script |
+| `MPP_SESSION_TEST_REQUEST_CLOSE` | `test/mpp-session.manual.ts` | unset                   | Set to `1` to run on-chain `mpp_request_close` before HTTP close in the manual script |
 
 ## Usage Examples
 
@@ -436,7 +584,10 @@ The server loads `.env` from the repository or package root at startup.
 {
   "tool": "x402_centralized_payment",
   "arguments": {
-    "payment_required_header": "<base64-from-place_order>"
+    "payment_required_header": "<base64-from-place_order>",
+    "resource_url": "https://api.example.com/order",
+    "method": "POST",
+    "body": "{\"orderId\":\"ORD-123\"}"
   }
 }
 
@@ -452,9 +603,45 @@ The server loads `.env` from the repository or package root at startup.
 }
 ```
 
+### Example 5: MPP session (place order → init → fetch → close)
+
+```json
+// Step 0: Discover payment type (mpp → WWW-Authenticate)
+{
+  "tool": "x402_place_order",
+  "arguments": {
+    "url": "https://api.example.com/mpp/resource",
+    "method": "POST",
+    "body": "{\"prompt\":\"hello\"}"
+  }
+}
+
+// Step 1: Init session (after confirming paymentType is mpp)
+{
+  "tool": "mpp_init_session",
+  "arguments": {
+    "max_deposit": "5",
+    "sign_mode": "local_private_key"
+  }
+}
+
+// Step 2: Paid fetch (run fetches one at a time for this session)
+{
+  "tool": "mpp_fetch",
+  "arguments": {
+    "url": "https://api.example.com/mpp/resource",
+    "method": "POST",
+    "body": "{\"prompt\":\"hello\"}"
+  }
+}
+
+// Step 3: HTTP close + receipt + clear cache
+{ "tool": "mpp_close_session", "arguments": {} }
+```
+
 ## Agent Skill
 
-- `skills/SKILL.md` contains the `gatepay-x402` skill manifest and prompts so MCP-aware IDEs (Cursor, Claude Desktop, Codex CLI, etc.) know how to call every tool exposed by this server.
+- `skills/SKILL.md` contains the `gatepay-x402` skill manifest and prompts so MCP-aware IDEs (Cursor, Claude Desktop, Codex CLI, etc.) know how to call every tool exposed by this server (including `mpp_*` when present in your build).
 - `skills/gatepay-x402.md` (mirrored at `docs/gatepay-x402.md`) is a natural-language installation guide. Share that link with your AI host for a “one-click” experience: the host can follow the steps to download `gatepay-local-mcp`, register it in `mcpServers`, and copy the `gatepay-x402` skill into its skills directory automatically.
 
 Tool names and arguments always match each tool’s MCP `inputSchema` on the server you connect to; check your client’s tool list if you ship a trimmed build.
@@ -480,6 +667,9 @@ npm run test:unit
 # run the local private key flow test
 npm run test:privateKey
 
+# MPP session manual (init → fetch ×3 → close; optional on-chain steps via env)
+npm run test:mpp-session
+
 # MCP / x402 集成探针（需 build 后 dist）
 npm run test:split-tools
 ```

package/dist/src/config/env-config.d.ts

@@ -30,4 +30,42 @@ export declare function getEnvironment(): Environment;
  * 优先级：直接设置的环境变量 > GATE_PAY_ENV 预设配置 > 默认值
  */
 export declare function getEnvConfig(): EnvironmentConfig;
+/**
+ * MPP Base session 的 chainId。
+ * 优先级：MPP_BASE_CHAIN_ID、BASE_CHAIN_ID > GATE_PAY_ENV 预设（test→84532，prd→8453）
+ */
+export declare function getMppBaseSessionChainId(): number;
+/** 埋点侧「与本 MCP 进程绑定」的固定维度；含默认上报 App Key（见 JSON `defaultAppKey`） */
+export declare const TRACKING_PRODUCT_DEFAULTS: {
+    defaultReportHost: string;
+    defaultAppId: number;
+    defaultAppKey: string;
+    appName: string;
+    appPlatform: string;
+    accessMethod: string;
+    clientType: string;
+    businessModule: string;
+    productLine: string;
+    eventName: string;
+};
+/**
+ * 埋点上报所需配置（host / appId / appKey）及与产品文档对齐的固定维度。
+ * - 默认 `appKey` 见 `tracking-product-defaults.json` 的 `defaultAppKey`（gateio 主站），用户无需配置；分站等可用 `VOLC_TRACKING_APP_KEY` 覆盖。
+ * - `VOLC_TRACKING_ENABLED` 为 `false` 时关闭上报。
+ */
+export interface TrackingConfig {
+    enabled: boolean;
+    reportHost: string;
+    appId: number;
+    appKey: string;
+    gatePayEnv: Environment;
+    appName: string;
+    appPlatform: string;
+    accessMethod: string;
+    clientType: string;
+    businessModule: string;
+    productLine: string;
+    eventName: string;
+}
+export declare function getTrackingConfig(): TrackingConfig;
 //# sourceMappingURL=env-config.d.ts.map

package/dist/src/config/env-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env-config.d.ts","sourceRoot":"","sources":["../../../src/config/env-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAEhC,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAG1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;IAGxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAElB,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAoDD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAG5C;AAUD;;;GAGG;AACH,wBAAgB,YAAY,IAAI,iBAAiB,CAsChD"}
+{"version":3,"file":"env-config.d.ts","sourceRoot":"","sources":["../../../src/config/env-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAEhC,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAG1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;IAGxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAElB,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAoDD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAG5C;AAUD;;;GAGG;AACH,wBAAgB,YAAY,IAAI,iBAAiB,CAsChD;AAsBD;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAMjD;AAOD,kEAAkE;AAClE,eAAO,MAAM,yBAAyB;;;;;;;;;;;CAA0B,CAAC;AAEjE;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,WAAW,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CA2BlD"}

package/dist/src/config/env-config.js

@@ -2,6 +2,7 @@
  * 环境配置管理模块
  * 支持通过 GATE_PAY_ENV 环境变量在 test 和 prd 环境间切换
  */
+import trackingProductDefaults from "./tracking-product-defaults.json";
 /**
  * 测试环境配置
  */
@@ -98,4 +99,49 @@ function parseCallbackPort() {
     const n = parseInt(portStr, 10);
     return Number.isNaN(n) ? undefined : n;
 }
+function parsePositiveIntEnv(value) {
+    if (!value?.trim())
+        return undefined;
+    const n = Number(value.trim());
+    return Number.isFinite(n) && n > 0 ? n : undefined;
+}
+function getMppBaseChainIdPresetByEnv() {
+    return getEnvironment() === "test" ? 84532 : 8453;
+}
+/**
+ * MPP Base session 的 chainId。
+ * 优先级：MPP_BASE_CHAIN_ID、BASE_CHAIN_ID > GATE_PAY_ENV 预设（test→84532，prd→8453）
+ */
+export function getMppBaseSessionChainId() {
+    return (parsePositiveIntEnv(process.env.MPP_BASE_CHAIN_ID) ??
+        parsePositiveIntEnv(process.env.BASE_CHAIN_ID) ??
+        getMppBaseChainIdPresetByEnv());
+}
+// ---------------------------------------------------------------------------
+// 火山 / Gate 埋点（DataFinder HTTP）：固定产品维度 + 环境可覆盖项
+// 默认值见 tracking-product-defaults.json（脚本 volc-tracking-ping.mjs 同步读取该 JSON）
+// ---------------------------------------------------------------------------
+/** 埋点侧「与本 MCP 进程绑定」的固定维度；含默认上报 App Key（见 JSON `defaultAppKey`） */
+export const TRACKING_PRODUCT_DEFAULTS = trackingProductDefaults;
+export function getTrackingConfig() {
+    const appKey = process.env.VOLC_TRACKING_APP_KEY?.trim() || trackingProductDefaults.defaultAppKey;
+    const enabled = process.env.VOLC_TRACKING_ENABLED?.trim().toLowerCase() !== "false";
+    const appId = parsePositiveIntEnv(process.env.VOLC_TRACKING_APP_ID) ??
+        trackingProductDefaults.defaultAppId;
+    const reportHost = process.env.VOLC_TRACKING_HOST?.trim() || trackingProductDefaults.defaultReportHost;
+    return {
+        enabled,
+        reportHost,
+        appId,
+        appKey,
+        gatePayEnv: getEnvironment(),
+        appName: trackingProductDefaults.appName,
+        appPlatform: trackingProductDefaults.appPlatform,
+        accessMethod: trackingProductDefaults.accessMethod,
+        clientType: trackingProductDefaults.clientType,
+        businessModule: trackingProductDefaults.businessModule,
+        productLine: trackingProductDefaults.productLine,
+        eventName: trackingProductDefaults.eventName,
+    };
+}
 //# sourceMappingURL=env-config.js.map

package/dist/src/config/env-config.js.map

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

package/dist/src/config/tool-display-names.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP 工具英文名 → 中文展示名（埋点 `tool_name_cn`）。
+ * 未配置时回退为原始 `toolName`，避免上报空串。
+ */
+export declare function getToolDisplayName(toolName: string): string;
+/** 供文档 / 测试枚举全部已登记工具名 */
+export declare function listTrackedToolNames(): string[];
+//# sourceMappingURL=tool-display-names.d.ts.map

package/dist/src/config/tool-display-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-display-names.d.ts","sourceRoot":"","sources":["../../../src/config/tool-display-names.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED,yBAAyB;AACzB,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C"}

package/dist/src/config/tool-display-names.js

@@ -0,0 +1,15 @@
+import toolDisplayNames from "./tool-display-names.json";
+const TABLE = toolDisplayNames;
+/**
+ * MCP 工具英文名 → 中文展示名（埋点 `tool_name_cn`）。
+ * 未配置时回退为原始 `toolName`，避免上报空串。
+ */
+export function getToolDisplayName(toolName) {
+    const v = TABLE[toolName];
+    return typeof v === "string" && v.trim() !== "" ? v : toolName;
+}
+/** 供文档 / 测试枚举全部已登记工具名 */
+export function listTrackedToolNames() {
+    return Object.keys(TABLE);
+}
+//# sourceMappingURL=tool-display-names.js.map

package/dist/src/config/tool-display-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-display-names.js","sourceRoot":"","sources":["../../../src/config/tool-display-names.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,2BAA2B,CAAC;AAEzD,MAAM,KAAK,GAAG,gBAA0C,CAAC;AAEzD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACjE,CAAC;AAED,yBAAyB;AACzB,MAAM,UAAU,oBAAoB;IAClC,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC"}

package/dist/src/config/tool-display-names.json

@@ -0,0 +1,15 @@
+{
+    "x402_place_order": "x402 下单探测（无自动签名）",
+    "x402_sign_payment": "x402 签名并支付",
+    "mpp_init_session": "MPP 初始化会话",
+    "mpp_fetch": "MPP 发起 HTTP 请求",
+    "mpp_close_session": "MPP 关闭会话",
+    "mpp_request_close": "MPP 链上请求关闭通道",
+    "mpp_withdraw": "MPP 链上提现",
+    "x402_create_signature": "x402 创建支付签名",
+    "x402_submit_payment": "x402 提交支付",
+    "x402_gate_pay_auth": "Gate Pay 授权登录",
+    "x402_quick_wallet_auth": "快捷钱包授权登录",
+    "x402_centralized_payment": "Gate Pay 中心化支付",
+    "x402_request": "x402 一站式请求（兼容旧版）"
+}

package/dist/src/config/tracking-product-defaults.json

@@ -0,0 +1,12 @@
+{
+    "defaultReportHost": "snssdk.gatedata.org",
+    "defaultAppId": 10000001,
+    "defaultAppKey": "dd447b6237008363f06bd97bbd4a27e0",
+    "appName": "gatepay_local_mcp",
+    "appPlatform": "server",
+    "accessMethod": "MCP",
+    "clientType": "gatepay-local-mcp",
+    "businessModule": "Pay",
+    "productLine": "LOCAL MCP",
+    "eventName": "mcp_tool_call"
+}

package/dist/src/gate-pay/pay-token-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pay-token-store.d.ts","sourceRoot":"","sources":["../../../src/gate-pay/pay-token-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAsBH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,EAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,EAC5B,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI;AACvC,gDAAgD;AAChD,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAgBN;AAiFD;;;GAGG;AACH,wBAAgB,6BAA6B,IAAI,OAAO,CAAC,OAAO,CAAC,CAMhE;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAG9C;AAED,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAGrD;AAED,sCAAsC;AACtC,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAGhD;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAO9C"}
+{"version":3,"file":"pay-token-store.d.ts","sourceRoot":"","sources":["../../../src/gate-pay/pay-token-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0BH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,EAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,EAC5B,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI;AACvC,gDAAgD;AAChD,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAqBN;AAiFD;;;GAGG;AACH,wBAAgB,6BAA6B,IAAI,OAAO,CAAC,OAAO,CAAC,CAMhE;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAG9C;AAED,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAGrD;AAED,sCAAsC;AACtC,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAGhD;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAQ9C"}

package/dist/src/gate-pay/pay-token-store.js

@@ -4,6 +4,7 @@
  */
 import { GATE_DEFAULT_CONFIG, gateOAuthConfigFromEnv, } from "./gate-oauth-config.js";
 import { GateOAuth } from "./gate-oauth-class.js";
+import { recordTrackingGateUid, clearTrackingGateUidSticky, } from "../tracking/tracking-invocation-context.js";
 const EXPIRY_SKEW_MS = 60000;
 /** 接口未返回 access 过期时间时，自签发起默认有效时长 */
 const ACCESS_TOKEN_TTL_MS = 60 * 60 * 1000;
@@ -32,6 +33,12 @@ userId) {
     }
     if (userId !== undefined) {
         gatePayUserId = userId.length > 0 ? userId : null;
+        if (userId.length > 0) {
+            recordTrackingGateUid(userId);
+        }
+        else {
+            clearTrackingGateUidSticky();
+        }
     }
 }
 function effectiveExpiresAtMs() {
@@ -130,5 +137,6 @@ export function clearGatePayAccessToken() {
     gatePayRefreshTokenExpiresAtMs = null;
     gatePayTokenExpiresAtMs = null;
     gatePayTokenIssuedAtMs = null;
+    clearTrackingGateUidSticky();
 }
 //# sourceMappingURL=pay-token-store.js.map

package/dist/src/gate-pay/pay-token-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"pay-token-store.js","sourceRoot":"","sources":["../../../src/gate-pay/pay-token-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pay-token-store.js","sourceRoot":"","sources":["../../../src/gate-pay/pay-token-store.ts"],"names":[],"mappings":"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"}

package/dist/src/index.js

@@ -14,7 +14,9 @@ import { LocalPrivateKeyMode } from "./modes/local-private-key.js";
 import { PluginWalletMode } from "./modes/plugin-wallet.js";
 import { createSignModeRegistry } from "./modes/registry.js";
 import { QuickWalletMode } from "./modes/quick-wallet.js";
-import { getPublicTools, handlePlaceOrder, handleSignPayment, handleCreateSignature, handleSubmitPayment, handleGatePayAuth, handleQuickWalletAuth, handleX402Request, handleCentralizedPayment, } from "./tools/index.js";
+import { getPublicTools, handlePlaceOrder, handleSignPayment, handleMppInitSession, handleMppFetch, handleMppCloseSession, handleMppRequestClose, handleMppWithdraw, handleCreateSignature, handleSubmitPayment, handleGatePayAuth, handleQuickWalletAuth, handleX402Request, handleCentralizedPayment, } from "./tools/index.js";
+import { withTracking } from "./tracking/with-tracking.js";
+import { getTracker } from "./tracking/tracker.js";
 import { createErrorResponse } from "./utils/response-helpers.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 function findPackageRoot(startDir) {
@@ -54,36 +56,55 @@ async function main() {
     }));
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const { name, arguments: args } = request.params;
-        if (name === "x402_place_order") {
-            return await handlePlaceOrder(args ?? {});
-        }
-        if (name === "x402_sign_payment") {
-            return await handleSignPayment(args ?? {}, signModeRegistry);
-        }
-        if (name === "x402_create_signature") {
-            return await handleCreateSignature(args ?? {}, signModeRegistry);
-        }
-        if (name === "x402_submit_payment") {
-            return await handleSubmitPayment(args ?? {});
-        }
-        if (name === "x402_gate_pay_auth") {
-            return await handleGatePayAuth();
-        }
-        if (name === "x402_quick_wallet_auth") {
-            return await handleQuickWalletAuth(args ?? {}, {
-                mcpWalletUrl: quickWalletMcpUrl,
-                mcpApiKey: quickWalletApiKey,
-            });
-        }
-        if (name === "x402_centralized_payment") {
-            return await handleCentralizedPayment(args ?? {});
-        }
-        // Keep x402_request handler for backward compatibility (not exposed in ListTools)
-        if (name === "x402_request") {
-            return await handleX402Request(args ?? {}, signModeRegistry);
-        }
-        return createErrorResponse(`未知工具: ${name}`);
+        return await withTracking(name, args, async () => {
+            if (name === "x402_place_order") {
+                return await handlePlaceOrder(args ?? {});
+            }
+            if (name === "x402_sign_payment") {
+                return await handleSignPayment(args ?? {}, signModeRegistry);
+            }
+            if (name === "mpp_init_session") {
+                return await handleMppInitSession(args ?? {});
+            }
+            if (name === "mpp_fetch") {
+                return await handleMppFetch(args ?? {});
+            }
+            if (name === "mpp_close_session") {
+                return await handleMppCloseSession(args ?? {});
+            }
+            if (name === "mpp_request_close") {
+                return await handleMppRequestClose(args ?? {});
+            }
+            if (name === "mpp_withdraw") {
+                return await handleMppWithdraw(args ?? {});
+            }
+            if (name === "x402_create_signature") {
+                return await handleCreateSignature(args ?? {}, signModeRegistry);
+            }
+            if (name === "x402_submit_payment") {
+                return await handleSubmitPayment(args ?? {});
+            }
+            if (name === "x402_gate_pay_auth") {
+                return await handleGatePayAuth();
+            }
+            if (name === "x402_quick_wallet_auth") {
+                return await handleQuickWalletAuth(args ?? {}, {
+                    mcpWalletUrl: quickWalletMcpUrl,
+                    mcpApiKey: quickWalletApiKey,
+                });
+            }
+            if (name === "x402_centralized_payment") {
+                return await handleCentralizedPayment(args ?? {});
+            }
+            // Keep x402_request handler for backward compatibility (not exposed in ListTools)
+            if (name === "x402_request") {
+                return await handleX402Request(args ?? {}, signModeRegistry);
+            }
+            return createErrorResponse(`未知工具: ${name}`);
+        });
     });
+    // 初始化埋点上报（注册退出钩子 + 定时器）
+    getTracker();
     const stdio = new StdioServerTransport();
     await server.connect(stdio);
 }