@aibtc/mcp-server 1.34.0 → 1.36.0

package/dist/tools/skill-mappings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-mappings.js","sourceRoot":"","sources":["../../src/tools/skill-mappings.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,cAAc,GAA2B;IACpD,mDAAmD;IACnD,eAAe,EAAE,QAAQ;IACzB,aAAa,EAAE,QAAQ;IACvB,aAAa,EAAE,QAAQ;IACvB,aAAa,EAAE,QAAQ;IACvB,WAAW,EAAE,QAAQ;IACrB,WAAW,EAAE,QAAQ;IACrB,aAAa,EAAE,QAAQ;IACvB,aAAa,EAAE,QAAQ;IACvB,aAAa,EAAE,QAAQ;IACvB,sBAAsB,EAAE,QAAQ;IAChC,kBAAkB,EAAE,QAAQ;IAC5B,aAAa,EAAE,QAAQ;IAEvB,2DAA2D;IAC3D,eAAe,EAAE,KAAK;IACtB,YAAY,EAAE,KAAK;IACnB,qBAAqB,EAAE,KAAK;IAC5B,aAAa,EAAE,KAAK;IACpB,eAAe,EAAE,KAAK;IACtB,sBAAsB,EAAE,KAAK;IAE7B,oCAAoC;IACpC,eAAe,EAAE,KAAK;IACtB,YAAY,EAAE,KAAK;IACnB,aAAa,EAAE,KAAK;IACpB,YAAY,EAAE,KAAK;IACnB,kBAAkB,EAAE,KAAK;IACzB,iBAAiB,EAAE,KAAK;IACxB,2BAA2B,EAAE,KAAK;IAClC,oBAAoB,EAAE,KAAK;IAC3B,0BAA0B,EAAE,KAAK;IACjC,mBAAmB,EAAE,KAAK;IAE1B,qCAAqC;IACrC,gBAAgB,EAAE,MAAM;IACxB,aAAa,EAAE,MAAM;IACrB,qBAAqB,EAAE,MAAM;IAC7B,iBAAiB,EAAE,MAAM;IACzB,YAAY,EAAE,MAAM;IACpB,mBAAmB,EAAE,MAAM;IAC3B,wBAAwB,EAAE,MAAM;IAChC,aAAa,EAAE,MAAM;IACrB,sBAAsB,EAAE,MAAM;IAC9B,oBAAoB,EAAE,MAAM;IAE5B,mDAAmD;IACnD,iBAAiB,EAAE,QAAQ;IAC3B,cAAc,EAAE,QAAQ;IACxB,gBAAgB,EAAE,QAAQ;IAC1B,iBAAiB,EAAE,QAAQ;IAC3B,cAAc,EAAE,QAAQ;IAExB,qCAAqC;IACrC,gBAAgB,EAAE,KAAK;IACvB,gBAAgB,EAAE,KAAK;IACvB,YAAY,EAAE,KAAK;IACnB,aAAa,EAAE,KAAK;IACpB,mBAAmB,EAAE,KAAK;IAC1B,eAAe,EAAE,KAAK;IAEtB,mDAAmD;IACnD,YAAY,EAAE,UAAU;IACxB,mBAAmB,EAAE,UAAU;IAC/B,SAAS,EAAE,UAAU;IACrB,eAAe,EAAE,UAAU;IAE3B,0DAA0D;IAC1D,oBAAoB,EAAE,eAAe;IACrC,yBAAyB,EAAE,eAAe;IAC1C,oBAAoB,EAAE,eAAe;IACrC,qBAAqB,EAAE,eAAe;IAEtC,6CAA6C;IAC7C,eAAe,EAAE,KAAK;IACtB,kBAAkB,EAAE,KAAK;IACzB,YAAY,EAAE,KAAK;IACnB,sBAAsB,EAAE,KAAK;IAC7B,aAAa,EAAE,KAAK;IACpB,iBAAiB,EAAE,KAAK;IACxB,mBAAmB,EAAE,KAAK;IAC1B,iBAAiB,EAAE,KAAK;IACxB,iBAAiB,EAAE,KAAK;IAExB,sDAAsD;IACtD,YAAY,EAAE,OAAO;IACrB,gBAAgB,EAAE,OAAO;IACzB,wBAAwB,EAAE,OAAO;IACjC,cAAc,EAAE,OAAO;IACvB,gBAAgB,EAAE,OAAO;IACzB,iBAAiB,EAAE,OAAO;IAC1B,mBAAmB,EAAE,OAAO;IAC5B,kBAAkB,EAAE,OAAO;IAC3B,uBAAuB,EAAE,OAAO;IAEhC,mEAAmE;IACnE,mBAAmB,EAAE,MAAM;IAC3B,qBAAqB,EAAE,MAAM;IAC7B,mBAAmB,EAAE,MAAM;IAC3B,sBAAsB,EAAE,MAAM;IAC9B,yBAAyB,EAAE,MAAM;IACjC,4BAA4B,EAAE,MAAM;IACpC,iBAAiB,EAAE,MAAM;IACzB,kBAAkB,EAAE,MAAM;IAE1B,0CAA0C;IAC1C,eAAe,EAAE,MAAM;IACvB,mBAAmB,EAAE,MAAM;IAC3B,SAAS,EAAE,MAAM;IACjB,kBAAkB,EAAE,MAAM;IAC1B,gBAAgB,EAAE,MAAM;IACxB,iBAAiB,EAAE,MAAM;IACzB,WAAW,EAAE,MAAM;IACnB,aAAa,EAAE,MAAM;IACrB,WAAW,EAAE,MAAM;IACnB,UAAU,EAAE,MAAM;IAElB,qDAAqD;IACrD,gBAAgB,EAAE,MAAM;IACxB,UAAU,EAAE,MAAM;IAClB,SAAS,EAAE,MAAM;IACjB,UAAU,EAAE,MAAM;IAClB,YAAY,EAAE,MAAM;IACpB,WAAW,EAAE,MAAM;IACnB,YAAY,EAAE,MAAM;IAEpB,4DAA4D;IAC5D,kBAAkB,EAAE,cAAc;IAClC,iBAAiB,EAAE,cAAc;IACjC,mBAAmB,EAAE,cAAc;IACnC,sBAAsB,EAAE,cAAc;IAEtC,mFAAmF;IACnF,cAAc,EAAE,QAAQ;IACxB,iBAAiB,EAAE,QAAQ;IAC3B,aAAa,EAAE,QAAQ;IACvB,WAAW,EAAE,QAAQ;IACrB,WAAW,EAAE,QAAQ;IACrB,gBAAgB,EAAE,QAAQ;IAC1B,aAAa,EAAE,QAAQ;IACvB,oBAAoB,EAAE,QAAQ;IAC9B,aAAa,EAAE,QAAQ;IACvB,YAAY,EAAE,QAAQ;IACtB,eAAe,EAAE,QAAQ;IACzB,oBAAoB,EAAE,QAAQ;IAC9B,aAAa,EAAE,QAAQ;IACvB,iBAAiB,EAAE,QAAQ;IAC3B,mBAAmB,EAAE,QAAQ;IAC7B,sBAAsB,EAAE,QAAQ;IAChC,iBAAiB,EAAE,QAAQ;IAC3B,mBAAmB,EAAE,QAAQ;IAC7B,iBAAiB,EAAE,QAAQ;IAC3B,eAAe,EAAE,QAAQ;IACzB,eAAe,EAAE,QAAQ;IACzB,mBAAmB,EAAE,QAAQ;IAC7B,oBAAoB,EAAE,QAAQ;IAC9B,oBAAoB,EAAE,QAAQ;IAC9B,kBAAkB,EAAE,QAAQ;IAC5B,2BAA2B,EAAE,QAAQ;IACrC,sBAAsB,EAAE,QAAQ;IAChC,iCAAiC,EAAE,QAAQ;IAC3C,uBAAuB,EAAE,QAAQ;IACjC,2BAA2B,EAAE,QAAQ;IACrC,wBAAwB,EAAE,QAAQ;IAClC,0BAA0B,EAAE,QAAQ;IACpC,6BAA6B,EAAE,QAAQ;IACvC,wBAAwB,EAAE,QAAQ;IAClC,mBAAmB,EAAE,QAAQ;IAC7B,+BAA+B,EAAE,QAAQ;IACzC,uBAAuB,EAAE,QAAQ;IACjC,8BAA8B,EAAE,QAAQ;IACxC,6BAA6B,EAAE,QAAQ;IAEvC,6DAA6D;IAC7D,gBAAgB,EAAE,UAAU;IAC5B,gBAAgB,EAAE,UAAU;IAC5B,mBAAmB,EAAE,UAAU;IAC/B,kBAAkB,EAAE,UAAU;IAC9B,kBAAkB,EAAE,UAAU;IAC9B,qBAAqB,EAAE,UAAU;IACjC,kBAAkB,EAAE,UAAU;IAC9B,kBAAkB,EAAE,UAAU;IAC9B,qBAAqB,EAAE,UAAU;IAEjC,mDAAmD;IACnD,mBAAmB,EAAE,SAAS;IAC9B,qBAAqB,EAAE,SAAS;IAChC,gBAAgB,EAAE,SAAS;IAC3B,kBAAkB,EAAE,SAAS;IAC7B,mBAAmB,EAAE,SAAS;IAC9B,qBAAqB,EAAE,SAAS;IAChC,gBAAgB,EAAE,SAAS;IAE3B,2DAA2D;IAC3D,mBAAmB,EAAE,UAAU;IAC/B,wBAAwB,EAAE,UAAU;IACpC,QAAQ,EAAE,UAAU;IACpB,eAAe,EAAE,UAAU;IAC3B,eAAe,EAAE,UAAU;IAC3B,cAAc,EAAE,UAAU;IAC1B,qBAAqB,EAAE,UAAU;IACjC,8BAA8B,EAAE,UAAU;IAE1C,8DAA8D;IAC9D,WAAW,EAAE,cAAc;IAC3B,SAAS,EAAE,cAAc;IACzB,cAAc,EAAE,cAAc;IAC9B,uBAAuB,EAAE,cAAc;IAEvC,oDAAoD;IACpD,iBAAiB,EAAE,UAAU;IAC7B,YAAY,EAAE,UAAU;IAExB,wDAAwD;IACxD,aAAa,EAAE,YAAY;IAC3B,cAAc,EAAE,YAAY;IAE5B,wDAAwD;IACxD,kBAAkB,EAAE,YAAY;IAChC,qBAAqB,EAAE,YAAY;IACnC,sBAAsB,EAAE,YAAY;IAEpC,0CAA0C;IAC1C,mBAAmB,EAAE,WAAW;IAChC,uBAAuB,EAAE,WAAW;IACpC,kBAAkB,EAAE,WAAW;IAC/B,mBAAmB,EAAE,WAAW;IAChC,uBAAuB,EAAE,WAAW;IACpC,oBAAoB,EAAE,WAAW;IAEjC,yCAAyC;IACzC,kBAAkB,EAAE,SAAS;IAC7B,kBAAkB,EAAE,SAAS;IAC7B,wBAAwB,EAAE,SAAS;IACnC,iBAAiB,EAAE,SAAS;IAC5B,kBAAkB,EAAE,SAAS;IAC7B,YAAY,EAAE,SAAS;IACvB,2BAA2B,EAAE,SAAS;IACtC,oBAAoB,EAAE,SAAS;IAC/B,iBAAiB,EAAE,SAAS;IAC5B,oBAAoB,EAAE,SAAS;IAC/B,uBAAuB,EAAE,SAAS;CACnC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC"}

