gatepay-local-mcp 1.0.4 → 1.0.6

package/Readme.md

@@ -4,12 +4,13 @@
 
 ## Features
 
-- **5 MCP Tools** for flexible X402 payment workflows
+- **7 MCP Tools** covering order placement, signature flows, quick wallet / Gate Pay auth, and centralized payment retries
 - Built-in X402 payment flow under `src/x402/`
 - **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
 - Auto-selects the first ready signing mode if not specified
+- Gate Pay centralized payment (`sign_mode: centralized_payment`) and `x402_centralized_payment` helper for merchant-side settlement
 
 ## Available Tools
 
@@ -114,6 +115,35 @@ Pre-authorize with Quick Wallet using device-flow OAuth (Google or Gate account)
 
 ---
 
+### 6. `x402_gate_pay_auth`
+
+Complete the Gate Pay OAuth device flow (browser authorize URL + localhost callback + remote token exchange) and cache the resulting access token/UID for centralized payments.
+
+**Use case**: Required before calling `x402_submit_payment` with `sign_mode: centralized_payment` or when preparing to use `x402_centralized_payment`.
+
+**Parameters**: _None_
+
+**Returns**: Current authorization status with masked Gate Pay UID and access token indicators.
+
+---
+
+### 7. `x402_centralized_payment`
+
+Parse the Base64-encoded `PAYMENT-REQUIRED` header and complete the Gate Pay centralized payment flow without submitting a `PAYMENT-SIGNATURE`.
+
+**Use case**: When a merchant expects Gate Pay centralized settlement (e.g., OTA or off-chain marketplace) and you prefer an all-in-one helper instead of crafting `PAYMENT-SIGNATURE`.
+
+**Parameters**:
+```typescript
+{
+  payment_required_header: string; // Base64-encoded PAYMENT-REQUIRED header (required)
+}
+```
+
+**Returns**: Payment confirmation including `prepayId`, `merchantTradeNo`, currency, amount, and the raw API response.
+
+---
+
 ## Workflow Examples
 
 ### Single-Step Workflow (Recommended)
