gatepay-local-mcp 1.0.3 → 1.0.5

package/Readme.md

@@ -1,32 +1,258 @@
 # gatepay-local-mcp
 
-`gatepay-local-mcp` is a local `stdio` MCP server for calling **x402 payment-protected** HTTP endpoints. It exposes a single MCP tool, `x402_request`. When the upstream service returns `402 Payment Required`, the server parses the payment requirements, prepares the payment payload, signs it with the selected signer, and retries the request automatically.
+`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.
 
 ## Features
 
-- One MCP tool: `x402_request`
-- Built-in x402 payment flow under `src/x402-standalone/`
-- Multiple signing modes via `sign_mode`
+- **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
-- Supports auto-selecting the first ready signing mode
+- 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
+
+### 1. `x402_place_order`
+
+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`.
+
+**Parameters**:
+```typescript
+{
+  url: string;              // Target URL (required)
+  method?: string;          // HTTP method: GET, POST, PUT, PATCH (default: POST)
+  body?: string;            // JSON string request body (optional)
+  sign_mode?: string;       // Signing mode: local_private_key, quick_wallet, plugin_wallet (auto-select if omitted)
+  wallet_login_provider?: string; // OAuth provider: google, gate (default: gate)
+}
+```
+
+**Returns**: Complete response with status code, headers (including `PAYMENT-REQUIRED`), body, and original request details.
+
+---
+
+### 2. `x402_sign_payment`
+
+Parse X402 payment requirements, create a signed payment authorization, and submit the payment to complete a 402-protected request (all-in-one workflow).
+
+**Use case**: Single-step payment flow - parse, sign, and submit in one call.
+
+**Parameters**:
+```typescript
+{
+  url: string;                    // Target URL (required)
+  method?: string;                // HTTP method (default: POST)
+  body?: string;                  // JSON request body (optional)
+  payment_required_header?: string; // Base64-encoded PAYMENT-REQUIRED header
+  response_body?: string;         // Response body from 402 response (alternative to header)
+  sign_mode?: string;             // Signing mode (auto-select if omitted)
+  wallet_login_provider?: string; // OAuth provider (default: gate)
+}
+```
+
+**Returns**: Final response from the merchant after successful payment.
+
+---
+
+### 3. `x402_create_signature`
+
+Parse X402 payment requirements and create a signed payment authorization.
+
+**Use case**: Two-step workflow - create signature first, then submit separately.
+
+**Parameters**:
+```typescript
+{
+  payment_required_header?: string; // Base64-encoded PAYMENT-REQUIRED header
+  response_body?: string;         // Response body from 402 response (alternative to header)
+  sign_mode?: string;             // Signing mode (auto-select if omitted)
+  wallet_login_provider?: string; // OAuth provider (default: gate)
+}
+```
+
+**Returns**: Payment payload and base64-encoded `PAYMENT-SIGNATURE` header value.
+
+---
+
+### 4. `x402_submit_payment`
+
+Submit a signed payment to complete a 402-protected request.
+
+**Use case**: Second step of two-step workflow - submit the signature created by `x402_create_signature`.
+
+**Parameters**:
+```typescript
+{
+  url: string;              // Target URL (required)
+  method?: string;          // HTTP method (default: POST)
+  body?: string;            // JSON request body (optional)
+  payment_signature: string; // Base64-encoded PAYMENT-SIGNATURE from x402_create_signature (required)
+}
+```
+
+**Returns**: Final response from the merchant.
+
+---
+
+### 5. `x402_quick_wallet_auth`
+
+Pre-authorize with Quick Wallet using device-flow OAuth (Google or Gate account).
+
+**Use case**: When using `sign_mode: quick_wallet`, run this first to complete the device-flow login before making payment requests.
+
+**Parameters**:
+```typescript
+{
+  wallet_login_provider?: string; // OAuth provider: google, gate (default: gate)
+}
+```
+
+**Returns**: Authorization status and wallet addresses (EVM and Solana).
+
+---
+
+### 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)
+
+```
+1. x402_place_order         → Get payment requirements
+2. x402_sign_payment        → Sign and submit payment (all-in-one)
+```
+
+### Two-Step Workflow (Advanced)
+
+```
+1. x402_place_order         → Get payment requirements
+2. x402_create_signature    → Create signed payment
+3. x402_submit_payment      → Submit signed payment
+```
+
+### Quick Wallet Pre-Auth
+
+```
+1. x402_quick_wallet_auth   → Authorize with Google/Gate
+2. x402_place_order         → Get payment requirements
+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 currently registers these signing modes:
+The server supports three automatic signing modes plus a dedicated Gate Pay centralized mode:
 
-| `sign_mode`         | Status                                           | Description                                                              |
-| ------------------- | ------------------------------------------------ | ------------------------------------------------------------------------ |
-| `local_private_key` | Ready when `EVM_PRIVATE_KEY` is set              | Signs locally with your EVM private key                                  |
-| `quick_wallet`      | Ready after login                                | Uses the remote MCP wallet and can trigger device-flow login when needed |
-| `plugin_wallet`     | Ready when `PLUGIN_WALLET_TOKEN` is set          | Signs via browser extension wallet (e.g., Gate Wallet)                   |
+| `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` |
 
-If `sign_mode` is omitted, the server auto-selects the highest-priority ready mode.
+**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
+
+The server automatically selects the highest-priority ready mode.
+
+### Network Support
+
+- **EVM Networks**: Ethereum, Base, Polygon, Arbitrum One, GateChain, GateLayer
+- **Solana Networks**: Solana Mainnet, Solana Devnet
 
 ## Quick Start
 
-### Cursor / Claude Desktop with local private key
+### 1. Local Private Key Mode (EVM + Solana)
+
+This is the simplest setup for local signing with your own private keys:
+
+```json
+{
+  "mcpServers": {
+    "gatepay-mcp": {
+      "command": "npx",
+      "args": ["-y", "gatepay-local-mcp"],
+      "env": {
+        "EVM_PRIVATE_KEY": "your-evm-private-key-hex-with-or-without-0x-prefix",
+        "SVM_PRIVATE_KEY": "your-solana-private-key-base58-optional"
+      }
+    }
+  }
+}
+```
+
+- Set `EVM_PRIVATE_KEY` for EVM network payments (Ethereum, Base, Polygon, etc.)
+- Set `SVM_PRIVATE_KEY` for Solana network payments (optional)
+- Put this into your MCP config such as `~/.cursor/mcp.json`, then restart or reload MCP
+
+### 2. Quick Wallet Mode (Custodial)
+
+Remote wallet signing with device-flow OAuth (Google or Gate account):
+
+```json
+{
+  "mcpServers": {
+    "gatepay-mcp": {
+      "command": "npx",
+      "args": ["-y", "gatepay-local-mcp"],
+      "env": {
+        "QUICK_WALLET_MCP_URL": "https://walletmcp.gate.com/mcp",
+        "QUICK_WALLET_API_KEY": "your-api-key-optional"
+      }
+    }
+  }
+}
+```
+
+- First payment will trigger device-flow login (opens browser)
+- Token is persisted at `~/.gate-pay/auth.json`
+- Use `x402_quick_wallet_auth` tool to pre-authorize
 
-This is the simplest setup if you want local signing:
+### 3. Plugin Wallet Mode (Browser Extension)
+
+Sign with browser extension wallet (e.g., Gate Wallet):
 
 ```json
 {
@@ -35,31 +261,44 @@ This is the simplest setup if you want local signing:
       "command": "npx",
       "args": ["-y", "gatepay-local-mcp"],
       "env": {
-        "EVM_PRIVATE_KEY": "your-evm-private-key-hex-with-or-without-0x-prefix"
+        "PLUGIN_WALLET_TOKEN": "your-plugin-wallet-mcp-token"
       }
     }
   }
 }
 ```
 
-Put this into your MCP config such as `~/.cursor/mcp.json`, then restart the client or reload MCP.
+- Get the token from your browser extension wallet
+- Requires the wallet extension to be installed and running
+- User confirms transactions in the browser extension
 
-### Cursor / Claude Desktop with quick wallet
+### 4. Gate Pay Centralized Payment (Browser OAuth)
 
-If you prefer remote wallet signing, you can omit `EVM_PRIVATE_KEY` and let the tool use `quick_wallet`. Note that you need to obtain API credentials from the wallet service provider.
+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"]
+      "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"
+      }
     }
   }
 }
 ```
 
