hchain-mcp 1.0.0

package/dist/adapters/onchainos.js

@@ -0,0 +1,275 @@
+/**
+ * Onchain OS REST API 适配层
+ * Base: https://web3.okx.com
+ * 按官方文档逐端点对接，杜绝幻觉
+ */
+import crypto from "node:crypto";
+const BASE = "https://web3.okx.com";
+function ts() { return new Date().toISOString().replace(/(\.\d{3})\d*Z/, "$1Z"); }
+function buildQuery(p) {
+    const s = new URLSearchParams();
+    for (const [k, v] of Object.entries(p))
+        if (v !== undefined && v !== "")
+            s.append(k, String(v));
+    return s.size ? "?" + s.toString() : "";
+}
+async function request(method, path, opts = {}) {
+    const query = opts.params ? buildQuery(opts.params) : "";
+    const fullPath = path + query;
+    const bodyStr = opts.body ? JSON.stringify(opts.body) : "";
+    const headers = { "Content-Type": "application/json", "Accept": "application/json" };
+    if (opts.auth) {
+        const t = ts();
+        const sign = crypto.createHmac("sha256", opts.auth.secret).update(t + method + fullPath + bodyStr).digest("base64");
+        headers["OK-ACCESS-KEY"] = opts.auth.apiKey;
+        headers["OK-ACCESS-SIGN"] = sign;
+        headers["OK-ACCESS-TIMESTAMP"] = t;
+        headers["OK-ACCESS-PASSPHRASE"] = opts.auth.passphrase;
+    }
+    const res = await fetch(BASE + fullPath, { method, headers, ...(bodyStr ? { body: bodyStr } : {}) });
+    if (!res.ok) {
+        const t = await res.text().catch(() => "");
+        throw new Error(`HTTP ${res.status}: ${t}`);
+    }
+    const json = await res.json();
+    if (json.code && json.code !== "0")
+        throw new Error(`OKX ${json.code}: ${json.msg ?? ""}`);
+    return (json.data ?? json);
+}
+// ═══════════════════════════════════════════════════════════════
+// 按官方文档逐模块添加
+// ═══════════════════════════════════════════════════════════════
+// ── Balance API v6 ─────────────────────────────────────────────
+export const balanceApi = {
+    /** GET /api/v6/dex/balance/supported/chain — 返回 name/logoUrl/shortName/chainIndex */
+    supportedChain: (auth) => request("GET", "/api/v6/dex/balance/supported/chain", { auth }),
+    /** GET /api/v6/dex/balance/total-value-by-address?address=&chains=&assetType=&excludeRiskToken= */
+    totalValue: (auth, address, chains, assetType, excludeRiskToken) => request("GET", "/api/v6/dex/balance/total-value-by-address", {
+        params: { address, chains, assetType, excludeRiskToken },
+        auth,
+    }),
+    /** GET /api/v6/dex/balance/all-token-balances-by-address?address=&chains=&excludeRiskToken= */
+    allTokenBalances: (auth, address, chains, excludeRiskToken) => request("GET", "/api/v6/dex/balance/all-token-balances-by-address", {
+        params: { address, chains, excludeRiskToken },
+        auth,
+    }),
+    /** POST /api/v6/dex/balance/token-balances-by-address — body: { address, tokenContractAddresses: [{chainIndex, tokenContractAddress}], excludeRiskToken? } */
+    specificTokenBalance: (auth, address, tokenContractAddresses, excludeRiskToken) => request("POST", "/api/v6/dex/balance/token-balances-by-address", {
+        body: { address, tokenContractAddresses, ...(excludeRiskToken !== undefined ? { excludeRiskToken } : {}) },
+        auth,
+    }),
+};
+// ── Gateway API v6 (交易上链) ──────────────────────────────────
+export const gatewayApi = {
+    /** GET /api/v6/dex/pre-transaction/supported/chain */
+    supportedChain: (auth) => request("GET", "/api/v6/dex/pre-transaction/supported/chain", { auth }),
+    /** GET /api/v6/dex/pre-transaction/gas-price?chainIndex= */
+    gasPrice: (auth, chainIndex) => request("GET", "/api/v6/dex/pre-transaction/gas-price", { params: { chainIndex }, auth }),
+    /** POST /api/v6/dex/pre-transaction/gas-limit */
+    gasLimit: (auth, body) => request("POST", "/api/v6/dex/pre-transaction/gas-limit", { body, auth }),
+    /** POST /api/v6/dex/pre-transaction/simulate — 模拟执行, 返回 intention/assetChange/gasUsed/failReason/risks */
+    simulate: (auth, body) => request("POST", "/api/v6/dex/pre-transaction/simulate", { body, auth }),
+    /** POST /api/v6/dex/pre-transaction/broadcast-transaction — 返回 orderId/txHash */
+    broadcast: (auth, body) => request("POST", "/api/v6/dex/pre-transaction/broadcast-transaction", { body, auth }),
+};
+// ── Post-transaction API v6 ───────────────────────────────────
+export const postTxApi = {
+    /** GET /api/v6/dex/post-transaction/orders — 广播订单列表 */
+    orders: (auth, address, chainIndex, txStatus, orderId, cursor, limit) => request("GET", "/api/v6/dex/post-transaction/orders", {
+        params: { address, chainIndex, txStatus, orderId, cursor, limit },
+        auth,
+    }),
+    /** GET /api/v6/dex/post-transaction/supported/chain — 交易历史支持的链 */
+    supportedChain: (auth) => request("GET", "/api/v6/dex/post-transaction/supported/chain", { auth }),
+    /** GET /api/v6/dex/post-transaction/transactions-by-address?address=&chains=&tokenContractAddress=&begin=&end=&cursor=&limit= */
+    transactions: (auth, address, chains, tokenContractAddress, begin, end, cursor, limit) => request("GET", "/api/v6/dex/post-transaction/transactions-by-address", {
+        params: { address, chains, tokenContractAddress, begin, end, cursor, limit },
+        auth,
+    }),
+    /** GET /api/v6/dex/post-transaction/transaction-detail-by-txhash?chainIndex=&txHash=&itype= */
+    transactionDetail: (auth, chainIndex, txHash, itype) => request("GET", "/api/v6/dex/post-transaction/transaction-detail-by-txhash", {
+        params: { chainIndex, txHash, itype },
+        auth,
+    }),
+};
+// ── DeFi API v6 ──────────────────────────────────────────────
+export const defiApi = {
+    /** GET /api/v6/defi/product/supported-chains — 返回 chainIndex(String)+network */
+    supportedChains: (auth) => request("GET", "/api/v6/defi/product/supported-chains", { auth }),
+    /** GET /api/v6/defi/product/supported-platforms — 返回 analysisPlatformId+platformName+investmentCount */
+    supportedPlatforms: (auth) => request("GET", "/api/v6/defi/product/supported-platforms", { auth }),
+    /** POST /api/v6/defi/product/search — body: { tokenKeywordList, platformKeywordList?, pageNum?, chainIndex?, productGroup? } */
+    searchProducts: (auth, body) => request("POST", "/api/v6/defi/product/search", { body, auth }),
+    /** GET /api/v6/defi/product/detail?investmentId= */
+    productDetail: (auth, investmentId) => request("GET", "/api/v6/defi/product/detail", { params: { investmentId }, auth }),
+    /** GET /api/v6/defi/product/rate/chart?investmentId=&timeRange= — APY 折线图 */
+    rateChart: (auth, investmentId, timeRange) => request("GET", "/api/v6/defi/product/rate/chart", { params: { investmentId, timeRange }, auth }),
+    /** GET /api/v6/defi/product/tvl/chart?investmentId=&timeRange= — TVL 折线图 */
+    tvlChart: (auth, investmentId, timeRange) => request("GET", "/api/v6/defi/product/tvl/chart", { params: { investmentId, timeRange }, auth }),
+    /** GET /api/v6/defi/product/depth-price/chart?investmentId=&chartType=&timeRange= — V3 深度/价格图 */
+    depthPriceChart: (auth, investmentId, chartType, timeRange) => request("GET", "/api/v6/defi/product/depth-price/chart", { params: { investmentId, chartType, timeRange }, auth }),
+    /** POST /api/v6/defi/product/detail/prepare — 交易前准备, 返回 investWithTokenList/receiveTokenInfo */
+    prepareTransaction: (auth, investmentId) => request("POST", "/api/v6/defi/product/detail/prepare", { body: { investmentId }, auth }),
+    /** POST /api/v6/defi/calculator/enter/info — V3 Pool 双币分配计算 */
+    calcEnterInfo: (auth, body) => request("POST", "/api/v6/defi/calculator/enter/info", { body, auth }),
+    /** POST /api/v6/defi/transaction/enter — 申购/存款/借款, 返回 dataList(APPROVE→DEPOSIT) */
+    enter: (auth, body) => request("POST", "/api/v6/defi/transaction/enter", { body, auth }),
+    /** POST /api/v6/defi/transaction/exit — 赎回/还款, 返回 dataList */
+    exit: (auth, body) => request("POST", "/api/v6/defi/transaction/exit", { body, auth }),
+    /** POST /api/v6/defi/transaction/claim — 领取奖励, 返回 dataList */
+    claim: (auth, body) => request("POST", "/api/v6/defi/transaction/claim", { body, auth }),
+    /** POST /api/v6/defi/user/asset/platform/list — 用户持仓概览(协议维度) */
+    userPlatformList: (auth, body) => request("POST", "/api/v6/defi/user/asset/platform/list", { body, auth }),
+    /** POST /api/v6/defi/user/asset/platform/detail — 用户持仓明细(投资品维度) */
+    userPlatformDetail: (auth, body) => request("POST", "/api/v6/defi/user/asset/platform/detail", { body, auth }),
+};
+// ── Payments API (Agent Payments Protocol) ──────────────────
+// 路径来源: API 参考 (HTTP端 + Agent端)
+export const paymentsApi = {
+    // ── Agent 端 A2A (单次支付) ────────────────────────────
+    /** POST /api/v6/pay/a2a/payment/create — Seller 创建付款, 返回 paymentId+challenge+付款链接 */
+    create: (auth, body) => request("POST", "/api/v6/pay/a2a/payment/create", { body, auth }),
+    /** GET /api/v6/pay/a2a/p/{paymentId} — Buyer 拉取付款详情, PUBLIC */
+    detail: (paymentId) => request("GET", `/api/v6/pay/a2a/p/${paymentId}`),
+    /** POST /api/v6/pay/a2a/p/{paymentId}/credential — Buyer 提交 EIP-3009 签名凭证, PUBLIC */
+    submit: (paymentId, body) => request("POST", `/api/v6/pay/a2a/p/${paymentId}/credential`, { body }),
+    /** GET /api/v6/pay/a2a/p/{paymentId}/status — 查询支付状态, PUBLIC */
+    status: (paymentId) => request("GET", `/api/v6/pay/a2a/p/${paymentId}/status`),
+    // ── HTTP 端 x402 (单次/批量) ──────────────────────────
+    /** GET /api/v6/pay/x402/supported — 支持的网络/代币/scheme */
+    supported: (auth) => request("GET", "/api/v6/pay/x402/supported", { auth }),
+    /** POST /api/v6/pay/x402/verify — 验签 */
+    verify: (auth, body) => request("POST", "/api/v6/pay/x402/verify", { body, auth }),
+    /** POST /api/v6/pay/x402/settle — 上链结算 */
+    settle: (auth, body) => request("POST", "/api/v6/pay/x402/settle", { body, auth }),
+    /** GET /api/v6/pay/x402/settle/status?txHash= — 轮询结算状态 */
+    settleStatus: (auth, txHash) => request("GET", "/api/v6/pay/x402/settle/status", { params: { txHash }, auth }),
+};
+// ── Trade / DEX API v6 (经典兑换) ────────────────────────────
+// 来源: Solana/EVM/Sui/Ton 搭建指南 + API 参考
+export const tradeApi = {
+    /** GET /api/v6/dex/aggregator/supported/chain?chainIndex= — 返回 chainIndex/chainName/dexTokenApproveAddress */
+    supportedChain: (auth, chainIndex) => request("GET", "/api/v6/dex/aggregator/supported/chain", { params: { chainIndex }, auth }),
+    allTokens: (auth, chainIndex) => request("GET", "/api/v6/dex/aggregator/all-tokens", { params: { chainIndex }, auth }),
+    liquidity: (auth, chainIndex) => request("GET", "/api/v6/dex/aggregator/get-liquidity", { params: { chainIndex }, auth }),
+    approveTransaction: (auth, chainIndex, tokenContractAddress, approveAmount) => request("GET", "/api/v6/dex/aggregator/approve-transaction", { params: { chainIndex, tokenContractAddress, approveAmount }, auth }),
+    quote: (auth, params) => request("GET", "/api/v6/dex/aggregator/quote", { params, auth }),
+    swap: (auth, params) => request("GET", "/api/v6/dex/aggregator/swap", { params, auth }),
+    swapInstruction: (auth, params) => request("GET", "/api/v6/dex/aggregator/swap-instruction", { params, auth }),
+    swapHistory: (auth, chainIndex, txHash, isFromMyProject) => request("GET", "/api/v6/dex/aggregator/history", { params: { chainIndex, txHash, isFromMyProject }, auth }),
+};
+// ── Intent Swap API v6 ──────────────────────────────────────
+export const intentApi = {
+    /** POST /api/v6/dex/aggregator/intent/create-order — 创建意图订单, 返回 orderUid */
+    createOrder: (auth, body) => request("POST", "/api/v6/dex/aggregator/intent/create-order", { body, auth }),
+    /** GET /api/v6/dex/aggregator/intent/order-list?userWalletAddress=&orderUid=&cursor=&limit= — 订单列表 */
+    orderList: (auth, params) => request("GET", "/api/v6/dex/aggregator/intent/order-list", { params, auth }),
+    /** GET /api/v6/dex/aggregator/intent/order-status?orderUid= — 查订单状态 */
+    orderStatus: (auth, orderUid) => request("GET", "/api/v6/dex/aggregator/intent/order-status", { params: { orderUid }, auth }),
+    /** POST /api/v6/dex/aggregator/intent/cancel-signdata — 获取取消签名数据 */
+    cancelSignData: (auth, userWalletAddress, orderUid) => request("POST", "/api/v6/dex/aggregator/intent/cancel-signdata", { body: { userWalletAddress, orderUid }, auth }),
+    /** POST /api/v6/dex/aggregator/intent/cancel-order — 取消订单 */
+    cancelOrder: (auth, userWalletAddress, orderUid, signature) => request("POST", "/api/v6/dex/aggregator/intent/cancel-order", { body: { userWalletAddress, orderUid, signature }, auth }),
+    /** GET /api/v6/dex/aggregator/intent/auction-info?auctionId=&txHash= — 查拍卖结果 */
+    auctionInfo: (auth, params) => request("GET", "/api/v6/dex/aggregator/intent/auction-info", { params, auth }),
+};
+// ── Market API v6 (行情 — x402 付费) ──────────────────────
+export const marketApi = {
+    /** GET /api/v6/dex/market/supported/chain?chainIndex= */
+    supportedChain: (auth, chainIndex) => request("GET", "/api/v6/dex/market/supported/chain", { params: { chainIndex }, auth }),
+    /** POST /api/v6/dex/market/price — body: [{chainIndex, tokenContractAddress}] */
+    price: (auth, body) => request("POST", "/api/v6/dex/market/price", { body, auth }),
+    /** GET /api/v6/dex/market/candles?chainIndex=&tokenContractAddress=&bar=&after=&before=&limit= */
+    candles: (auth, params) => request("GET", "/api/v6/dex/market/candles", { params, auth }),
+    /** GET /api/v6/dex/market/historical-candles?chainIndex=&tokenContractAddress=&bar=&after=&before=&limit= */
+    historicalCandles: (auth, params) => request("GET", "/api/v6/dex/market/historical-candles", { params, auth }),
+    // ── 综合币价 ──────────────────────────────────────
+    /** POST /api/v6/dex/index/current-price — body: [{chainIndex, tokenContractAddress}] */
+    indexCurrentPrice: (auth, body) => request("POST", "/api/v6/dex/index/current-price", { body, auth }),
+    /** GET /api/v6/dex/index/historical-price?chainIndex=&tokenContractAddress=&limit=&cursor=&begin=&end=&period= */
+    indexHistoricalPrice: (auth, params) => request("GET", "/api/v6/dex/index/historical-price", { params, auth }),
+    // ── 代币 API ──────────────────────────────────────
+    /** GET /api/v6/dex/market/token/search?chains=&search=&cursor=&limit= — 搜索代币 */
+    searchToken: (auth, chains, search, cursor, limit) => request("GET", "/api/v6/dex/market/token/search", { params: { chains, search, cursor, limit }, auth }),
+    /** POST /api/v6/dex/market/token/basic-info — body: [{chainIndex, tokenContractAddress}] */
+    tokenBasicInfo: (auth, body) => request("POST", "/api/v6/dex/market/token/basic-info", { body, auth }),
+    /** GET /api/v6/dex/market/token/top-liquidity?chainIndex=&tokenContractAddress= — 流动性池 */
+    tokenTopLiquidity: (auth, chainIndex, tokenContractAddress) => request("GET", "/api/v6/dex/market/token/top-liquidity", { params: { chainIndex, tokenContractAddress }, auth }),
+    /** POST /api/v6/dex/market/price-info — 批量交易信息, body: [{chainIndex, tokenContractAddress}], max 100 */
+    priceInfo: (auth, body) => request("POST", "/api/v6/dex/market/price-info", { body, auth }),
+    /** GET /api/v6/dex/market/token/advanced-info?chainIndex=&tokenContractAddress= — 代币安全分析(貔貅/开发者/狙击手) */
+    tokenAdvancedInfo: (auth, chainIndex, tokenContractAddress) => request("GET", "/api/v6/dex/market/token/advanced-info", { params: { chainIndex, tokenContractAddress }, auth }),
+    /** GET /api/v6/dex/market/token/hot-token?rankingType=&chainIndex=&rankBy=... — 热门代币(最多100) */
+    tokenHot: (auth, params) => request("GET", "/api/v6/dex/market/token/hot-token", { params, auth }),
+    /** GET /api/v6/dex/market/token/holder?chainIndex=&tokenContractAddress=&tagFilter=&cursor=&limit= — 前100持有人 */
+    tokenHolder: (auth, params) => request("GET", "/api/v6/dex/market/token/holder", { params, auth }),
+    /** GET /api/v6/dex/market/token/cluster/supported/chain — 聚类支持链 */
+    tokenClusterSupportedChain: (auth) => request("GET", "/api/v6/dex/market/token/cluster/supported/chain", { auth }),
+    /** GET /api/v6/dex/market/token/cluster/overview?chainIndex=&tokenContractAddress= — 持仓集中度 */
+    tokenClusterOverview: (auth, chainIndex, tokenContractAddress) => request("GET", "/api/v6/dex/market/token/cluster/overview", { params: { chainIndex, tokenContractAddress }, auth }),
+    /** GET /api/v6/dex/market/token/cluster/list?chainIndex=&tokenContractAddress= — 聚类列表(top100集群) */
+    tokenClusterList: (auth, chainIndex, tokenContractAddress) => request("GET", "/api/v6/dex/market/token/cluster/list", { params: { chainIndex, tokenContractAddress }, auth }),
+    /** GET /api/v6/dex/market/token/cluster/top-holders?chainIndex=&tokenContractAddress=&rangeFilter= — 前10/50/100持仓 */
+    tokenClusterTopHolders: (auth, chainIndex, tokenContractAddress, rangeFilter) => request("GET", "/api/v6/dex/market/token/cluster/top-holders", { params: { chainIndex, tokenContractAddress, rangeFilter }, auth }),
+    /** GET /api/v6/dex/market/token/top-trader?chainIndex=&tokenContractAddress=&tagFilter=&cursor=&limit= — 前100盈利地址 */
+    tokenTopTrader: (auth, params) => request("GET", "/api/v6/dex/market/token/top-trader", { params, auth }),
+    // ── 信号 API ──────────────────────────────────────
+    /** GET /api/v6/dex/market/signal/supported/chain — 信号支持链 */
+    signalSupportedChain: (auth) => request("GET", "/api/v6/dex/market/signal/supported/chain", { auth }),
+    /** POST /api/v6/dex/market/signal/list — 获取信号 */
+    signalList: (auth, body) => request("POST", "/api/v6/dex/market/signal/list", { body, auth }),
+    /** GET /api/v6/dex/market/leaderboard/supported/chain — 聪明钱榜单支持链 */
+    leaderboardSupportedChain: (auth) => request("GET", "/api/v6/dex/market/leaderboard/supported/chain", { auth }),
+    /** GET /api/v6/dex/market/leaderboard/list?chainIndex=&timeFrame=&sortBy=&walletType=... — 聪明钱榜单 */
+    leaderboardList: (auth, params) => request("GET", "/api/v6/dex/market/leaderboard/list", { params, auth }),
+    // ── Memepump / 扫链 ──────────────────────────────────
+    /** GET /api/v6/dex/market/memepump/supported/chainsProtocol — 支持的链+协议 */
+    memepumpSupported: (auth) => request("GET", "/api/v6/dex/market/memepump/supported/chainsProtocol", { auth }),
+    /** GET /api/v6/dex/market/memepump/tokenList?chainIndex=&stage=&... — 代币列表(最多30) */
+    memepumpTokenList: (auth, params) => request("GET", "/api/v6/dex/market/memepump/tokenList", { params, auth }),
+    /** GET /api/v6/dex/market/memepump/tokenDetails?chainIndex=&tokenContractAddress=&walletAddress= */
+    memepumpTokenDetails: (auth, chainIndex, tokenContractAddress, walletAddress) => request("GET", "/api/v6/dex/market/memepump/tokenDetails", { params: { chainIndex, tokenContractAddress, walletAddress }, auth }),
+    /** GET /api/v6/dex/market/memepump/tokenDevInfo?chainIndex=&tokenContractAddress= */
+    memepumpTokenDevInfo: (auth, chainIndex, tokenContractAddress) => request("GET", "/api/v6/dex/market/memepump/tokenDevInfo", { params: { chainIndex, tokenContractAddress }, auth }),
+    /** GET /api/v6/dex/market/memepump/similarToken?chainIndex=&tokenContractAddress= */
+    memepumpSimilarToken: (auth, chainIndex, tokenContractAddress) => request("GET", "/api/v6/dex/market/memepump/similarToken", { params: { chainIndex, tokenContractAddress }, auth }),
+    /** GET /api/v6/dex/market/memepump/tokenBundleInfo?chainIndex=&tokenContractAddress= */
+    memepumpBundleInfo: (auth, chainIndex, tokenContractAddress) => request("GET", "/api/v6/dex/market/memepump/tokenBundleInfo", { params: { chainIndex, tokenContractAddress }, auth }),
+    /** GET /api/v6/dex/market/memepump/apedWallet?chainIndex=&tokenContractAddress=&walletAddress= */
+    memepumpApedWallet: (auth, chainIndex, tokenContractAddress, walletAddress) => request("GET", "/api/v6/dex/market/memepump/apedWallet", { params: { chainIndex, tokenContractAddress, walletAddress }, auth }),
+    // ── Portfolio / 地址分析 ─────────────────────────────
+    /** GET /api/v6/dex/market/portfolio/supported/chain */
+    portfolioSupportedChain: (auth) => request("GET", "/api/v6/dex/market/portfolio/supported/chain", { auth }),
+    /** GET /api/v6/dex/market/portfolio/overview?chainIndex=&walletAddress=&timeFrame= */
+    portfolioOverview: (auth, chainIndex, walletAddress, timeFrame) => request("GET", "/api/v6/dex/market/portfolio/overview", { params: { chainIndex, walletAddress, timeFrame }, auth }),
+    /** GET /api/v6/dex/market/portfolio/recent-pnl?chainIndex=&walletAddress=&cursor=&limit= */
+    portfolioRecentPnl: (auth, params) => request("GET", "/api/v6/dex/market/portfolio/recent-pnl", { params, auth }),
+    /** GET /api/v6/dex/market/portfolio/token/latest-pnl?chainIndex=&walletAddress=&tokenContractAddress= */
+    portfolioTokenLatestPnl: (auth, chainIndex, walletAddress, tokenContractAddress) => request("GET", "/api/v6/dex/market/portfolio/token/latest-pnl", { params: { chainIndex, walletAddress, tokenContractAddress }, auth }),
+    /** GET /api/v6/dex/market/portfolio/dex-history?chainIndex=&walletAddress=&begin=&end=&... */
+    portfolioDexHistory: (auth, params) => request("GET", "/api/v6/dex/market/portfolio/dex-history", { params, auth }),
+    /** GET /api/v6/dex/market/address-tracker/trades?trackerType=&walletAddress=&tradeType=... */
+    addressTrackerTrades: (auth, params) => request("GET", "/api/v6/dex/market/address-tracker/trades", { params, auth }),
+    // ── Social / 社媒 ──────────────────────────────────
+    /** GET /api/v6/dex/market/social/news/latest */
+    socialNewsLatest: (auth, params) => request("GET", "/api/v6/dex/market/social/news/latest", { params, auth }),
+    /** GET /api/v6/dex/market/social/news/by-symbol */
+    socialNewsBySymbol: (auth, params) => request("GET", "/api/v6/dex/market/social/news/by-symbol", { params, auth }),
+    /** GET /api/v6/dex/market/social/news/search */
+    socialNewsSearch: (auth, params) => request("GET", "/api/v6/dex/market/social/news/search", { params, auth }),
+    /** GET /api/v6/dex/market/social/news/detail?articleId= */
+    socialNewsDetail: (auth, articleId, language) => request("GET", "/api/v6/dex/market/social/news/detail", { params: { articleId, language }, auth }),
+    /** GET /api/v6/dex/market/social/news/platforms */
+    socialNewsPlatforms: (auth) => request("GET", "/api/v6/dex/market/social/news/platforms", { auth }),
+    /** GET /api/v6/dex/market/social/sentiment/symbol?tokenSymbols=&timeFrame=&trendPoints= */
+    socialSentimentSymbol: (auth, params) => request("GET", "/api/v6/dex/market/social/sentiment/symbol", { params, auth }),
+    /** GET /api/v6/dex/market/social/sentiment/ranking?timeFrame=&sortBy=&limit= */
+    socialSentimentRanking: (auth, params) => request("GET", "/api/v6/dex/market/social/sentiment/ranking", { params, auth }),
+    /** GET /api/v6/dex/market/social/vibe/timeline?chainIndex=&tokenAddress=&timeFrame= */
+    socialVibeTimeline: (auth, params) => request("GET", "/api/v6/dex/market/social/vibe/timeline", { params, auth }),
+    /** GET /api/v6/dex/market/social/vibe/top-kols?chainIndex=&tokenAddress=&sortBy=&timeFrame=&limit= */
+    socialVibeTopKols: (auth, params) => request("GET", "/api/v6/dex/market/social/vibe/top-kols", { params, auth }),
+    /** GET /api/v6/dex/market/trades?chainIndex=&tokenContractAddress=&after=&limit=&tagFilter=&walletAddressFilter= */
+    trades: (auth, params) => request("GET", "/api/v6/dex/market/trades", { params, auth }),
+};
+//# sourceMappingURL=onchainos.js.map