@@ -139,17 +169,28 @@ Pre-authorize with Quick Wallet using device-flow OAuth (Google or Gate account)
 3. x402_sign_payment        → Sign and submit (using quick_wallet)
 ```
 
+### Centralized Payment (Gate Pay)
+
+```
+1. x402_gate_pay_auth       → Browser OAuth + token exchange (repeat when token expires)
+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
+```
+
 ## Signing Modes
 
-The server supports three signing modes with automatic selection:
+The server supports three automatic signing modes plus a dedicated Gate Pay centralized mode:
 
-| `sign_mode`         | Status                                        | Networks    | Description                                                              |
-| ------------------- | --------------------------------------------- | ----------- | ------------------------------------------------------------------------ |
-| `local_private_key` | Ready when `EVM_PRIVATE_KEY` / `SVM_PRIVATE_KEY` set | EVM, Solana | Signs locally with your private keys (no external dependencies)          |
-| `quick_wallet`      | Ready after OAuth login                       | EVM, Solana | Custodial MCP wallet with device-flow login (Google/Gate account)        |
-| `plugin_wallet`     | Ready when `PLUGIN_WALLET_TOKEN` set          | EVM, Solana | Browser extension wallet (e.g., Gate Wallet) via MCP bridge              |
+| `sign_mode`             | Status                                        | Networks / Scope | Description                                                                                     |
+| ----------------------- | --------------------------------------------- | ---------------- | ----------------------------------------------------------------------------------------------- |
+| `local_private_key`     | Ready when `EVM_PRIVATE_KEY` / `SVM_PRIVATE_KEY` set | EVM, Solana      | Signs locally with your private keys (no external dependencies)                                 |
+| `quick_wallet`          | Ready after OAuth login                       | EVM, Solana      | Custodial MCP wallet with device-flow login (Google/Gate account)                               |
+| `plugin_wallet`         | Ready when `PLUGIN_WALLET_TOKEN` set          | EVM, Solana      | Browser extension wallet (e.g., Gate Wallet) via MCP bridge                                     |
+| `centralized_payment`   | Ready after `x402_gate_pay_auth` completes    | Gate Pay         | Adds `Authorization: Bearer <Gate Pay access_token>` when calling `x402_submit_payment` or use `x402_centralized_payment` |
 
-**Priority Order** (when `sign_mode` is omitted):
+**Priority Order** (auto-selection applies to the first three rows when `sign_mode` is omitted):
 1. `plugin_wallet` (priority: 30) - if token configured
 2. `quick_wallet` (priority: 20) - if MCP endpoint configured  
 3. `local_private_key` (priority: 10) - if private keys configured
@@ -231,6 +272,34 @@ Sign with browser extension wallet (e.g., Gate Wallet):
 - Requires the wallet extension to be installed and running
 - User confirms transactions in the browser extension
 
+### 4. Gate Pay Centralized Payment (Browser OAuth)
+
+Use this when merchants expect Gate Pay centralized settlement instead of user-owned signatures.
+
+```json
+{
+  "mcpServers": {
+    "gatepay-mcp": {
+      "command": "npx",
+      "args": ["-y", "gatepay-local-mcp"],
+      "env": {
+        "GATE_PAY_OAUTH_CLIENT_ID": "your-gate-pay-client-id",
+        "GATE_PAY_OAUTH_CLIENT_SECRET": "your-gate-pay-client-secret",
+        "GATE_PAY_OAUTH_BACKEND_ORIGIN": "https://www.gate.com/apiw/v2/mcp/oauth",
+        "GATE_PAY_ACCOUNT_AUTHORIZE_ORIGIN": "https://gate.com",
+        "GATE_PAY_OAUTH_CALLBACK_PORT": "18473",
+        "GATE_PAY_CENTRALIZED_PAYMENT_URL": "https://api.gateio.ws/api/v4/pay/ai/order/pay",
+        "GATE_PAY_CLIENT_ID": "your-gate-pay-client-id"
+      }
+    }
+  }
+}
+```
+
+- 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.
+
 ### Cursor / Claude Desktop with plugin wallet
 
 If you want to use a browser extension wallet (like Gate Wallet) for signing, configure the plugin wallet mode:
@@ -270,6 +339,23 @@ 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                                     |
 
+### Gate Pay Centralized Payment
+
+| Variable                          | Description                                                                                   |
+| --------------------------------- | --------------------------------------------------------------------------------------------- |
+| `GATE_PAY_OAUTH_CLIENT_ID`        | Gate Pay OAuth client id used for device authorization and token exchange                     |
+| `GATE_PAY_OAUTH_CLIENT_SECRET`    | Client secret required when exchanging the authorization code for an access token             |
+| `GATE_PAY_OAUTH_BACKEND_ORIGIN`   | Base URL for the OAuth backend that hosts the token/refresh endpoints                         |
+| `GATE_PAY_ACCOUNT_AUTHORIZE_ORIGIN` | Domain that serves the Gate Pay authorization page (opens in the browser)                     |
+| `GATE_PAY_OAUTH_CALLBACK_PORT`    | Local port used to receive the OAuth redirect (set to `0` for a random port if needed)        |
+| `GATE_PAY_OAUTH_SCOPE`            | OAuth scope requested during device/login flow                                                |
+| `GATE_PAY_OAUTH_AUTHORIZE_USER_AGENT` | Custom User-Agent for the authorization preflight (defaults to `gateio/web`)                 |
+| `GATE_PAY_CENTRALIZED_PAYMENT_URL`| HTTPS endpoint for submitting centralized payments via Gate Pay                               |
+| `GATE_PAY_CLIENT_ID`              | Merchant client id embedded in centralized payment payloads                                   |
+| `GATE_PAY_OAUTH_TOKEN_BASE_URL`   | Optional: origin used to derive default token and refresh endpoints                           |
+| `GATE_PAY_OAUTH_TOKEN_URL`        | Optional: explicit token endpoint path override                                               |
+| `GATE_PAY_OAUTH_REFRESH_URL`      | Optional: explicit refresh endpoint path override                                             |
+
 ### Test and Script Variables
 
 | Variable                      | Used By                         | Default                 | Description                                     |
@@ -340,10 +426,38 @@ The server loads `.env` from the repository or package root at startup.
 }
 ```
 