-When `quick_wallet` has no saved token, the server can start a device-flow login and persist the token at `~/.gate-pay/auth.json`.
+- 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
 
@@ -90,15 +329,34 @@ Before using plugin wallet mode:
 
 The server loads `.env` from the repository or package root at startup.
 
-### Runtime variables
-
-| Variable                    | Required | Default | Description                                                                 |
-| --------------------------- | -------- | ------- | --------------------------------------------------------------------------- |
-| `EVM_PRIVATE_KEY`           | No       | —       | Local EVM private key used by `local_private_key`; hex with or without `0x` |
-| `PLUGIN_WALLET_SERVER_URL`  | No       | —       | Base URL for the plugin wallet MCP server (required for `plugin_wallet`)   |
-| `PLUGIN_WALLET_TOKEN`       | No       | —       | Authentication token for plugin wallet (required for `plugin_wallet`)      |
-
-### Test and script variables
+### Signing Mode Configuration
+
+| Variable                  | Mode                | Description                                                                 |
+| ------------------------- | ------------------- | --------------------------------------------------------------------------- |
+| `EVM_PRIVATE_KEY`         | `local_private_key` | Local EVM private key; hex with or without `0x` prefix                      |
+| `SVM_PRIVATE_KEY`      | `local_private_key` | Local Solana private key; base58 encoded (optional)                         |
+| `QUICK_WALLET_MCP_URL`    | `quick_wallet`      | MCP wallet endpoint URL (default: `https://walletmcp.gate.com/mcp`)         |
+| `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                                     |
 | ----------------------------- | ------------------------------- | ----------------------- | ----------------------------------------------- |
@@ -106,55 +364,101 @@ The server loads `.env` from the repository or package root at startup.
 | `ENDPOINT_PATH`               | `test/privateKey.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       |
 
