@0xwh1sker/mantle-core 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mantle
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,36 @@
+# @0xwh1sker/mantle-core
+
+Shared business logic for Mantle L2 tooling — chain reads, DeFi queries, and unsigned transaction building.
+
+## Install
+
+```bash
+npm install @0xwh1sker/mantle-core
+```
+
+## What's included
+
+- **tools/** — callable handlers for chain, registry, account, token, DeFi, indexer, and diagnostics operations
+- **lib/** — shared helpers: viem clients, network normalization, token registry, endpoint policy, contract ABIs
+- **config/** — chain configs, token lists, protocol metadata, DEX pairs, Aave reserves
+- **errors.ts** — `MantleMcpError` error class
+- **types.ts** — `Tool`, `Resource`, `Network` type definitions
+- **capability-catalog.ts** — structured tool metadata for LLM discovery
+
+## Usage
+
+```ts
+import { allTools } from "@0xwh1sker/mantle-core/tools/index.js";
+
+const result = await allTools["mantle_getChainInfo"].handler({ network: "mainnet" });
+console.log(result);
+```
+
+## Related packages
+
+- [`@0xwh1sker/mantle-cli`](https://www.npmjs.com/package/@0xwh1sker/mantle-cli) — CLI interface built on mantle-core
+- [`@0xwh1sker/mantle-mcp`](https://www.npmjs.com/package/@0xwh1sker/mantle-mcp) — MCP server for AI agents
+
+## License
+
+MIT

package/dist/capability-catalog.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Capability Catalog — structured self-description of every tool.
+ *
+ * Each entry carries semantic metadata so an LLM can:
+ *   1. Distinguish reads from writes at a glance
+ *   2. Know which tools need a wallet address
+ *   3. Locate the right tool via category search
+ *   4. Understand call ordering via `workflow_before` hints
+ *   5. Get the exact CLI command to run
+ */
+export interface CapabilityEntry {
+    /** Tool name (internal identifier). */
+    id: string;
+    /** Human-readable short label. */
+    name: string;
+    /** Semantic category for quick filtering. */
+    category: "query" | "analyze" | "execute";
+    /** Whether the tool mutates on-chain state (constructs unsigned tx). */
+    mutates: boolean;
+    /** Whether a wallet/owner address is required or optional. */
+    auth: "none" | "optional" | "required";
+    /** One-line purpose. */
+    summary: string;
+    /** CLI command template (copy-pasteable). */
+    cli_command: string;
+    /** Concrete usage example (MCP JSON args, kept for reference). */
+    example: string;
+    /** Tools typically called before this one. */
+    workflow_before?: string[];
+    /** Tags for free-text search. */
+    tags: string[];
+}
+export declare function capabilityCatalog(): {
+    version: string;
+    description: string;
+    capabilities: CapabilityEntry[];
+};
+//# sourceMappingURL=capability-catalog.d.ts.map

package/dist/capability-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-catalog.d.ts","sourceRoot":"","sources":["../src/capability-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IAC1C,wEAAwE;IACxE,OAAO,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;IACvC,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,iCAAiC;IACjC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,wBAAgB,iBAAiB,IAAI;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,eAAe,EAAE,CAAC;CACjC,CAUA"}

package/dist/capability-catalog.js