package/dist/tools/tenero.tools.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Tenero market analytics tools
+ *
+ * Read-only MCP tools for Stacks ecosystem market data via the Tenero API
+ * (formerly STXTools) at https://api.tenero.io. No authentication required.
+ *
+ * Tools:
+ * - tenero_token_info        — Token metadata, price, and volume
+ * - tenero_market_summary    — Price history and pool liquidity for a token
+ * - tenero_market_stats      — Overall market volume, netflow, and active traders
+ * - tenero_top_gainers       — Top gaining tokens by 24h price change
+ * - tenero_top_losers        — Top losing tokens by 24h price change
+ * - tenero_trending_pools    — Trending DEX liquidity pools by 1h volume
+ * - tenero_wallet_trades     — Trade history for a wallet address
+ * - tenero_wallet_holdings   — Token holdings with current USD value for a wallet
+ * - tenero_whale_trades      — Recent large trades above threshold value
+ * - tenero_holder_stats      — Token holder distribution and concentration stats
+ * - tenero_search            — Search tokens, pools, and wallets by name or address
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerTeneroTools(server: McpServer): void;
+//# sourceMappingURL=tenero.tools.d.ts.map

package/dist/tools/tenero.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenero.tools.d.ts","sourceRoot":"","sources":["../../src/tools/tenero.tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiBpE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkW3D"}