-## Available Tool
+## Usage Examples
 
-### `x402_request`
+### Example 1: Single-Step Payment (Recommended)
 
-Executes a single HTTP request to an x402-protected endpoint. If the response is `402 Payment Required`, the server completes the payment flow and retries automatically.
-
-Use this tool only for endpoints that are expected to require x402 payment.
-
-| Argument                | Type   | Required | Description                                                                     |
-| ----------------------- | ------ | -------- | ------------------------------------------------------------------------------- |
-| `url`                   | string | Yes      | Full `http` or `https` URL                                                      |
-| `method`                | string | No       | `GET`, `POST`, `PUT`, or `PATCH`; default is `POST`                             |
-| `body`                  | string | No       | JSON string request body; omit for `GET`                                        |
-| `sign_mode`             | string | No       | Preferred signing mode: `local_private_key`, `quick_wallet`, or `plugin_wallet` |
-| `wallet_login_provider` | string | No       | Login provider for `quick_wallet`: `google` or `gate`; default is `gate`        |
+```json
+// Step 1: Place order to get payment requirements
+{
+  "tool": "x402_place_order",
+  "arguments": {
+    "url": "https://api.example.com/order",
+    "method": "POST",
+    "body": "{\"flightId\":\"FL001\",\"uid\":\"100\"}"
+  }
+}
 
-### Tool examples
+// Step 2: If 402 response, sign and submit payment
+{
+  "tool": "x402_sign_payment",
+  "arguments": {
+    "url": "https://api.example.com/order",
+    "method": "POST",
+    "body": "{\"flightId\":\"FL001\",\"uid\":\"100\"}",
+    "payment_required_header": "<base64-from-place_order>",
+    "sign_mode": "quick_wallet"
+  }
+}
+```
 
-GET request with automatic mode selection:
+### Example 2: Two-Step Payment (Advanced)
 
 ```json
+// Create signature first
 {
-  "url": "https://api.example.com/resource"
+  "tool": "x402_create_signature",
+  "arguments": {
+    "payment_required_header": "<base64>",
+    "sign_mode": "local_private_key"
+  }
+}
+
+// Then submit separately
+{
+  "tool": "x402_submit_payment",
+  "arguments": {
+    "url": "https://api.example.com/order",
+    "payment_signature": "<base64-from-create_signature>"
+  }
 }
 ```
 
-POST request with explicit local signing:
+### Example 3: Quick Wallet with Pre-Auth
 
 ```json
+// Pre-authorize (opens browser for OAuth)
 {
-  "url": "https://api.example.com/order",
-  "method": "POST",
-  "body": "{\"flightId\":\"FL001\",\"uid\":\"100\"}",
-  "sign_mode": "local_private_key"
+  "tool": "x402_quick_wallet_auth",
+  "arguments": {
+    "wallet_login_provider": "gate"
+  }
 }
 ```
 
-POST request with quick wallet login through Gate:
+### 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
 {
-  "url": "https://api.example.com/order",
-  "method": "POST",
-  "body": "{\"flightId\":\"FL001\",\"uid\":\"100\"}",
-  "sign_mode": "quick_wallet",
-  "wallet_login_provider": "gate"
+  "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.
+
+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
 
 ```bash
@@ -191,15 +495,6 @@ npm run test:mcp-tool
 
 If you already logged in before, the saved token in `~/.gate-pay/auth.json` will be reused. Otherwise the quick wallet flow may require interactive device login. You can increase the timeout with `GATEPAY_MCP_TEST_TIMEOUT_MS`.
 
-## How It Works
-
-1. The MCP client calls `x402_request`.
-2. The server normalizes the input and selects a ready `sign_mode`.
-3. The first request is sent to the target URL.
-4. If the upstream returns `402 Payment Required`, the server parses the payment requirements.
-5. The selected signer signs the payment payload.
-6. The server retries the request with the payment header and returns the final response.
-
 ## License
 
 MIT

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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"}