package/dist/adapters/shared.d.ts

@@ -0,0 +1,23 @@
+/**
+ * h-mcp — 共享工具层
+ * 规范: OnchainOS-API对接规范.md §四/§六 + AGENT-MCP-RULES.md §4/§8
+ */
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+export interface Auth {
+    apiKey: string;
+    secret: string;
+    passphrase: string;
+}
+export interface NextStep {
+    action: string;
+    tool: string;
+    params?: Record<string, unknown>;
+    condition?: string;
+}
+export declare function toResult<T>(data: T, opts?: {
+    warnings?: string[];
+    nextSteps?: NextStep[];
+}): CallToolResult;
+export declare function toError(e: unknown): CallToolResult;
+export declare function AUTH_REQUIRED(scope?: "READ" | "TRADE"): CallToolResult;
+//# sourceMappingURL=shared.d.ts.map

package/dist/adapters/shared.js

@@ -0,0 +1,107 @@
+// ── toResult ────────────────────────────────────────────────
+export function toResult(data, opts) {
+    const body = { success: true, data, tsIso: new Date().toISOString() };
+    if (opts?.warnings?.length)
+        body.warnings = opts.warnings;
+    if (opts?.nextSteps?.length)
+        body.nextSteps = opts.nextSteps;
+    return { content: [{ type: "text", text: JSON.stringify(body) }] };
+}
+// ── toError ─────────────────────────────────────────────────
+export function toError(e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    let error;
+    // OKX 业务错误码 (HTTP 200, code != "0")
+    if (msg.includes("OKX 50001")) {
+        error = { code: "SERVICE_UNAVAILABLE", message: msg, fix: "服务暂不可用, 等待几秒后重试", retryAfter: 3000 };
+    }
+    else if (msg.includes("OKX 50011")) {
+        error = { code: "RATE_LIMITED", message: msg, fix: "超出频率限制, 请降低请求频率", retryAfter: 5000 };
+    }
+    else if (msg.includes("OKX 50103") || msg.includes("OKX 50104") || msg.includes("OKX 50105") || msg.includes("OKX 50106") || msg.includes("OKX 50107") || msg.includes("OKX 50111") || msg.includes("OKX 50112") || msg.includes("OKX 50113")) {
+        error = { code: "AUTH_ERROR", message: msg, fix: "API Key 签名错误, 请检查 OKX_API_KEY/OKX_SECRET_KEY/OKX_PASSPHRASE" };
+    }
+    else if (msg.includes("OKX 81001")) {
+        error = { code: "BAD_PARAMETER", message: msg, fix: "参数不正确, 请检查参数名/类型/必填项" };
+    }
+    else if (msg.includes("OKX 81108")) {
+        error = { code: "WALLET_TYPE_MISMATCH", message: msg, fix: "钱包类型不匹配, 请确认链和地址格式一致" };
+    }
+    else if (msg.includes("OKX 81104")) {
+        error = { code: "CHAIN_NOT_SUPPORT", message: msg, fix: "该链不支持此操作, 请调用 supported_chain 确认可用链" };
+    }
+    else if (msg.includes("OKX 81152")) {
+        error = { code: "COIN_NOT_EXIST", message: msg, fix: "代币不存在, 请用 onchainos_token_search 搜索正确地址" };
+    }
+    else if (msg.includes("OKX 81451")) {
+        error = { code: "NODE_FAILED", message: msg, fix: "节点返回失败, 请稍后重试", retryAfter: 2000 };
+    }
+    else if (msg.includes("OKX 84001") || msg.includes("OKX 84003")) {
+        error = { code: "PROTOCOL_NOT_SUPPORT", message: msg, fix: "协议不支持, 请用 onchainos_defi_supported_platforms 确认支持列表" };
+    }
+    else if (msg.includes("OKX 84007") || msg.includes("OKX 84024")) {
+        error = { code: "PRODUCT_NOT_SUPPORT", message: msg, fix: "投资品不支持或不存在, 请用 onchainos_defi_search_products 重新搜索" };
+    }
+    else if (msg.includes("OKX 84010")) {
+        error = { code: "TOKEN_NOT_SUPPORT", message: msg, fix: "代币不支持, 请确认 tokenAddress 正确" };
+    }
+    else if (msg.includes("OKX 84014")) {
+        error = { code: "BALANCE_FAILED", message: msg, fix: "余额验证失败, 请确认钱包余额充足" };
+    }
+    else if (msg.includes("OKX 84016")) {
+        error = { code: "CONTRACT_FAILED", message: msg, fix: "智能合约执行失败, 请检查参数和链上状态" };
+    }
+    else if (msg.includes("OKX 84019")) {
+        error = { code: "ADDRESS_MISMATCH", message: msg, fix: "地址格式不匹配, 请用 onchainos_wallet_validate_address 校验" };
+    }
+    else if (msg.includes("OKX 84021")) {
+        error = { code: "SYNCING", message: msg, fix: "资产正在同步中, 请等待片刻后重试", retryAfter: 3000 };
+    }
+    else if (msg.includes("OKX 84025")) {
+        error = { code: "NO_REWARD", message: msg, fix: "当前无可领取的奖励" };
+    }
+    else if (msg.includes("OKX 84029")) {
+        error = { code: "LOCKED", message: msg, fix: "本金仍在锁定期, 无法领取" };
+    }
+    else if (msg.includes("OKX 84030")) {
+        error = { code: "EXPIRED", message: msg, fix: "本金领取已过期" };
+    }
+    else if (msg.includes("OKX 84032")) {
+        error = { code: "V3_ONLY", message: msg, fix: "此接口仅适用于 V3 DEX Pool 投资品" };
+    }
+    // HTTP 传输层错误
+    else if (msg.includes("429") || msg.includes("RATE")) {
+        error = { code: "RATE_LIMITED", message: msg, fix: "请等待 1-2 秒后重试", retryAfter: 1000 };
+    }
+    else if (msg.includes("503")) {
+        error = { code: "UNAVAILABLE", message: msg, fix: "服务暂时不可用，请等待 5 秒后重试", retryAfter: 5000 };
+    }
+    else if (msg.includes("400")) {
+        error = { code: "BAD_REQUEST", message: msg, fix: "请检查参数格式和必填字段" };
+    }
+    else if (msg.includes("422")) {
+        error = { code: "BUSINESS_REJECT", message: msg, fix: "参数合法但业务不可行，请检查余额/授权等条件" };
+    }
+    else if (msg.includes("500")) {
+        error = { code: "SYSTEM_ERROR", message: msg, fix: "系统错误，不建议重试" };
+    }
+    else {
+        error = { code: "ERROR", message: msg, fix: "请检查网络和 API 配置" };
+    }
+    return {
+        content: [{ type: "text", text: JSON.stringify({ success: false, error, tsIso: new Date().toISOString() }) }],
+        isError: true,
+    };
+}
+// ── AUTH_REQUIRED ───────────────────────────────────────────
+export function AUTH_REQUIRED(scope = "READ") {
+    return {
+        content: [{ type: "text", text: JSON.stringify({
+                    success: false,
+                    error: { code: "AUTH_REQUIRED", message: `需要 OKX API Key（${scope} 权限）`, fix: "请设置环境变量 OKX_API_KEY / OKX_SECRET_KEY / OKX_PASSPHRASE" },
+                    tsIso: new Date().toISOString(),
+                }) }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=shared.js.map

package/dist/http.d.ts

@@ -0,0 +1,9 @@
+/**
+ * h-mcp Server — HTTP 传输层
+ * 规范: AGENT-MCP-RULES.md §12 (传输层透明 + 无状态)
+ * 使用 StreamableHTTPServerTransport (SDK 推荐), 废弃的 SSE transport 已跳过
+ *
+ * 使用原生 node:http 而非 Express, 避免 Express 5 与 @hono/node-server 兼容问题
+ */
+import "dotenv/config";
+//# sourceMappingURL=http.d.ts.map

package/dist/http.js

@@ -0,0 +1,124 @@
+/**
+ * h-mcp Server — HTTP 传输层
+ * 规范: AGENT-MCP-RULES.md §12 (传输层透明 + 无状态)
+ * 使用 StreamableHTTPServerTransport (SDK 推荐), 废弃的 SSE transport 已跳过
+ *
+ * 使用原生 node:http 而非 Express, 避免 Express 5 与 @hono/node-server 兼容问题
+ */
+import "dotenv/config";
+import { createServer } from "node:http";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { registerBalanceTools } from "./tools/balance.js";
+import { registerGatewayTools } from "./tools/gateway.js";
+import { registerTxHistoryTools } from "./tools/txhistory.js";
+import { registerDefiTools } from "./tools/defi.js";
+import { registerPaymentsTools } from "./tools/payments.js";
+import { registerTradeTools } from "./tools/trade.js";
+import { registerIntentTools } from "./tools/intent.js";
+import { registerMarketTools } from "./tools/market.js";
+import { registerWsTools } from "./tools/ws.js";
+import { registerSkillTools } from "./tools/skills.js";
+function resolveAuth() {
+    const k = process.env.OKX_API_KEY, s = process.env.OKX_SECRET_KEY, p = process.env.OKX_PASSPHRASE;
+    if (k && s && p)
+        return { apiKey: k, secret: s, passphrase: p };
+    const a = process.argv.slice(2), g = (f) => { const i = a.indexOf(f); return i >= 0 ? a[i + 1] : undefined; };
+    const ka = g("--okx-api-key") ?? g("-k"), sa = g("--okx-secret") ?? g("-s"), pa = g("--okx-passphrase") ?? g("-p");
+    if (ka && sa && pa)
+        return { apiKey: ka, secret: sa, passphrase: pa };
+    return null;
+}
+/** 简陋 body parser — 读 JSON body 到 req.body */
+function jsonBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", c => chunks.push(c));
+        req.on("end", () => {
+            const raw = Buffer.concat(chunks).toString();
+            try {
+                resolve(raw ? JSON.parse(raw) : undefined);
+            }
+            catch {
+                reject(new Error("Invalid JSON body"));
+            }
+        });
+        req.on("error", reject);
+    });
+}
+async function main() {
+    const auth = resolveAuth();
+    if (!auth) {
+        console.error("[h-mcp] 未配置 API Key。设置 OKX_API_KEY / OKX_SECRET_KEY / OKX_PASSPHRASE");
+        console.error("[h-mcp] 获取: https://web3.okx.com/onchainos/dev-portal");
+    }
+    else {
+        console.error("[h-mcp] Auth 已配置");
+    }
+    const host = process.env.HOST ?? "127.0.0.1";
+    const port = parseInt(process.env.PORT ?? "3000", 10);
+    // 1. 创建 HTTP transport (有状态模式, 自动生成 sessionId)
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: () => crypto.randomUUID(),
+    });
+    // 2. MCP Server + 全部工具注册
+    const server = new McpServer({ name: "hchain-mcp", version: "1.0.0" });
+    registerBalanceTools(server, auth);
+    registerGatewayTools(server, auth);
+    registerTxHistoryTools(server, auth);
+    registerDefiTools(server, auth);
+    registerPaymentsTools(server, auth);
+    registerTradeTools(server, auth);
+    registerIntentTools(server, auth);
+    registerMarketTools(server, auth);
+    registerWsTools(server, auth);
+    registerSkillTools(server, auth);
+    // 3. 连接 server 到 HTTP transport
+    await server.connect(transport);
+    // 4. 原生 HTTP server
+    const httpServer = createServer(async (req, res) => {
+        // CORS
+        res.setHeader("Access-Control-Allow-Origin", "*");
+        res.setHeader("Access-Control-Allow-Methods", "GET, POST, DELETE, OPTIONS");
+        res.setHeader("Access-Control-Allow-Headers", "Content-Type, Accept, MCP-Protocol-Version");
+        if (req.method === "OPTIONS") {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        // 健康检查
+        if (req.method === "GET" && req.url === "/health") {
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ status: "ok", tsIso: new Date().toISOString() }));
+            return;
+        }
+        // MCP 端点
+        if (req.url === "/mcp" || req.url?.startsWith("/mcp")) {
+            try {
+                let body;
+                if (req.method === "POST") {
+                    body = await jsonBody(req);
+                }
+                await transport.handleRequest(req, res, body);
+            }
+            catch (e) {
+                console.error("[h-mcp] handleRequest error:", e);
+                if (!res.headersSent) {
+                    res.writeHead(500, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify({ error: "Internal server error" }));
+                }
+            }
+            return;
+        }
+        // 404
+        res.writeHead(404, { "Content-Type": "application/json" });
+        res.end(JSON.stringify({ error: "Not found" }));
+    });
+    httpServer.listen(port, host, () => {
+        console.error(`[h-mcp] HTTP MCP Server 已启动 → http://${host}:${port}`);
+        console.error(`[h-mcp] MCP endpoint: POST http://${host}:${port}/mcp`);
+        console.error(`[h-mcp] Health check: GET  http://${host}:${port}/health`);
+    });
+}
+main().catch(e => { console.error("[h-mcp] 启动失败:", e); process.exit(1); });
+//# sourceMappingURL=http.js.map

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * h-mcp Server — stdio 传输
+ * 规范: OnchainOS-API对接规范.md §五
+ */
+import "dotenv/config";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,54 @@
+/**
+ * h-mcp Server — stdio 传输
+ * 规范: OnchainOS-API对接规范.md §五
+ */
+import "dotenv/config";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerBalanceTools } from "./tools/balance.js";
+import { registerGatewayTools } from "./tools/gateway.js";
+import { registerTxHistoryTools } from "./tools/txhistory.js";
+import { registerDefiTools } from "./tools/defi.js";
+import { registerPaymentsTools } from "./tools/payments.js";
+import { registerTradeTools } from "./tools/trade.js";
+import { registerIntentTools } from "./tools/intent.js";
+import { registerMarketTools } from "./tools/market.js";
+import { registerWsTools } from "./tools/ws.js";
+import { registerSkillTools } from "./tools/skills.js";
+function resolveAuth() {
+    const k = process.env.OKX_API_KEY, s = process.env.OKX_SECRET_KEY, p = process.env.OKX_PASSPHRASE;
+    if (k && s && p)
+        return { apiKey: k, secret: s, passphrase: p };
+    const a = process.argv.slice(2), g = (f) => { const i = a.indexOf(f); return i >= 0 ? a[i + 1] : undefined; };
+    const ka = g("--okx-api-key") ?? g("-k"), sa = g("--okx-secret") ?? g("-s"), pa = g("--okx-passphrase") ?? g("-p");
+    if (ka && sa && pa)
+        return { apiKey: ka, secret: sa, passphrase: pa };
+    return null;
+}
+async function main() {
+    const auth = resolveAuth();
+    if (!auth) {
+        console.error("[h-mcp] 未配置 API Key。设置 OKX_API_KEY / OKX_SECRET_KEY / OKX_PASSPHRASE");
+        console.error("[h-mcp] 获取: https://web3.okx.com/onchainos/dev-portal");
+    }
+    else {
+        console.error("[h-mcp] Auth 已配置");
+    }
+    const server = new McpServer({ name: "hchain-mcp", version: "1.0.0" });
+    // 逐模块注册工具 (按官方文档对接)
+    registerBalanceTools(server, auth);
+    registerGatewayTools(server, auth);
+    registerTxHistoryTools(server, auth);
+    registerDefiTools(server, auth);
+    registerPaymentsTools(server, auth);
+    registerTradeTools(server, auth);
+    registerIntentTools(server, auth);
+    registerMarketTools(server, auth);
+    registerWsTools(server, auth);
+    registerSkillTools(server, auth);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[h-mcp] 就绪");
+}
+main().catch(e => { console.error("[h-mcp] 启动失败:", e); process.exit(1); });
+//# sourceMappingURL=index.js.map

package/dist/tools/balance.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Auth } from "../adapters/shared.js";
+export declare function registerBalanceTools(server: McpServer, auth: Auth | null): void;
+//# sourceMappingURL=balance.d.ts.map