+### Example 4: Gate Pay Centralized Payment
+
+```json
+// Step 1: Run OAuth (opens Gate authorize page)
+{ "tool": "x402_gate_pay_auth", "arguments": {} }
+
+// Step 2a: Use centralized helper
+{
+  "tool": "x402_centralized_payment",
+  "arguments": {
+    "payment_required_header": "<base64-from-place_order>"
+  }
+}
+
+// Step 2b: Or submit with sign_mode: centralized_payment
+{
+  "tool": "x402_submit_payment",
+  "arguments": {
+    "url": "https://api.example.com/order",
+    "method": "POST",
+    "payment_signature": "<base64-from-create_signature>",
+    "sign_mode": "centralized_payment"
+  }
+}
+```
+
 ## 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/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.
 
-For AI agents that orchestrate x402 payments, wallet setup, and merchant discovery, this repository ships an **[Agent Skill](gatepay-local-mcp/skills/SKILL.md at master · gate/gatepay-local-mcp)** at [`skills/SKILL.md`]. Install it in your host’s skills directory or point auto-update at the raw file on your default branch. **Tool names and arguments always follow each tool’s MCP `inputSchema`** on the server you connected; the skill may describe flows that apply across builds, while this package’s exposed tools depend on the version you run (e.g. the minimal npm build exposes `x402_request` only—see the tool list in your client).
+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.
 
 ## Development
 

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

@@ -0,0 +1,32 @@
+/**
+ * 环境配置管理模块
+ * 支持通过 GATE_PAY_ENV 环境变量在 test 和 prd 环境间切换
+ */
+export type Environment = "test" | "prd";
+/**
+ * 环境配置接口
+ */
+export interface EnvironmentConfig {
+    oauthClientId: string;
+    oauthClientSecret: string;
+    oauthBackendOrigin: string;
+    accountAuthorizeOrigin: string;
+    oauthCallbackPort: number;
+    centralizedPaymentUrl: string;
+    paymentClientId: string;
+    quickWalletServerUrl: string;
+    pluginWalletServerUrl: string;
+    oauthScope: string;
+    oauthAuthorizeUserAgent: string;
+}
+/**
+ * 获取当前环境（test 或 prd）
+ * 默认为 prd
+ */
+export declare function getEnvironment(): Environment;
+/**
+ * 获取最终环境配置
+ * 优先级：直接设置的环境变量 > GATE_PAY_ENV 预设配置 > 默认值
+ */
+export declare function getEnvConfig(): EnvironmentConfig;
+//# sourceMappingURL=env-config.d.ts.map

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

@@ -0,0 +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;IAG9B,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAkDD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAG5C;AAUD;;;GAGG;AACH,wBAAgB,YAAY,IAAI,iBAAiB,CAoChD"}

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