@@ -0,0 +1,449 @@
+/**
+ * Capability Catalog — structured self-description of every tool.
+ *
+ * Each entry carries semantic metadata so an LLM can:
+ *   1. Distinguish reads from writes at a glance
+ *   2. Know which tools need a wallet address
+ *   3. Locate the right tool via category search
+ *   4. Understand call ordering via `workflow_before` hints
+ *   5. Get the exact CLI command to run
+ */
+export function capabilityCatalog() {
+    return {
+        version: "0.3.0",
+        description: "Structured capability catalog for Mantle CLI tools. " +
+            "Use category='query' for read-only lookups, 'analyze' for computed insights, " +
+            "'execute' for transaction building. Check 'auth' to know if a wallet address is needed. " +
+            "Always append --json for machine-readable output.",
+        capabilities: CAPABILITIES
+    };
+}
+// ---------------------------------------------------------------------------
+// Static registry
+// ---------------------------------------------------------------------------
+const CAPABILITIES = [
+    // ── Chain / Network ────────────────────────────────────────────────────
+    {
+        id: "mantle_getChainInfo",
+        name: "Get Chain Info",
+        category: "query",
+        mutates: false,
+        auth: "none",
+        summary: "Return static chain configuration (chain ID, WMNT address, RPC URLs).",
+        cli_command: "mantle-cli chain info --json",
+        example: "{ \"network\": \"mainnet\" }",
+        tags: ["chain", "config", "network"]
+    },
+    {
+        id: "mantle_getChainStatus",
+        name: "Get Chain Status",
+        category: "query",
+        mutates: false,
+        auth: "none",
+        summary: "Live chain status: block number, gas price, sync state.",
+        cli_command: "mantle-cli chain status --json",
+        example: "{ \"network\": \"mainnet\" }",
+        tags: ["chain", "status", "gas", "block"]
+    },
+    // ── Account ────────────────────────────────────────────────────────────
+    {
+        id: "mantle_getBalance",
+        name: "Get Native Balance",
+        category: "query",
+        mutates: false,
+        auth: "required",
+        summary: "Read native MNT balance for a wallet address.",
+        cli_command: "mantle-cli account balance <address> --json",
+        example: "{ \"address\": \"0x1234...\" }",
+        tags: ["account", "balance", "MNT", "wallet"]
+    },
+    {
+        id: "mantle_getTokenBalances",
+        name: "Get Token Balances",
+        category: "query",
+        mutates: false,
+        auth: "required",
+        summary: "Batch read ERC-20 token balances for a wallet across specified tokens.",
+        cli_command: "mantle-cli account token-balances <address> --tokens USDC,WMNT --json",
+        example: "{ \"address\": \"0x1234...\", \"tokens\": [\"USDC\", \"WMNT\"] }",
+        tags: ["account", "balance", "token", "ERC-20", "wallet"]
+    },
+    {
+        id: "mantle_getAllowances",
+        name: "Get Allowances",
+        category: "query",
+        mutates: false,
+        auth: "required",
+        summary: "Batch read ERC-20 allowances for token/spender pairs granted by a wallet.",
+        cli_command: "mantle-cli account allowances <owner> --pairs USDC:0x319B... --json",
+        example: "{ \"owner\": \"0x1234...\", \"pairs\": [{\"token\": \"USDC\", \"spender\": \"0x319B69888b0d11cEC22caA5034e25FfFBDc88421\"}] }",
+        tags: ["account", "allowance", "approve", "wallet"]
+    },
+    // ── Token ──────────────────────────────────────────────────────────────
+    {
+        id: "mantle_getTokenInfo",
+        name: "Get Token Info",
+        category: "query",
+        mutates: false,
+        auth: "none",
+        summary: "Read on-chain metadata (name, symbol, decimals, totalSupply) for a token.",
+        cli_command: "mantle-cli token info <token> --json",
+        example: "{ \"token\": \"USDC\" }",
+        tags: ["token", "metadata", "decimals"]
+    },
+    {
+        id: "mantle_getTokenPrices",
+        name: "Get Token Prices",
+        category: "query",
+        mutates: false,
+        auth: "none",
+        summary: "Fetch current USD prices for one or more tokens (DexScreener + DefiLlama).",
+        cli_command: "mantle-cli token prices --tokens WMNT,USDC --json",
+        example: "{ \"tokens\": [\"WMNT\", \"USDC\"] }",
+        tags: ["token", "price", "USD"]
+    },
+    {
+        id: "mantle_resolveToken",
+        name: "Resolve Token",
+        category: "query",
+        mutates: false,
+        auth: "none",
+        summary: "Resolve a token symbol to its address and metadata via quick-reference + token-list cross-check.",
+        cli_command: "mantle-cli token resolve <symbol> --json",
+        example: "{ \"symbol\": \"mETH\" }",
+        tags: ["token", "resolve", "address"]
+    },
+    // ── Registry ───────────────────────────────────────────────────────────
+    {
+        id: "mantle_resolveAddress",
+        name: "Resolve Address",
+        category: "query",
+        mutates: false,
+        auth: "none",
+        summary: "Look up a contract or token by name/alias in the verified registry.",
+        cli_command: "mantle-cli registry resolve <identifier> --json",
+        example: "{ \"identifier\": \"agni_router\" }",
+        tags: ["registry", "address", "resolve", "contract"]
+    },
+    {
+        id: "mantle_validateAddress",
+        name: "Validate Address",
+        category: "query",
+        mutates: false,
+        auth: "none",
+        summary: "Check if an address is a contract, EOA, or undeployed; look up registry label.",
+        cli_command: "mantle-cli registry validate <address> --json",
+        example: "{ \"address\": \"0x1234...\" }",
+        tags: ["registry", "validate", "contract", "EOA"]
+    },
+    // ── DeFi Read ──────────────────────────────────────────────────────────
+    {
+        id: "mantle_getSwapQuote",
+        name: "Get Swap Quote",
+        category: "analyze",
+        mutates: false,
+        auth: "none",
+        summary: "Read swap quote across Agni, Fluxion, and Merchant Moe. Returns estimated output, price impact, and minimum_out_raw for slippage protection.",
+        cli_command: "mantle-cli defi swap-quote --in <token> --out <token> --amount <n> --provider best --json",
+        example: "{ \"token_in\": \"WMNT\", \"token_out\": \"USDC\", \"amount_in\": \"10\", \"provider\": \"best\" }",
+        workflow_before: ["mantle_buildSwap"],
+        tags: ["swap", "quote", "DEX", "price"]
+    },
+    {
+        id: "mantle_getPoolLiquidity",
+        name: "Get Pool Liquidity",
+        category: "query",
+        mutates: false,
+        auth: "none",
+        summary: "Read pool reserves and total liquidity USD for a specific pool address.",
+        cli_command: "mantle-cli defi pool-liquidity <pool-address> --json",
+        example: "{ \"pool_address\": \"0xABC...\", \"provider\": \"agni\" }",
+        tags: ["pool", "liquidity", "reserves", "TVL"]
+    },
+    {
+        id: "mantle_getPoolOpportunities",
+        name: "Get Pool Opportunities",
+        category: "analyze",
+        mutates: false,
+        auth: "none",
+        summary: "Scan and rank candidate pools for a token pair across all Mantle DEXes.",
+        cli_command: "mantle-cli defi pool-opportunities --token-a <token> --token-b <token> --json",
+        example: "{ \"token_a\": \"WMNT\", \"token_b\": \"USDC\" }",
+        tags: ["pool", "opportunity", "LP", "scan", "rank"]
+    },
+    {
+        id: "mantle_getProtocolTvl",
+        name: "Get Protocol TVL",
+        category: "query",
+        mutates: false,
+        auth: "none",
+        summary: "Read protocol-level TVL for Agni, Merchant Moe, or all Mantle DeFi protocols.",
+        cli_command: "mantle-cli defi tvl --json",
+        example: "{ \"protocol\": \"all\" }",
+        tags: ["TVL", "protocol", "DeFi"]
+    },
+    {
+        id: "mantle_getLendingMarkets",
+        name: "Get Lending Markets",
+        category: "query",
+        mutates: false,
+        auth: "none",
+        summary: "Read Aave V3 lending market data: supply APY, borrow APY, TVL, LTV, liquidation threshold.",
+        cli_command: "mantle-cli defi lending-markets --json",
+        example: "{ \"protocol\": \"aave_v3\" }",
+        tags: ["lending", "Aave", "APY", "supply", "borrow"]
+    },
+    {
+        id: "mantle_getLBPairState",
+        name: "Get LB Pair State",
+        category: "query",
+        mutates: false,
+        auth: "none",
+        summary: "Read on-chain state of a Merchant Moe Liquidity Book pair: active bin, reserves, nearby bins.",
+        cli_command: "mantle-cli defi lb-state --token-a <token> --token-b <token> --bin-step <step> --json",
+        example: "{ \"token_a\": \"WMNT\", \"token_b\": \"USDC\", \"bin_step\": 20 }",
+        tags: ["pool", "LB", "Merchant Moe", "bin", "state"]
+    },
+    // ── DeFi LP Read ───────────────────────────────────────────────────────
+    {
+        id: "mantle_getV3PoolState",
+        name: "Get V3 Pool State",
+        category: "query",
+        mutates: false,
+        auth: "none",
+        summary: "Read on-chain state of a Uniswap V3 pool (Agni/Fluxion): sqrtPriceX96, current tick, liquidity, prices.",
+        cli_command: "mantle-cli lp pool-state --token-a <token> --token-b <token> --fee-tier <tier> --provider <dex> --json",
+        example: "{ \"token_a\": \"WMNT\", \"token_b\": \"USDC\", \"fee_tier\": 3000, \"provider\": \"agni\" }",
+        tags: ["pool", "V3", "state", "tick", "price"]
+    },
+    {
+        id: "mantle_getV3Positions",
+        name: "Get V3 Positions",
+        category: "query",
+        mutates: false,
+        auth: "required",
+        summary: "Enumerate all V3 LP positions for a wallet across Agni and Fluxion: tick ranges, liquidity, uncollected fees, in-range status.",
+        cli_command: "mantle-cli lp positions --owner <address> --json",
+        example: "{ \"owner\": \"0x1234...\" }",
+        tags: ["LP", "position", "V3", "NFT", "wallet"]
+    },
+    {
+        id: "mantle_suggestTickRange",
+        name: "Suggest Tick Range",
+        category: "analyze",
+        mutates: false,
+        auth: "none",
+        summary: "Suggest tick ranges (wide/moderate/tight) for a V3 LP position with snapped tick bounds and prices.",
+        cli_command: "mantle-cli lp suggest-ticks --token-a <token> --token-b <token> --fee-tier <tier> --provider <dex> --json",
+        example: "{ \"token_a\": \"WMNT\", \"token_b\": \"USDC\", \"fee_tier\": 3000, \"provider\": \"agni\" }",
+        workflow_before: ["mantle_buildAddLiquidity"],
+        tags: ["LP", "tick", "range", "strategy", "V3"]
+    },
+    {
+        id: "mantle_analyzePool",
+        name: "Analyze Pool",
+        category: "analyze",
+        mutates: false,
+        auth: "none",
+        summary: "Deep pool analysis: fee APR from 24h volume/TVL, multi-range APR comparison, risk scoring (TVL/volatility), and investment return projections.",
+        cli_command: "mantle-cli defi analyze-pool --token-a <token> --token-b <token> --fee-tier <tier> --provider <dex> --investment <usd> --json",
+        example: "{ \"token_a\": \"WMNT\", \"token_b\": \"USDC\", \"fee_tier\": 3000, \"provider\": \"agni\" }",
+        workflow_before: ["mantle_buildAddLiquidity"],
+        tags: ["LP", "APR", "risk", "analysis", "yield", "pool"]
+    },
+    {
+        id: "mantle_findPools",
+        name: "Find Pools",
+        category: "query",
+        mutates: false,
+        auth: "none",
+        summary: "Discover all available pools for a token pair across Agni, Fluxion, and Merchant Moe by querying factory contracts on-chain.",
+        cli_command: "mantle-cli lp find-pools --token-a <token> --token-b <token> --json",
+        example: "{ \"token_a\": \"USDC\", \"token_b\": \"USDe\" }",
+        workflow_before: ["mantle_getV3PoolState", "mantle_analyzePool"],
+        tags: ["pool", "discover", "factory", "all DEX"]
+    },
+    // ── DeFi Write (Transaction Builders) ──────────────────────────────────
+    {
+        id: "mantle_buildApprove",
+        name: "Build Approve",
+        category: "execute",
+        mutates: true,
+        auth: "optional",
+        summary: "Build unsigned ERC-20 approve tx. Pass --owner to auto-skip if allowance is already sufficient.",
+        cli_command: "mantle-cli swap approve --token <token> --spender <address> --amount <n> --owner <address> --json",
+        example: "{ \"token\": \"USDC\", \"spender\": \"0x319B...\", \"amount\": \"100\", \"owner\": \"0x1234...\" }",
+        workflow_before: ["mantle_buildSwap", "mantle_buildAddLiquidity", "mantle_buildAaveSupply"],
+        tags: ["approve", "allowance", "ERC-20", "tx"]
+    },
+    {
+        id: "mantle_buildWrapMnt",
+        name: "Build Wrap MNT",
+        category: "execute",
+        mutates: true,
+        auth: "none",
+        summary: "Build unsigned tx to wrap MNT into WMNT.",
+        cli_command: "mantle-cli swap wrap-mnt --amount <n> --json",
+        example: "{ \"amount\": \"10\" }",
+        tags: ["wrap", "MNT", "WMNT", "tx"]
+    },
+    {
+        id: "mantle_buildUnwrapMnt",
+        name: "Build Unwrap MNT",
+        category: "execute",
+        mutates: true,
+        auth: "none",
+        summary: "Build unsigned tx to unwrap WMNT back to MNT.",
+        cli_command: "mantle-cli swap unwrap-mnt --amount <n> --json",
+        example: "{ \"amount\": \"10\" }",
+        tags: ["unwrap", "MNT", "WMNT", "tx"]
+    },
+    {
+        id: "mantle_buildSwap",
+        name: "Build Swap",
+        category: "execute",
+        mutates: true,
+        auth: "required",
+        summary: "Build unsigned swap tx on a whitelisted DEX. Requires amount_out_min from a prior quote for slippage protection.",
+        cli_command: "mantle-cli swap build-swap --provider <dex> --in <token> --out <token> --amount <n> --recipient <address> --amount-out-min <raw> --json",
+        example: "{ \"provider\": \"agni\", \"token_in\": \"WMNT\", \"token_out\": \"USDC\", \"amount_in\": \"10\", \"recipient\": \"0x1234...\", \"amount_out_min\": \"7500000\" }",
+        workflow_before: [],
+        tags: ["swap", "DEX", "tx"]
+    },
+    {
+        id: "mantle_buildAddLiquidity",
+        name: "Build Add Liquidity",
+        category: "execute",
+        mutates: true,
+        auth: "required",
+        summary: "Build unsigned add-liquidity tx. Supports token amounts, USD amount (--amount-usd), and V3/LB pools.",
+        cli_command: "mantle-cli lp add --provider <dex> --token-a <t> --token-b <t> --amount-a <n> --amount-b <n> --recipient <addr> --json",
+        example: "{ \"provider\": \"agni\", \"token_a\": \"WMNT\", \"token_b\": \"USDC\", \"amount_a\": \"10\", \"amount_b\": \"8\", \"recipient\": \"0x1234...\" }",
+        tags: ["LP", "add", "liquidity", "tx"]
+    },
+    {
+        id: "mantle_buildRemoveLiquidity",
+        name: "Build Remove Liquidity",
+        category: "execute",
+        mutates: true,
+        auth: "required",
+        summary: "Build unsigned remove-liquidity tx. V3: supports --percentage mode. Merchant Moe: remove from specified bins.",
+        cli_command: "mantle-cli lp remove --provider <dex> --token-id <id> --percentage <1-100> --recipient <addr> --json",
+        example: "{ \"provider\": \"agni\", \"token_id\": \"12345\", \"liquidity\": \"1000000\", \"recipient\": \"0x1234...\" }",
+        tags: ["LP", "remove", "liquidity", "tx"]
+    },
+    {
+        id: "mantle_buildCollectFees",
+        name: "Build Collect Fees",
+        category: "execute",
+        mutates: true,
+        auth: "required",
+        summary: "Build unsigned tx to collect accrued fees from a V3 LP position.",
+        cli_command: "mantle-cli lp collect-fees --provider <dex> --token-id <id> --recipient <addr> --json",
+        example: "{ \"provider\": \"agni\", \"token_id\": \"12345\", \"recipient\": \"0x1234...\" }",
+        tags: ["LP", "fees", "collect", "V3", "tx"]
+    },
+    {
+        id: "mantle_buildAaveSupply",
+        name: "Build Aave Supply",
+        category: "execute",
+        mutates: true,
+        auth: "required",
+        summary: "Build unsigned Aave V3 supply (deposit) tx.",
+        cli_command: "mantle-cli aave supply --asset <token> --amount <n> --on-behalf-of <addr> --json",
+        example: "{ \"asset\": \"USDC\", \"amount\": \"100\", \"on_behalf_of\": \"0x1234...\" }",
+        tags: ["Aave", "supply", "deposit", "lending", "tx"]
+    },
+    {
+        id: "mantle_buildAaveBorrow",
+        name: "Build Aave Borrow",
+        category: "execute",
+        mutates: true,
+        auth: "required",
+        summary: "Build unsigned Aave V3 borrow tx. Requires sufficient collateral.",
+        cli_command: "mantle-cli aave borrow --asset <token> --amount <n> --on-behalf-of <addr> --json",
+        example: "{ \"asset\": \"USDC\", \"amount\": \"50\", \"on_behalf_of\": \"0x1234...\" }",
+        tags: ["Aave", "borrow", "lending", "tx"]
+    },
+    {
+        id: "mantle_buildAaveRepay",
+        name: "Build Aave Repay",
+        category: "execute",
+        mutates: true,
+        auth: "required",
+        summary: "Build unsigned Aave V3 repay tx. Use --amount max for full debt repayment.",
+        cli_command: "mantle-cli aave repay --asset <token> --amount <n|max> --on-behalf-of <addr> --json",
+        example: "{ \"asset\": \"USDC\", \"amount\": \"50\", \"on_behalf_of\": \"0x1234...\" }",
+        tags: ["Aave", "repay", "lending", "tx"]
+    },
+    {
+        id: "mantle_buildAaveWithdraw",
+        name: "Build Aave Withdraw",
+        category: "execute",
+        mutates: true,
+        auth: "required",
+        summary: "Build unsigned Aave V3 withdraw tx. Use --amount max for full balance.",
+        cli_command: "mantle-cli aave withdraw --asset <token> --amount <n|max> --to <addr> --json",
+        example: "{ \"asset\": \"USDC\", \"amount\": \"50\", \"to\": \"0x1234...\" }",
+        tags: ["Aave", "withdraw", "lending", "tx"]
+    },
+    {
+        id: "mantle_getSwapPairs",
+        name: "Get Swap Pairs",
+        category: "query",
+        mutates: false,
+        auth: "none",
+        summary: "List known trading pairs and pool parameters for a DEX. Call before buildSwap to get correct fee_tier/bin_step.",
+        cli_command: "mantle-cli swap pairs --json",
+        example: "{ \"provider\": \"agni\" }",
+        workflow_before: ["mantle_buildSwap"],
+        tags: ["swap", "pairs", "DEX", "config"]
+    },
+    // ── Indexer ────────────────────────────────────────────────────────────
+    {
+        id: "mantle_querySubgraph",
+        name: "Query Subgraph",
+        category: "query",
+        mutates: false,
+        auth: "none",
+        summary: "Execute a GraphQL query against a Mantle subgraph endpoint.",
+        cli_command: "mantle-cli indexer subgraph --endpoint <url> --query '<graphql>' --json",
+        example: "{ \"endpoint\": \"https://...\", \"query\": \"{ pools(first:5) { id } }\" }",
+        tags: ["indexer", "subgraph", "GraphQL"]
+    },
+    {
+        id: "mantle_queryIndexerSql",
+        name: "Query Indexer SQL",
+        category: "query",
+        mutates: false,
+        auth: "none",
+        summary: "Execute a read-only SQL query against an indexer endpoint.",
+        cli_command: "mantle-cli indexer sql --endpoint <url> --query '<sql>' --json",
+        example: "{ \"endpoint\": \"https://...\", \"query\": \"SELECT * FROM pools LIMIT 10\" }",
+        tags: ["indexer", "SQL", "query"]
+    },
+    // ── Diagnostics ────────────────────────────────────────────────────────
+    {
+        id: "mantle_checkRpcHealth",
+        name: "Check RPC Health",
+        category: "query",
+        mutates: false,
+        auth: "none",
+        summary: "Health-check the configured RPC endpoint: reachability, chain ID, latency.",
+        cli_command: "mantle-cli diagnostics rpc-health --json",
+        example: "{ \"network\": \"mainnet\" }",
+        tags: ["diagnostics", "RPC", "health"]
+    },
+    {
+        id: "mantle_probeEndpoint",
+        name: "Probe Endpoint",
+        category: "query",
+        mutates: false,
+        auth: "none",
+        summary: "Send an arbitrary allowed RPC call to probe an endpoint.",
+        cli_command: "mantle-cli diagnostics probe --json",
+        example: "{ \"rpc_url\": \"https://...\", \"method\": \"eth_blockNumber\" }",
+        tags: ["diagnostics", "RPC", "probe"]
+    }
+];
+//# sourceMappingURL=capability-catalog.js.map