package/dist/tools/tenero.tools.js

@@ -0,0 +1,318 @@
+/**
+ * Tenero market analytics tools
+ *
+ * Read-only MCP tools for Stacks ecosystem market data via the Tenero API
+ * (formerly STXTools) at https://api.tenero.io. No authentication required.
+ *
+ * Tools:
+ * - tenero_token_info        — Token metadata, price, and volume
+ * - tenero_market_summary    — Price history and pool liquidity for a token
+ * - tenero_market_stats      — Overall market volume, netflow, and active traders
+ * - tenero_top_gainers       — Top gaining tokens by 24h price change
+ * - tenero_top_losers        — Top losing tokens by 24h price change
+ * - tenero_trending_pools    — Trending DEX liquidity pools by 1h volume
+ * - tenero_wallet_trades     — Trade history for a wallet address
+ * - tenero_wallet_holdings   — Token holdings with current USD value for a wallet
+ * - tenero_whale_trades      — Recent large trades above threshold value
+ * - tenero_holder_stats      — Token holder distribution and concentration stats
+ * - tenero_search            — Search tokens, pools, and wallets by name or address
+ */
+import { z } from "zod";
+import { createJsonResponse, createErrorResponse } from "../utils/index.js";
+import { getTokenInfo, getMarketSummary, getMarketStats, getTopGainers, getTopLosers, getTrendingPools, getWalletTrades, getWalletHoldings, getWhaleTrades, getHolderStats, searchTokens, } from "../services/tenero-api.js";
+export function registerTeneroTools(server) {
+    // Token info
+    server.registerTool("tenero_token_info", {
+        description: "Get token details including metadata, current price, market cap, and 24h volume. " +
+            "Powered by the Tenero API (api.tenero.io). No authentication required.",
+        inputSchema: {
+            contractId: z
+                .string()
+                .describe("Token contract address in format PRINCIPAL.contract-name " +
+                "(e.g. SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.token-alex)"),
+            chain: z
+                .string()
+                .optional()
+                .default("stacks")
+                .describe("Chain to query: stacks, spark, or sportsfun (default: stacks)"),
+        },
+    }, async ({ contractId, chain }) => {
+        try {
+            const data = await getTokenInfo(contractId, chain);
+            return createJsonResponse(data);
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // Market summary (per token)
+    server.registerTool("tenero_market_summary", {
+        description: "Get token market summary including price history, 24h volume, and pool liquidity. " +
+            "Returns weighted price across all pools trading this token. " +
+            "Powered by the Tenero API (api.tenero.io). No authentication required.",
+        inputSchema: {
+            contractId: z
+                .string()
+                .describe("Token contract address in format PRINCIPAL.contract-name " +
+                "(e.g. SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.token-alex)"),
+            chain: z
+                .string()
+                .optional()
+                .default("stacks")
+                .describe("Chain to query: stacks, spark, or sportsfun (default: stacks)"),
+        },
+    }, async ({ contractId, chain }) => {
+        try {
+            const data = await getMarketSummary(contractId, chain);
+            return createJsonResponse(data);
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // Overall market stats
+    server.registerTool("tenero_market_stats", {
+        description: "Get overall Stacks ecosystem market statistics including total volume, " +
+            "buy/sell netflow, unique traders, and active pools. " +
+            "Returns a time series of daily stats for recent periods. " +
+            "Powered by the Tenero API (api.tenero.io). No authentication required.",
+        inputSchema: {
+            chain: z
+                .string()
+                .optional()
+                .default("stacks")
+                .describe("Chain to query: stacks, spark, or sportsfun (default: stacks)"),
+        },
+    }, async ({ chain }) => {
+        try {
+            const data = await getMarketStats(chain);
+            return createJsonResponse(data);
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // Top gainers
+    server.registerTool("tenero_top_gainers", {
+        description: "List top gaining tokens by 24h price change percentage on the Stacks ecosystem. " +
+            "Useful for spotting momentum and trending assets. " +
+            "Powered by the Tenero API (api.tenero.io). No authentication required.",
+        inputSchema: {
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .optional()
+                .default(10)
+                .describe("Maximum number of tokens to return (default: 10, max: 50)"),
+            chain: z
+                .string()
+                .optional()
+                .default("stacks")
+                .describe("Chain to query: stacks, spark, or sportsfun (default: stacks)"),
+        },
+    }, async ({ limit, chain }) => {
+        try {
+            const data = await getTopGainers(limit, chain);
+            return createJsonResponse(data);
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // Top losers
+    server.registerTool("tenero_top_losers", {
+        description: "List top losing tokens by 24h price change percentage on the Stacks ecosystem. " +
+            "Useful for identifying underperforming assets or potential reversal candidates. " +
+            "Powered by the Tenero API (api.tenero.io). No authentication required.",
+        inputSchema: {
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .optional()
+                .default(10)
+                .describe("Maximum number of tokens to return (default: 10, max: 50)"),
+            chain: z
+                .string()
+                .optional()
+                .default("stacks")
+                .describe("Chain to query: stacks, spark, or sportsfun (default: stacks)"),
+        },
+    }, async ({ limit, chain }) => {
+        try {
+            const data = await getTopLosers(limit, chain);
+            return createJsonResponse(data);
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // Trending pools
+    server.registerTool("tenero_trending_pools", {
+        description: "List trending DEX liquidity pools by volume over the last hour. " +
+            "Includes pool platform, token pair, volume, and liquidity details. " +
+            "Powered by the Tenero API (api.tenero.io). No authentication required.",
+        inputSchema: {
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .optional()
+                .default(10)
+                .describe("Maximum number of pools to return (default: 10, max: 50)"),
+            chain: z
+                .string()
+                .optional()
+                .default("stacks")
+                .describe("Chain to query: stacks, spark, or sportsfun (default: stacks)"),
+        },
+    }, async ({ limit, chain }) => {
+        try {
+            const data = await getTrendingPools(limit, chain);
+            return createJsonResponse(data);
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // Wallet trades
+    server.registerTool("tenero_wallet_trades", {
+        description: "Get trade history for a Stacks wallet address. " +
+            "Returns recent buy/sell events with token, pool, and USD value details. " +
+            "Powered by the Tenero API (api.tenero.io). No authentication required.",
+        inputSchema: {
+            address: z
+                .string()
+                .describe("Stacks wallet address (SP... or SM...)"),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(100)
+                .optional()
+                .default(20)
+                .describe("Maximum number of trades to return (default: 20, max: 100)"),
+            chain: z
+                .string()
+                .optional()
+                .default("stacks")
+                .describe("Chain to query: stacks, spark, or sportsfun (default: stacks)"),
+        },
+    }, async ({ address, limit, chain }) => {
+        try {
+            const data = await getWalletTrades(address, limit, chain);
+            return createJsonResponse(data);
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // Wallet holdings
+    server.registerTool("tenero_wallet_holdings", {
+        description: "Get token holdings with current USD value for a Stacks wallet address. " +
+            "Shows portfolio composition including token balances and estimated values. " +
+            "Powered by the Tenero API (api.tenero.io). No authentication required.",
+        inputSchema: {
+            address: z
+                .string()
+                .describe("Stacks wallet address (SP... or SM...)"),
+            chain: z
+                .string()
+                .optional()
+                .default("stacks")
+                .describe("Chain to query: stacks, spark, or sportsfun (default: stacks)"),
+        },
+    }, async ({ address, chain }) => {
+        try {
+            const data = await getWalletHoldings(address, chain);
+            return createJsonResponse(data);
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // Whale trades
+    server.registerTool("tenero_whale_trades", {
+        description: "Get recent large/whale trades above threshold value on the Stacks ecosystem. " +
+            "Useful for tracking smart money and large market movements. " +
+            "Powered by the Tenero API (api.tenero.io). No authentication required.",
+        inputSchema: {
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .optional()
+                .default(10)
+                .describe("Maximum number of whale trades to return (default: 10, max: 50)"),
+            chain: z
+                .string()
+                .optional()
+                .default("stacks")
+                .describe("Chain to query: stacks, spark, or sportsfun (default: stacks)"),
+        },
+    }, async ({ limit, chain }) => {
+        try {
+            const data = await getWhaleTrades(limit, chain);
+            return createJsonResponse(data);
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // Holder stats
+    server.registerTool("tenero_holder_stats", {
+        description: "Get token holder distribution and concentration statistics. " +
+            "Shows total holders, top holder percentages, and Gini coefficient. " +
+            "Powered by the Tenero API (api.tenero.io). No authentication required.",
+        inputSchema: {
+            contractId: z
+                .string()
+                .describe("Token contract address in format PRINCIPAL.contract-name " +
+                "(e.g. SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.token-alex)"),
+            chain: z
+                .string()
+                .optional()
+                .default("stacks")
+                .describe("Chain to query: stacks, spark, or sportsfun (default: stacks)"),
+        },
+    }, async ({ contractId, chain }) => {
+        try {
+            const data = await getHolderStats(contractId, chain);
+            return createJsonResponse(data);
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // Search
+    server.registerTool("tenero_search", {
+        description: "Search tokens, pools, and wallets by name, symbol, or contract address. " +
+            "Returns matching tokens with metadata and pricing information. " +
+            "Powered by the Tenero API (api.tenero.io). No authentication required.",
+        inputSchema: {
+            query: z
+                .string()
+                .min(1)
+                .describe("Search query: token name, symbol, or contract address"),
+            chain: z
+                .string()
+                .optional()
+                .default("stacks")
+                .describe("Chain to query: stacks, spark, or sportsfun (default: stacks)"),
+        },
+    }, async ({ query, chain }) => {
+        try {
+            const data = await searchTokens(query, chain);
+            return createJsonResponse(data);
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=tenero.tools.js.map

package/dist/tools/tenero.tools.js.map

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

package/dist/utils/relay-health.d.ts

@@ -5,6 +5,11 @@
  * diagnostic information when send failures occur.
  */
 import type { Network } from "../config/networks.js";
+export interface StuckTransaction {
+    txid: string;
+    nonce: number;
+    pendingSeconds: number;
+}
 export interface RelayHealthStatus {
     healthy: boolean;
     network: Network;
@@ -18,7 +23,10 @@ export interface RelayHealthStatus {
         mempoolNonces: number[];
         hasGaps: boolean;
         gapCount: number;
+        mempoolDesync: boolean;
+        desyncGap: number;
     };
+    stuckTransactions?: StuckTransaction[];
     issues?: string[];
 }
 /**
@@ -29,6 +37,26 @@ export declare function checkRelayHealth(network: Network): Promise<RelayHealthS
  * Format relay health status as a human-readable string
  */
 export declare function formatRelayHealthStatus(status: RelayHealthStatus): string;
+export interface RelayRecoveryResult {
+    supported: boolean;
+    message?: string;
+    result?: unknown;
+}
+/**
+ * Attempt RBF (replace-by-fee) on stuck transactions via the relay API.
+ * If txids is provided, only those transactions are bumped; otherwise the relay
+ * bumps all stuck transactions it knows about.
+ *
+ * Gracefully returns { supported: false } if the relay returns 404 or 501.
+ */
+export declare function attemptRbf(network: Network, txids?: string[], apiKey?: string): Promise<RelayRecoveryResult>;
+/**
+ * Attempt to fill nonce gaps on the relay by having it submit placeholder transactions.
+ * If nonces is provided, only those gaps are filled; otherwise the relay fills all detected gaps.
+ *
+ * Gracefully returns { supported: false } if the relay returns 404 or 501.
+ */
+export declare function attemptFillGaps(network: Network, nonces?: number[], apiKey?: string): Promise<RelayRecoveryResult>;
 /**
  * Wait with exponential backoff when relay nonce issues are detected
  * Returns recommended wait time in milliseconds

package/dist/utils/relay-health.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relay-health.d.ts","sourceRoot":"","sources":["../../src/utils/relay-health.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGrD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE;QACZ,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAUD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmFnF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAwCzE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,MAAM,CASnF"}
+{"version":3,"file":"relay-health.d.ts","sourceRoot":"","sources":["../../src/utils/relay-health.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGrD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE;QACZ,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,OAAO,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACvC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAUD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA4HnF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAuDzE;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAiDlH;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAiDxH;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,MAAM,CASnF"}

package/dist/utils/relay-health.js

@@ -4,7 +4,7 @@
  * Proactively checks the sponsor relay for nonce gaps and provides
  * diagnostic information when send failures occur.
  */
-import { getSponsorRelayUrl } from "../config/sponsor.js";
+import { getSponsorRelayUrl, getSponsorApiKey } from "../config/sponsor.js";
 import { getHiroApi } from "../services/hiro-api.js";
 /**
  * Known sponsor addresses for each network.
@@ -53,27 +53,65 @@ export async function checkRelayHealth(network) {
         const nonceInfo = await hiroApi.getNonceInfo(sponsorAddress);
         const hasGaps = nonceInfo.detected_missing_nonces.length > 0;
         const gapCount = nonceInfo.detected_missing_nonces.length;
+        // Mempool desync: sponsor has submitted far more txs than have been confirmed
+        const lastExecuted = nonceInfo.last_executed_tx_nonce || 0;
+        const lastMempool = nonceInfo.last_mempool_tx_nonce;
+        const desyncGap = lastMempool !== null ? lastMempool - lastExecuted : 0;
+        const mempoolDesync = desyncGap > 5;
         if (hasGaps) {
             issues.push(`Sponsor has ${gapCount} missing nonce(s): ${nonceInfo.detected_missing_nonces.slice(0, 5).join(", ")}${gapCount > 5 ? "..." : ""}`);
         }
-        if (nonceInfo.detected_mempool_nonces.length > 10) {
+        if (mempoolDesync) {
+            issues.push(`Mempool desync detected: sponsor nonce ${lastExecuted} (executed) vs ${lastMempool} (mempool), gap of ${desyncGap}`);
+        }
+        else if (nonceInfo.detected_mempool_nonces.length > 10) {
             issues.push(`Sponsor has ${nonceInfo.detected_mempool_nonces.length} transactions stuck in mempool`);
         }
         const nonceStatus = {
-            lastExecuted: nonceInfo.last_executed_tx_nonce || 0,
-            lastMempool: nonceInfo.last_mempool_tx_nonce,
+            lastExecuted,
+            lastMempool,
             possibleNext: nonceInfo.possible_next_nonce,
             missingNonces: nonceInfo.detected_missing_nonces,
             mempoolNonces: nonceInfo.detected_mempool_nonces,
             hasGaps,
             gapCount,
+            mempoolDesync,
+            desyncGap,
         };
+        // Fetch stuck transactions from mempool for actionable diagnostics
+        let stuckTransactions;
+        try {
+            const mempoolRes = await hiroApi.getMempoolTransactions({
+                sender_address: sponsorAddress,
+                limit: 50,
+            });
+            const nowSeconds = Math.floor(Date.now() / 1000);
+            const stuck = mempoolRes.results
+                .filter((tx) => {
+                const pendingSeconds = nowSeconds - tx.receipt_time;
+                return pendingSeconds > 60;
+            })
+                .map((tx) => ({
+                txid: tx.tx_id,
+                nonce: tx.nonce,
+                pendingSeconds: nowSeconds - tx.receipt_time,
+            }))
+                .sort((a, b) => b.pendingSeconds - a.pendingSeconds)
+                .slice(0, 10);
+            if (stuck.length > 0) {
+                stuckTransactions = stuck;
+            }
+        }
+        catch {
+            // Non-fatal: stuck-tx fetch is best-effort
+        }
         return {
             healthy: issues.length === 0,
             network,
             version,
             sponsorAddress,
             nonceStatus,
+            stuckTransactions,
             issues: issues.length > 0 ? issues : undefined,
         };
     }
@@ -107,15 +145,28 @@ export function formatRelayHealthStatus(status) {
         lines.push(`  Last mempool: ${ns.lastMempool ?? "none"}`);
         lines.push(`  Next nonce: ${ns.possibleNext}`);
         if (ns.hasGaps) {
-            lines.push(`  ❌ Missing nonces (${ns.gapCount}): ${ns.missingNonces.slice(0, 10).join(", ")}${ns.gapCount > 10 ? "..." : ""}`);
+            lines.push(`  GAPS Missing nonces (${ns.gapCount}): ${ns.missingNonces.slice(0, 10).join(", ")}${ns.gapCount > 10 ? "..." : ""}`);
         }
         else {
-            lines.push("  ✅ No nonce gaps");
+            lines.push("  OK No nonce gaps");
+        }
+        if (ns.mempoolDesync) {
+            lines.push(`  DESYNC Mempool desync: executed=${ns.lastExecuted}, mempool=${ns.lastMempool ?? "none"}, gap=${ns.desyncGap}`);
         }
         if (ns.mempoolNonces.length > 0) {
-            lines.push(`  ⚠️  Mempool nonces (${ns.mempoolNonces.length}): ${ns.mempoolNonces.slice(0, 10).join(", ")}${ns.mempoolNonces.length > 10 ? "..." : ""}`);
+            lines.push(`  WARN Mempool nonces (${ns.mempoolNonces.length}): ${ns.mempoolNonces.slice(0, 10).join(", ")}${ns.mempoolNonces.length > 10 ? "..." : ""}`);
         }
     }
+    if (status.stuckTransactions && status.stuckTransactions.length > 0) {
+        lines.push("");
+        lines.push("Stuck Transactions:");
+        status.stuckTransactions.forEach((tx) => {
+            const minutes = Math.floor(tx.pendingSeconds / 60);
+            const seconds = tx.pendingSeconds % 60;
+            const duration = minutes > 0 ? `${minutes}m ${seconds}s` : `${seconds}s`;
+            lines.push(`  nonce=${tx.nonce} pending=${duration} txid=${tx.txid}`);
+        });
+    }
     if (status.issues && status.issues.length > 0) {
         lines.push("");
         lines.push("Issues:");
@@ -123,6 +174,105 @@ export function formatRelayHealthStatus(status) {
     }
     return lines.join("\n");
 }
+/**
+ * Attempt RBF (replace-by-fee) on stuck transactions via the relay API.
+ * If txids is provided, only those transactions are bumped; otherwise the relay
+ * bumps all stuck transactions it knows about.
+ *
+ * Gracefully returns { supported: false } if the relay returns 404 or 501.
+ */
+export async function attemptRbf(network, txids, apiKey) {
+    const relayUrl = getSponsorRelayUrl(network);
+    const resolvedKey = apiKey || getSponsorApiKey();
+    if (!resolvedKey) {
+        return {
+            supported: true,
+            message: "No sponsor API key available. Set SPONSOR_API_KEY env var or use a wallet with sponsorApiKey configured.",
+        };
+    }
+    const headers = {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${resolvedKey}`,
+    };
+    const body = {};
+    if (txids && txids.length > 0) {
+        body.txids = txids;
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 30000);
+    try {
+        const res = await fetch(`${relayUrl}/recovery/rbf`, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(body),
+            signal: controller.signal,
+        });
+        if (res.status === 404 || res.status === 501) {
+            return {
+                supported: false,
+                message: "Relay does not support RBF recovery yet. Share stuck txids with the AIBTC team for manual recovery.",
+            };
+        }
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`Relay RBF failed: HTTP ${res.status} — ${text}`);
+        }
+        const result = await res.json();
+        return { supported: true, result };
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/**
+ * Attempt to fill nonce gaps on the relay by having it submit placeholder transactions.
+ * If nonces is provided, only those gaps are filled; otherwise the relay fills all detected gaps.
+ *
+ * Gracefully returns { supported: false } if the relay returns 404 or 501.
+ */
+export async function attemptFillGaps(network, nonces, apiKey) {
+    const relayUrl = getSponsorRelayUrl(network);
+    const resolvedKey = apiKey || getSponsorApiKey();
+    if (!resolvedKey) {
+        return {
+            supported: true,
+            message: "No sponsor API key available. Set SPONSOR_API_KEY env var or use a wallet with sponsorApiKey configured.",
+        };
+    }
+    const headers = {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${resolvedKey}`,
+    };
+    const body = {};
+    if (nonces && nonces.length > 0) {
+        body.nonces = nonces;
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 30000);
+    try {
+        const res = await fetch(`${relayUrl}/recovery/fill-gaps`, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(body),
+            signal: controller.signal,
+        });
+        if (res.status === 404 || res.status === 501) {
+            return {
+                supported: false,
+                message: "Relay does not support nonce gap-fill recovery yet. Share missing nonces with the AIBTC team for manual recovery.",
+            };
+        }
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`Relay gap-fill failed: HTTP ${res.status} — ${text}`);
+        }
+        const result = await res.json();
+        return { supported: true, result };
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
 /**
  * Wait with exponential backoff when relay nonce issues are detected
  * Returns recommended wait time in milliseconds