@@ -0,0 +1,98 @@
+/**
+ * 环境配置管理模块
+ * 支持通过 GATE_PAY_ENV 环境变量在 test 和 prd 环境间切换
+ */
+/**
+ * 测试环境配置
+ */
+const TEST_CONFIG = {
+    // OAuth 配置
+    oauthClientId: "mZ96D37oKk-HrWJc",
+    oauthClientSecret: "QcICEvHYl4zlqd27AD8Grw1s78ni989RK1t3igeRdN0=",
+    oauthBackendOrigin: "http://dev.halftrust.xyz/oauth2",
+    accountAuthorizeOrigin: "https://14099.gateio.tech",
+    oauthCallbackPort: 18473,
+    // 中心化支付
+    centralizedPaymentUrl: "http://dev.halftrust.xyz/payment-service/payment/gatepay/v2/pay/ai/order/pay",
+    paymentClientId: "mZ96D37oKk-HrWJc",
+    // 钱包服务
+    quickWalletServerUrl: "https://wallet-service-mcp-test.gateweb3.cc/mcp",
+    pluginWalletServerUrl: "https://walletmcp-test.gateweb3.cc/mcp",
+    // 其他配置
+    oauthScope: "read_profile",
+    oauthAuthorizeUserAgent: "gateio/web",
+};
+/**
+ * 生产环境配置
+ */
+const PRD_CONFIG = {
+    // OAuth 配置
+    oauthClientId: "kIWkpCQBJUPWNuDo",
+    oauthClientSecret: "u4tyiLBhryczzT_5XcmHLVYQkWYhCIbPH1ejtXqiuLs=",
+    oauthBackendOrigin: "https://www.gate.com/apiw/v2/mcp/oauth",
+    accountAuthorizeOrigin: "https://gate.com",
+    oauthCallbackPort: 18473,
+    // 中心化支付
+    centralizedPaymentUrl: "https://api.gateio.ws/api/v4/pay/ai/order/pay",
+    paymentClientId: "kIWkpCQBJUPWNuDo",
+    // 钱包服务
+    quickWalletServerUrl: "https://api.gatemcp.ai/mcp/dex",
+    pluginWalletServerUrl: "https://walletmcp.gate.com/mcp",
+    // 其他配置
+    oauthScope: "read_profile",
+    oauthAuthorizeUserAgent: "gateio/web",
+};
+/**
+ * 获取当前环境（test 或 prd）
+ * 默认为 prd
+ */
+export function getEnvironment() {
+    const env = process.env.GATE_PAY_ENV?.toLowerCase().trim();
+    return env === "test" ? "test" : "prd";
+}
+/**
+ * 获取基础环境配置（根据 GATE_PAY_ENV）
+ */
+function getBaseConfig() {
+    const env = getEnvironment();
+    return env === "test" ? TEST_CONFIG : PRD_CONFIG;
+}
+/**
+ * 获取最终环境配置
+ * 优先级：直接设置的环境变量 > GATE_PAY_ENV 预设配置 > 默认值
+ */
+export function getEnvConfig() {
+    const baseConfig = getBaseConfig();
+    return {
+        // OAuth 配置
+        oauthClientId: process.env.GATE_PAY_OAUTH_CLIENT_ID?.trim() || baseConfig.oauthClientId,
+        oauthClientSecret: process.env.GATE_PAY_OAUTH_CLIENT_SECRET?.trim() || baseConfig.oauthClientSecret,
+        oauthBackendOrigin: process.env.GATE_PAY_OAUTH_BACKEND_ORIGIN?.trim()?.replace(/\/$/, "") ||
+            baseConfig.oauthBackendOrigin,
+        accountAuthorizeOrigin: process.env.GATE_PAY_ACCOUNT_AUTHORIZE_ORIGIN?.trim()?.replace(/\/$/, "") ||
+            baseConfig.accountAuthorizeOrigin,
+        oauthCallbackPort: parseCallbackPort() ?? baseConfig.oauthCallbackPort,
+        // 中心化支付
+        centralizedPaymentUrl: process.env.GATE_PAY_CENTRALIZED_PAYMENT_URL?.trim() ||
+            baseConfig.centralizedPaymentUrl,
+        paymentClientId: process.env.GATE_PAY_CLIENT_ID?.trim() || baseConfig.paymentClientId,
+        // 钱包服务
+        quickWalletServerUrl: process.env.QUICK_WALLET_SERVER_URL?.trim() || baseConfig.quickWalletServerUrl,
+        pluginWalletServerUrl: process.env.PLUGIN_WALLET_SERVER_URL?.trim() || baseConfig.pluginWalletServerUrl,
+        // 其他配置
+        oauthScope: process.env.GATE_PAY_OAUTH_SCOPE?.trim() || baseConfig.oauthScope,
+        oauthAuthorizeUserAgent: process.env.GATE_PAY_OAUTH_AUTHORIZE_USER_AGENT?.trim() ||
+            baseConfig.oauthAuthorizeUserAgent,
+    };
+}
+/**
+ * 解析回调端口
+ */
+function parseCallbackPort() {
+    const portStr = process.env.GATE_PAY_OAUTH_CALLBACK_PORT?.trim();
+    if (!portStr)
+        return undefined;
+    const n = parseInt(portStr, 10);
+    return Number.isNaN(n) ? undefined : n;
+}
+//# sourceMappingURL=env-config.js.map

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

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