package/dist/capability-catalog.js.map

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

package/dist/config/aave-reserves.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Aave V3 Mantle reserve assets — hardcoded from the official aave-address-book.
+ *
+ * Source: https://github.com/bgd-labs/aave-address-book/blob/main/src/ts/AaveV3Mantle.ts
+ *
+ * Each entry contains the underlying token, its Aave aToken (deposit receipt),
+ * and variable debt token. Agents can use this registry to:
+ *  - Know which assets are eligible for supply/borrow on Aave V3
+ *  - Resolve aToken/debtToken addresses for portfolio valuation
+ *  - Skip on-chain lookups for known reserves
+ */
+export interface AaveReserveAsset {
+    /** Reserve index in the Aave Pool (0-based). */
+    id: number;
+    /** Human-readable symbol. */
+    symbol: string;
+    /** Underlying ERC-20 token address. */
+    underlying: string;
+    /** aToken address (deposit receipt, balance grows with interest). */
+    aToken: string;
+    /** Variable debt token address (represents outstanding borrow). */
+    variableDebtToken: string;
+    /** Token decimals. */
+    decimals: number;
+    /**
+     * True when supplying this asset as the ONLY collateral puts the user
+     * into Isolation Mode (i.e. the on-chain debt ceiling > 0).
+     */
+    isolationMode: boolean;
+    /**
+     * Max total debt (in whole USD) allowed across ALL users who use this
+     * asset in isolation.  0 = not an isolation-mode asset.
+     * On-chain value (Pool.getConfiguration bits 212-251) has 2 decimal places;
+     * this field is already divided by 100.
+     */
+    debtCeilingUsd: number;
+    /**
+     * True when this asset can be borrowed by a user who is in Isolation
+     * Mode.  Sourced from Pool.getConfiguration() bit 61.
+     */
+    borrowableInIsolation: boolean;
+}
+export declare const AAVE_V3_MANTLE_RESERVES: AaveReserveAsset[];
+/** Find a reserve by symbol (case-insensitive). */
+export declare function findReserveBySymbol(symbol: string): AaveReserveAsset | null;
+/** Find a reserve by underlying token address. */
+export declare function findReserveByUnderlying(address: string): AaveReserveAsset | null;
+/** Check whether a token is a supported Aave V3 reserve on Mantle. */
+export declare function isAaveReserve(symbolOrAddress: string): boolean;
+/** Get all reserve symbols. */
+export declare function aaveReserveSymbols(): string[];
+/** Symbols of reserves whose debtCeiling > 0 (supplying them triggers Isolation Mode). */
+export declare function isolationModeSymbols(): string[];
+/** Symbols of reserves that CAN be borrowed while in Isolation Mode. */
+export declare function isolationBorrowableSymbols(): string[];
+//# sourceMappingURL=aave-reserves.d.ts.map

package/dist/config/aave-reserves.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aave-reserves.d.ts","sourceRoot":"","sources":["../../src/config/aave-reserves.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IAGjB;;;OAGG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB;;;;;OAKG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED,eAAO,MAAM,uBAAuB,EAAE,gBAAgB,EA+GrD,CAAC;AAaF,mDAAmD;AACnD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAE3E;AAED,kDAAkD;AAClD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,GACd,gBAAgB,GAAG,IAAI,CAEzB;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAG9D;AAED,+BAA+B;AAC/B,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C;AAED,0FAA0F;AAC1F,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C;AAED,wEAAwE;AACxE,wBAAgB,0BAA0B,IAAI,MAAM,EAAE,CAErD"}