package/dist/src/gate-pay/auth.d.ts

@@ -0,0 +1,18 @@
+export type GatePayAuthPhase = "already_authenticated" | "login_succeeded";
+/** `ensureGatePayAccessTokenAndUid` 成功时的 access_token、用户 id 与是否本次新登录 */
+export interface GatePayAuthResult {
+    accessToken: string;
+    uid: string;
+    phase: GatePayAuthPhase;
+}
+/**
+ * 若进程内已有有效 Gate Pay access_token（含临近过期时用 refresh_token 刷新）则跳过；
+ * 否则走浏览器 OAuth（localhost 回调 + 远程换 token）。
+ */
+export declare function runGatePayDeviceAuthIfNeeded(): Promise<GatePayAuthPhase>;
+/**
+ * 若进程内已有有效 Gate Pay access_token（含 refresh）则直接返回 token 与 uid；
+ * 否则走与 `runGatePayDeviceAuthIfNeeded` 相同的浏览器 OAuth，完成后返回 token 与 uid。
+ */
+export declare function ensureGatePayAccessTokenAndUid(): Promise<GatePayAuthResult>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/src/gate-pay/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/gate-pay/auth.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,gBAAgB,GAAG,uBAAuB,GAAG,iBAAiB,CAAC;AAE3E,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAoB9E;AAED;;;GAGG;AACH,wBAAsB,8BAA8B,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAWjF"}

package/dist/src/gate-pay/auth.js

@@ -0,0 +1,38 @@
+import { ensureGatePayAccessTokenFresh, getGatePayAccessToken, getGatePayUserId, isGatePayTokenUsable, } from "./pay-token-store.js";
+import { loginWithGatePayDeviceFlow } from "./device-flow.js";
+/**
+ * 若进程内已有有效 Gate Pay access_token（含临近过期时用 refresh_token 刷新）则跳过；
+ * 否则走浏览器 OAuth（localhost 回调 + 远程换 token）。
+ */
+export async function runGatePayDeviceAuthIfNeeded() {
+    await ensureGatePayAccessTokenFresh();
+    if (isGatePayTokenUsable()) {
+        return "already_authenticated";
+    }
+    console.error("[Gate Pay] 无有效 access_token，开始 OAuth 授权（本地回调 + 远程换 token）…");
+    const ok = await loginWithGatePayDeviceFlow();
+    if (!ok) {
+        throw new Error("Gate Pay 授权未完成（取消、失败、超时或远程换 token 失败）");
+    }
+    if (!getGatePayAccessToken()) {
+        throw new Error("Gate Pay 授权成功但未写入 access_token");
+    }
+    return "login_succeeded";
+}
+/**
+ * 若进程内已有有效 Gate Pay access_token（含 refresh）则直接返回 token 与 uid；
+ * 否则走与 `runGatePayDeviceAuthIfNeeded` 相同的浏览器 OAuth，完成后返回 token 与 uid。
+ */
+export async function ensureGatePayAccessTokenAndUid() {
+    const phase = await runGatePayDeviceAuthIfNeeded();
+    const accessToken = getGatePayAccessToken();
+    if (!accessToken) {
+        throw new Error("Gate Pay 授权后仍无 access_token");
+    }
+    return {
+        accessToken,
+        uid: getGatePayUserId() ?? "",
+        phase,
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/src/gate-pay/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/gate-pay/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAW9D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B;IAChD,MAAM,6BAA6B,EAAE,CAAC;IACtC,IAAI,oBAAoB,EAAE,EAAE,CAAC;QAC3B,OAAO,uBAAuB,CAAC;IACjC,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAE5E,MAAM,EAAE,GAAG,MAAM,0BAA0B,EAAE,CAAC;IAC9C,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CACb,uCAAuC,CACxC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B;IAClD,MAAM,KAAK,GAAG,MAAM,4BAA4B,EAAE,CAAC;IACnD,MAAM,WAAW,GAAG,qBAAqB,EAAE,CAAC;IAC5C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IACD,OAAO;QACL,WAAW;QACX,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE;QAC7B,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/src/gate-pay/centralized-payment/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 中心化支付模块
+ */
+export { parsePaymentRequiredHeader, extractPaymentInfo, type PaymentRequiredData, type ExtractedPaymentInfo, } from "./parser.js";
+export { submitCentralizedPayment, getPaymentUrl, getClientId, type CentralizedPaymentConfig, type PaymentResponse, } from "./payment-client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/gate-pay/centralized-payment/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/gate-pay/centralized-payment/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,wBAAwB,EACxB,aAAa,EACb,WAAW,EACX,KAAK,wBAAwB,EAC7B,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAC"}

package/dist/src/gate-pay/centralized-payment/index.js

@@ -0,0 +1,6 @@
+/**
+ * 中心化支付模块
+ */
+export { parsePaymentRequiredHeader, extractPaymentInfo, } from "./parser.js";
+export { submitCentralizedPayment, getPaymentUrl, getClientId, } from "./payment-client.js";
+//# sourceMappingURL=index.js.map

package/dist/src/gate-pay/centralized-payment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/gate-pay/centralized-payment/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,GAGnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,wBAAwB,EACxB,aAAa,EACb,WAAW,GAGZ,MAAM,qBAAqB,CAAC"}

package/dist/src/gate-pay/centralized-payment/parser.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 中心化支付 - PAYMENT-REQUIRED header 解析器
+ */
+export interface PaymentRequiredData {
+    x402Version: number;
+    error?: string;
+    resource: {
+        url: string;
+        description?: string;
+        mimeType?: string;
+        orderId: string;
+    };
+    accepts: Array<{
+        scheme: string;
+        network: string;
+        amount: string;
+        asset: string;
+        payTo?: string;
+        maxTimeoutSeconds?: number;
+        extra?: {
+            name?: string;
+            prepayId: string;
+            expireTime?: number;
+            feePayer?: string;
+            version?: string;
+            orderId?: string;
+            [key: string]: unknown;
+        };
+    }>;
+}
+export interface ExtractedPaymentInfo {
+    prepayId: string;
+    merchantTradeNo: string;
+    currency: string;
+    totalFee: string;
+    payCurrency: string;
+    payAmount: string;
+    uid: string;
+}
+/**
+ * 解析 base64 编码的 PAYMENT-REQUIRED header
+ */
+export declare function parsePaymentRequiredHeader(base64Header: string): PaymentRequiredData;
+/**
+ * 从解析后的数据中提取支付信息
+ * amount 需要除以 10^6 转换为实际金额
+ * uid 参数可选，用于指定用户 ID
+ */
+export declare function extractPaymentInfo(data: PaymentRequiredData, uid?: string): ExtractedPaymentInfo;
+//# sourceMappingURL=parser.d.ts.map

package/dist/src/gate-pay/centralized-payment/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../src/gate-pay/centralized-payment/parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE;QACR,GAAG,EAAE,MAAM,CAAC;QACZ,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,OAAO,EAAE,KAAK,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,KAAK,CAAC,EAAE;YACN,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,QAAQ,EAAE,MAAM,CAAC;YACjB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;SACxB,CAAC;KACH,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB,CAgBpF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,mBAAmB,EACzB,GAAG,CAAC,EAAE,MAAM,GACX,oBAAoB,CAoCtB"}

package/dist/src/gate-pay/centralized-payment/parser.js

@@ -0,0 +1,59 @@
+/**
+ * 中心化支付 - PAYMENT-REQUIRED header 解析器
+ */
+/**
+ * 解析 base64 编码的 PAYMENT-REQUIRED header
+ */
+export function parsePaymentRequiredHeader(base64Header) {
+    try {
+        const decoded = Buffer.from(base64Header, "base64").toString("utf-8");
+        const parsed = JSON.parse(decoded);
+        if (!parsed.accepts || !Array.isArray(parsed.accepts) || parsed.accepts.length === 0) {
+            throw new Error("PAYMENT-REQUIRED header 缺少 accepts 数组");
+        }
+        return parsed;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`解析 PAYMENT-REQUIRED header 失败: ${error.message}`);
+        }
+        throw new Error("解析 PAYMENT-REQUIRED header 失败: 未知错误");
+    }
+}
+/**
+ * 从解析后的数据中提取支付信息
+ * amount 需要除以 10^6 转换为实际金额
+ * uid 参数可选，用于指定用户 ID
+ */
+export function extractPaymentInfo(data, uid) {
+    const firstAccept = data.accepts[0];
+    if (!firstAccept) {
+        throw new Error("accepts 数组为空，无法提取支付信息");
+    }
+    if (!firstAccept.extra?.prepayId) {
+        throw new Error("缺少必需的 extra.prepayId 字段");
+    }
+    const orderId = data.resource.orderId || firstAccept.extra?.orderId || "";
+    if (!orderId) {
+        throw new Error("缺少 orderId 字段");
+    }
+    // 金额转换：除以 10^6，保留最多 8 位小数
+    const amountInSmallestUnit = BigInt(firstAccept.amount);
+    const divisor = 1000000;
+    // 将 BigInt 转换为 Number 进行浮点除法
+    const amountInMainUnit = Number(amountInSmallestUnit) / divisor;
+    // 保留最多 8 位小数，去除尾部多余的 0
+    const totalFee = amountInMainUnit.toFixed(8).replace(/\.?0+$/, "");
+    // 提取币种名称
+    const currency = firstAccept.extra?.name || "USDC";
+    return {
+        prepayId: firstAccept.extra.prepayId,
+        merchantTradeNo: orderId,
+        currency,
+        totalFee,
+        payCurrency: currency,
+        payAmount: totalFee,
+        uid: uid || "",
+    };
+}
+//# sourceMappingURL=parser.js.map

package/dist/src/gate-pay/centralized-payment/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../../src/gate-pay/centralized-payment/parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAwCH;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,YAAoB;IAC7D,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAwB,CAAC;QAE1D,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrF,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,kCAAkC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAyB,EACzB,GAAY;IAEZ,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAEpC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,WAAW,CAAC,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC;IAC1E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACnC,CAAC;IAED,0BAA0B;IAC1B,MAAM,oBAAoB,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,OAAS,CAAC;IAC1B,6BAA6B;IAC7B,MAAM,gBAAgB,GAAG,MAAM,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC;IAChE,uBAAuB;IACvB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAEnE,SAAS;IACT,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,IAAI,MAAM,CAAC;IAEnD,OAAO;QACL,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,QAAQ;QACpC,eAAe,EAAE,OAAO;QACxB,QAAQ;QACR,QAAQ;QACR,WAAW,EAAE,QAAQ;QACrB,SAAS,EAAE,QAAQ;QACnB,GAAG,EAAE,GAAG,IAAI,EAAE;KACf,CAAC;AACJ,CAAC"}

package/dist/src/gate-pay/centralized-payment/payment-client.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 中心化支付 - 支付客户端
+ */
+import type { ExtractedPaymentInfo } from "./parser.js";
+export interface CentralizedPaymentConfig {
+    paymentUrl?: string;
+    clientId?: string;
+}
+export interface PaymentResponse {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+    statusCode: number;
+    responseBody?: string;
+}
+/**
+ * 获取中心化支付 API 地址（优先使用环境变量）
+ */
+export declare function getPaymentUrl(config?: CentralizedPaymentConfig): string;
+/**
+ * 获取 Client ID（优先使用环境变量）
+ */
+export declare function getClientId(config?: CentralizedPaymentConfig): string;
+/**
+ * 调用中心化支付 API
+ */
+export declare function submitCentralizedPayment(paymentInfo: ExtractedPaymentInfo, accessToken: string, config?: CentralizedPaymentConfig): Promise<PaymentResponse>;
+//# sourceMappingURL=payment-client.d.ts.map

package/dist/src/gate-pay/centralized-payment/payment-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-client.d.ts","sourceRoot":"","sources":["../../../../src/gate-pay/centralized-payment/payment-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGxD,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,wBAAwB,GAAG,MAAM,CAKvE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,wBAAwB,GAAG,MAAM,CAKrE;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,oBAAoB,EACjC,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,wBAAwB,GAChC,OAAO,CAAC,eAAe,CAAC,CA+D1B"}