@0xwh1sker/mantle-cli 0.1.3

package/dist/commands/diagnostics.js

@@ -0,0 +1,76 @@
+import { allTools } from "@0xwh1sker/mantle-core/tools/index.js";
+import { formatKeyValue, formatJson } from "../formatter.js";
+import { parseJsonArray } from "../utils.js";
+export function registerDiagnostics(parent) {
+    const group = parent.command("diagnostics").description("RPC health and probing");
+    group
+        .command("rpc-health")
+        .description("Check RPC endpoint health and chain-id consistency")
+        .option("--rpc-url <url>", "RPC URL to test (defaults to configured endpoint)")
+        .action(async (opts, cmd) => {
+        const globals = cmd.optsWithGlobals();
+        const result = await allTools["mantle_checkRpcHealth"].handler({
+            rpc_url: opts.rpcUrl ?? globals.rpcUrl,
+            network: globals.network
+        });
+        if (globals.json) {
+            formatJson(result);
+        }
+        else {
+            const data = result;
+            formatKeyValue(data, {
+                order: [
+                    "endpoint", "reachable", "chain_id", "chain_id_matches",
+                    "block_number", "latency_ms", "error", "checked_at_utc"
+                ],
+                labels: {
+                    endpoint: "Endpoint",
+                    reachable: "Reachable",
+                    chain_id: "Chain ID",
+                    chain_id_matches: "Chain ID Matches",
+                    block_number: "Block",
+                    latency_ms: "Latency (ms)",
+                    error: "Error",
+                    checked_at_utc: "Checked At"
+                }
+            });
+        }
+    });
+    group
+        .command("probe")
+        .description("Probe a JSON-RPC endpoint with a minimal method call")
+        .option("--rpc-url <url>", "RPC endpoint to probe")
+        .option("--method <method>", "RPC method (eth_chainId, eth_blockNumber, eth_getBalance)", "eth_blockNumber")
+        .option("--params <json>", "optional method params as JSON array")
+        .action(async (opts, cmd) => {
+        const globals = cmd.optsWithGlobals();
+        const params = opts.params
+            ? parseJsonArray(opts.params, "params")
+            : undefined;
+        const result = await allTools["mantle_probeEndpoint"].handler({
+            rpc_url: opts.rpcUrl ?? globals.rpcUrl,
+            method: opts.method,
+            params,
+            network: globals.network
+        });
+        if (globals.json) {
+            formatJson(result);
+        }
+        else {
+            const data = result;
+            formatKeyValue(data, {
+                order: ["endpoint", "method", "success", "result", "error", "latency_ms", "probed_at_utc"],
+                labels: {
+                    endpoint: "Endpoint",
+                    method: "Method",
+                    success: "Success",
+                    result: "Result",
+                    error: "Error",
+                    latency_ms: "Latency (ms)",
+                    probed_at_utc: "Probed At"
+                }
+            });
+        }
+    });
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/commands/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/commands/diagnostics.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,UAAU,mBAAmB,CAAC,MAAe;IACjD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,WAAW,CAAC,wBAAwB,CAAC,CAAC;IAElF,KAAK;SACF,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,oDAAoD,CAAC;SACjE,MAAM,CAAC,iBAAiB,EAAE,mDAAmD,CAAC;SAC9E,MAAM,CAAC,KAAK,EAAE,IAA6B,EAAE,GAAY,EAAE,EAAE;QAC5D,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,uBAAuB,CAAC,CAAC,OAAO,CAAC;YAC7D,OAAO,EAAE,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM;YACtC,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAC;QACH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,UAAU,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,MAAiC,CAAC;YAC/C,cAAc,CAAC,IAAI,EAAE;gBACnB,KAAK,EAAE;oBACL,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,kBAAkB;oBACvD,cAAc,EAAE,YAAY,EAAE,OAAO,EAAE,gBAAgB;iBACxD;gBACD,MAAM,EAAE;oBACN,QAAQ,EAAE,UAAU;oBACpB,SAAS,EAAE,WAAW;oBACtB,QAAQ,EAAE,UAAU;oBACpB,gBAAgB,EAAE,kBAAkB;oBACpC,YAAY,EAAE,OAAO;oBACrB,UAAU,EAAE,cAAc;oBAC1B,KAAK,EAAE,OAAO;oBACd,cAAc,EAAE,YAAY;iBAC7B;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,KAAK;SACF,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,sDAAsD,CAAC;SACnE,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;SAClD,MAAM,CAAC,mBAAmB,EAAE,2DAA2D,EAAE,iBAAiB,CAAC;SAC3G,MAAM,CAAC,iBAAiB,EAAE,sCAAsC,CAAC;SACjE,MAAM,CAAC,KAAK,EAAE,IAA6B,EAAE,GAAY,EAAE,EAAE;QAC5D,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM;YACxB,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,MAAgB,EAAE,QAAQ,CAAC;YACjD,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,sBAAsB,CAAC,CAAC,OAAO,CAAC;YAC5D,OAAO,EAAE,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM;YACtC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM;YACN,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAC;QACH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,UAAU,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,MAAiC,CAAC;YAC/C,cAAc,CAAC,IAAI,EAAE;gBACnB,KAAK,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,eAAe,CAAC;gBAC1F,MAAM,EAAE;oBACN,QAAQ,EAAE,UAAU;oBACpB,MAAM,EAAE,QAAQ;oBAChB,OAAO,EAAE,SAAS;oBAClB,MAAM,EAAE,QAAQ;oBAChB,KAAK,EAAE,OAAO;oBACd,UAAU,EAAE,cAAc;oBAC1B,aAAa,EAAE,WAAW;iBAC3B;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/indexer.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerIndexer(parent: Command): void;
+//# sourceMappingURL=indexer.d.ts.map

package/dist/commands/indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../../src/commands/indexer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAiGrD"}

package/dist/commands/indexer.js

@@ -0,0 +1,92 @@
+import { allTools } from "@0xwh1sker/mantle-core/tools/index.js";
+import { formatTable, formatJson, formatKeyValue } from "../formatter.js";
+import { parseIntegerOption, parseJsonString } from "../utils.js";
+export function registerIndexer(parent) {
+    const group = parent.command("indexer").description("Subgraph and SQL queries");
+    group
+        .command("subgraph")
+        .description("Run GraphQL query against a Mantle indexer")
+        .requiredOption("--endpoint <url>", "GraphQL endpoint URL")
+        .requiredOption("--query <graphql>", "GraphQL query document")
+        .option("--variables <json>", "optional GraphQL variables as JSON string")
+        .option("--timeout <ms>", "request timeout in milliseconds", (value) => parseIntegerOption(value, "--timeout"))
+        .action(async (opts, cmd) => {
+        const globals = cmd.optsWithGlobals();
+        const variables = opts.variables
+            ? parseJsonString(opts.variables, "variables")
+            : undefined;
+        const result = await allTools["mantle_querySubgraph"].handler({
+            endpoint: opts.endpoint,
+            query: opts.query,
+            variables,
+            timeout_ms: opts.timeout,
+            network: globals.network
+        });
+        if (globals.json) {
+            formatJson(result);
+        }
+        else {
+            const data = result;
+            formatKeyValue({
+                endpoint: data.endpoint,
+                queried_at: data.queried_at_utc,
+                elapsed_ms: data.elapsed_ms
+            }, {
+                labels: {
+                    endpoint: "Endpoint",
+                    queried_at: "Queried At",
+                    elapsed_ms: "Elapsed (ms)"
+                }
+            });
+            if (data.errors) {
+                console.log("  Errors:", JSON.stringify(data.errors, null, 2));
+            }
+            if (data.data) {
+                console.log(JSON.stringify(data.data, null, 2));
+            }
+        }
+    });
+    group
+        .command("sql")
+        .description("Run read-only SQL query against an indexer")
+        .requiredOption("--endpoint <url>", "SQL indexer endpoint URL")
+        .requiredOption("--query <sql>", "read-only SQL query")
+        .option("--params <json>", "optional query params as JSON string")
+        .option("--timeout <ms>", "request timeout in milliseconds", (value) => parseIntegerOption(value, "--timeout"))
+        .action(async (opts, cmd) => {
+        const globals = cmd.optsWithGlobals();
+        const params = opts.params
+            ? parseJsonString(opts.params, "params")
+            : undefined;
+        const result = await allTools["mantle_queryIndexerSql"].handler({
+            endpoint: opts.endpoint,
+            query: opts.query,
+            params,
+            timeout_ms: opts.timeout,
+            network: globals.network
+        });
+        if (globals.json) {
+            formatJson(result);
+        }
+        else {
+            const data = result;
+            const columns = (data.columns ?? []);
+            const rows = (data.rows ?? []);
+            console.log(`\n  Endpoint: ${data.endpoint}  Rows: ${data.row_count}  Elapsed: ${data.elapsed_ms}ms\n`);
+            if (rows.length > 0 && columns.length > 0) {
+                const tableRows = rows.map((row) => {
+                    const record = {};
+                    columns.forEach((col, i) => {
+                        record[col] = Array.isArray(row) ? row[i] : row[col];
+                    });
+                    return record;
+                });
+                formatTable(tableRows, columns.map((col) => ({ key: col, label: col })));
+            }
+            if (data.truncated) {
+                console.log("  (Results truncated)");
+            }
+        }
+    });
+}
+//# sourceMappingURL=indexer.js.map

package/dist/commands/indexer.js.map

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

package/dist/commands/registry.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerRegistry(parent: Command): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/commands/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/commands/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAwEtD"}

package/dist/commands/registry.js

@@ -0,0 +1,76 @@
+import { allTools } from "@0xwh1sker/mantle-core/tools/index.js";
+import { formatKeyValue, formatJson } from "../formatter.js";
+export function registerRegistry(parent) {
+    const group = parent.command("registry").description("Address resolution and validation");
+    group
+        .command("resolve")
+        .description("Resolve trusted contract address by key, alias, or label")
+        .argument("<identifier>", "registry key, alias, or label")
+        .option("--category <category>", "filter category (system, token, bridge, defi, any)", "any")
+        .action(async (identifier, opts, cmd) => {
+        const globals = cmd.optsWithGlobals();
+        const result = await allTools["mantle_resolveAddress"].handler({
+            identifier,
+            network: globals.network,
+            category: opts.category
+        });
+        if (globals.json) {
+            formatJson(result);
+        }
+        else {
+            const data = result;
+            formatKeyValue(data, {
+                order: [
+                    "identifier", "network", "address", "label", "category",
+                    "status", "confidence", "aliases", "source_url"
+                ],
+                labels: {
+                    identifier: "Identifier",
+                    network: "Network",
+                    address: "Address",
+                    label: "Label",
+                    category: "Category",
+                    status: "Status",
+                    is_official: "Official",
+                    confidence: "Confidence",
+                    aliases: "Aliases",
+                    source_url: "Source URL"
+                }
+            });
+        }
+    });
+    group
+        .command("validate")
+        .description("Validate address format, checksum, and optional bytecode presence")
+        .argument("<address>", "address to validate")
+        .option("--check-code", "check if deployed bytecode exists", false)
+        .action(async (address, opts, cmd) => {
+        const globals = cmd.optsWithGlobals();
+        const result = await allTools["mantle_validateAddress"].handler({
+            address,
+            check_code: opts.checkCode,
+            network: globals.network
+        });
+        if (globals.json) {
+            formatJson(result);
+        }
+        else {
+            const data = result;
+            formatKeyValue(data, {
+                order: [
+                    "address", "valid_format", "is_checksummed",
+                    "is_zero_address", "has_code", "registry_match"
+                ],
+                labels: {
+                    address: "Address",
+                    valid_format: "Valid Format",
+                    is_checksummed: "Checksummed",
+                    is_zero_address: "Zero Address",
+                    has_code: "Has Code",
+                    registry_match: "Registry Match"
+                }
+            });
+        }
+    });
+}
+//# sourceMappingURL=registry.js.map

package/dist/commands/registry.js.map

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

package/dist/commands/token.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerToken(parent: Command): void;
+//# sourceMappingURL=token.d.ts.map

package/dist/commands/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../src/commands/token.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CA+FnD"}

package/dist/commands/token.js

@@ -0,0 +1,100 @@
+import { allTools } from "@0xwh1sker/mantle-core/tools/index.js";
+import { formatKeyValue, formatTable, formatJson } from "../formatter.js";
+import { parseCommaList } from "../utils.js";
+export function registerToken(parent) {
+    const group = parent.command("token").description("Token metadata and resolution");
+    group
+        .command("info")
+        .description("Read ERC-20 token metadata (name, symbol, decimals, total supply)")
+        .argument("<token>", "token symbol or address")
+        .action(async (token, _opts, cmd) => {
+        const globals = cmd.optsWithGlobals();
+        const result = await allTools["mantle_getTokenInfo"].handler({
+            token,
+            network: globals.network
+        });
+        if (globals.json) {
+            formatJson(result);
+        }
+        else {
+            const data = result;
+            formatKeyValue(data, {
+                order: ["name", "symbol", "address", "decimals", "total_supply_normalized", "network", "collected_at_utc"],
+                labels: {
+                    name: "Name",
+                    symbol: "Symbol",
+                    address: "Address",
+                    decimals: "Decimals",
+                    total_supply_normalized: "Total Supply",
+                    network: "Network",
+                    collected_at_utc: "Collected At"
+                }
+            });
+        }
+    });
+    group
+        .command("prices")
+        .description("Read token prices for valuation (null when no trusted source)")
+        .requiredOption("--tokens <tokens>", "comma-separated token symbols or addresses")
+        .option("--base-currency <currency>", "quote currency (usd, mnt)", "usd")
+        .action(async (opts, cmd) => {
+        const globals = cmd.optsWithGlobals();
+        const tokens = parseCommaList(opts.tokens);
+        const result = await allTools["mantle_getTokenPrices"].handler({
+            tokens,
+            base_currency: opts.baseCurrency,
+            network: globals.network
+        });
+        if (globals.json) {
+            formatJson(result);
+        }
+        else {
+            const data = result;
+            const prices = (data.prices ?? []);
+            formatTable(prices, [
+                { key: "symbol", label: "Token" },
+                {
+                    key: "price",
+                    label: `Price (${data.base_currency.toUpperCase()})`,
+                    align: "right",
+                    format: (v) => (v === null ? "N/A" : String(v))
+                },
+                { key: "source", label: "Source" },
+                { key: "confidence", label: "Confidence" }
+            ]);
+        }
+    });
+    group
+        .command("resolve")
+        .description("Resolve token symbol via quick-ref + canonical token-list check")
+        .argument("<symbol>", "token symbol to resolve")
+        .option("--no-token-list-check", "skip canonical token-list match requirement")
+        .action(async (symbol, opts, cmd) => {
+        const globals = cmd.optsWithGlobals();
+        const result = await allTools["mantle_resolveToken"].handler({
+            symbol,
+            network: globals.network,
+            require_token_list_match: opts.tokenListCheck !== false
+        });
+        if (globals.json) {
+            formatJson(result);
+        }
+        else {
+            const data = result;
+            formatKeyValue(data, {
+                order: ["symbol", "address", "decimals", "source", "confidence", "token_list_match", "network"],
+                labels: {
+                    symbol: "Symbol",
+                    address: "Address",
+                    decimals: "Decimals",
+                    source: "Source",
+                    confidence: "Confidence",
+                    token_list_match: "Token List Match",
+                    token_list_version: "Token List Version",
+                    network: "Network"
+                }
+            });
+        }
+    });
+}
+//# sourceMappingURL=token.js.map

package/dist/commands/token.js.map

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

package/dist/formatter.d.ts

@@ -0,0 +1,20 @@
+export interface KeyValueOptions {
+    labels?: Record<string, string>;
+    order?: string[];
+}
+export declare function formatKeyValue(data: Record<string, unknown>, options?: KeyValueOptions): void;
+export interface TableColumn {
+    key: string;
+    label: string;
+    align?: "left" | "right";
+    format?: (value: unknown) => string;
+}
+export declare function formatTable(rows: Record<string, unknown>[], columns: TableColumn[]): void;
+export declare function formatJson(data: unknown): void;
+export declare function formatError(error: {
+    code?: string;
+    message: string;
+    suggestion?: string;
+}): void;
+export declare function disableColors(): void;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../src/formatter.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AA6BD,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE,eAAoB,GAC5B,IAAI,CAiBN;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;CACrC;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,CAsCzF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAE9C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,IAAI,CASP;AAED,wBAAgB,aAAa,IAAI,IAAI,CAEpC"}

package/dist/formatter.js

@@ -0,0 +1,98 @@
+import chalk from "chalk";
+function getLabelWidth(entries) {
+    return Math.max(...entries.map(([label]) => label.length), 0);
+}
+function formatValue(value) {
+    if (value === null || value === undefined) {
+        return chalk.dim("null");
+    }
+    if (typeof value === "boolean") {
+        return value ? chalk.green("true") : chalk.red("false");
+    }
+    if (typeof value === "number") {
+        return chalk.cyan(String(value));
+    }
+    if (typeof value === "string") {
+        if (/^0x[a-fA-F0-9]{40}$/.test(value)) {
+            return chalk.yellow(value);
+        }
+        return value;
+    }
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return chalk.dim("[]");
+        return value.map((item) => formatValue(item)).join(", ");
+    }
+    return JSON.stringify(value);
+}
+export function formatKeyValue(data, options = {}) {
+    const { labels = {}, order } = options;
+    const keys = order ?? Object.keys(data);
+    const entries = [];
+    for (const key of keys) {
+        if (!(key in data))
+            continue;
+        const label = labels[key] ?? key;
+        entries.push([label, formatValue(data[key])]);
+    }
+    const width = getLabelWidth(entries);
+    console.log();
+    for (const [label, value] of entries) {
+        console.log(`  ${chalk.bold(label.padEnd(width))}   ${value}`);
+    }
+    console.log();
+}
+export function formatTable(rows, columns) {
+    if (rows.length === 0) {
+        console.log(chalk.dim("\n  No results.\n"));
+        return;
+    }
+    const widths = columns.map((col) => {
+        const headerWidth = col.label.length;
+        const maxDataWidth = Math.max(...rows.map((row) => {
+            const formatted = col.format ? col.format(row[col.key]) : formatValue(row[col.key]);
+            return stripAnsi(formatted).length;
+        }), 0);
+        return Math.max(headerWidth, maxDataWidth);
+    });
+    const header = columns
+        .map((col, i) => chalk.bold(col.label.padEnd(widths[i])))
+        .join("   ");
+    console.log(`\n  ${header}`);
+    for (const row of rows) {
+        const line = columns
+            .map((col, i) => {
+            const raw = col.format ? col.format(row[col.key]) : formatValue(row[col.key]);
+            const stripped = stripAnsi(raw);
+            const padding = widths[i] - stripped.length;
+            if (col.align === "right") {
+                return " ".repeat(Math.max(padding, 0)) + raw;
+            }
+            return raw + " ".repeat(Math.max(padding, 0));
+        })
+            .join("   ");
+        console.log(`  ${line}`);
+    }
+    console.log();
+}
+export function formatJson(data) {
+    console.log(JSON.stringify(data, null, 2));
+}
+export function formatError(error) {
+    console.error(chalk.red(`\nError: ${error.message}`));
+    if (error.code) {
+        console.error(chalk.dim(`Code: ${error.code}`));
+    }
+    if (error.suggestion) {
+        console.error(chalk.yellow(`Suggestion: ${error.suggestion}`));
+    }
+    console.error();
+}
+export function disableColors() {
+    chalk.level = 0;
+}
+function stripAnsi(str) {
+    // eslint-disable-next-line no-control-regex
+    return str.replace(/\x1B\[[0-9;]*m/g, "");
+}
+//# sourceMappingURL=formatter.js.map

package/dist/formatter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { Command } from "commander";
+import { MantleMcpError } from "@0xwh1sker/mantle-core/errors.js";
+import { disableColors, formatError, formatJson } from "./formatter.js";
+import { applyRpcOverride } from "./utils.js";
+import { registerChain } from "./commands/chain.js";
+import { registerRegistry } from "./commands/registry.js";
+import { registerAccount } from "./commands/account.js";
+import { registerToken } from "./commands/token.js";
+import { registerDefi } from "./commands/defi.js";
+import { registerSwap } from "./commands/defi-swap.js";
+import { registerAave } from "./commands/defi-aave.js";
+import { registerLp } from "./commands/defi-lp.js";
+import { registerIndexer } from "./commands/indexer.js";
+import { registerDiagnostics } from "./commands/diagnostics.js";
+import { registerCatalog } from "./commands/catalog.js";
+const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
+const program = new Command();
+program
+    .name("mantle-cli")
+    .description("CLI for Mantle L2 chain reads, DeFi queries, swaps, LP, and Aave operations")
+    .version(pkg.version)
+    .option("-n, --network <network>", "target network (mainnet, sepolia)", "mainnet")
+    .option("--json", "output raw JSON", false)
+    .option("--no-color", "disable colored output")
+    .option("--rpc-url <url>", "override RPC endpoint")
+    .hook("preAction", (thisCommand) => {
+    const opts = thisCommand.opts();
+    if (opts.color === false) {
+        disableColors();
+    }
+    applyRpcOverride(opts.rpcUrl, opts.network);
+});
+registerChain(program);
+registerRegistry(program);
+registerAccount(program);
+registerToken(program);
+registerDefi(program);
+registerSwap(program);
+registerAave(program);
+registerLp(program);
+registerIndexer(program);
+registerDiagnostics(program);
+registerCatalog(program);
+program.parseAsync(process.argv).catch((error) => {
+    const globals = program.opts();
+    if (error instanceof MantleMcpError) {
+        if (globals.json) {
+            formatJson({
+                error: true,
+                code: error.code,
+                message: error.message,
+                suggestion: error.suggestion,
+                details: error.details
+            });
+        }
+        else {
+            formatError({ code: error.code, message: error.message, suggestion: error.suggestion });
+        }
+        process.exit(1);
+    }
+    if (globals.json) {
+        formatJson({
+            error: true,
+            code: "INTERNAL_ERROR",
+            message: error instanceof Error ? error.message : String(error),
+            suggestion: "Retry the operation or check server logs."
+        });
+    }
+    else {
+        formatError({ message: error instanceof Error ? error.message : String(error) });
+    }
+    process.exit(2);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CACnE,CAAC;AAEF,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,6EAA6E,CAAC;KAC1F,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;KACpB,MAAM,CAAC,yBAAyB,EAAE,mCAAmC,EAAE,SAAS,CAAC;KACjF,MAAM,CAAC,QAAQ,EAAE,iBAAiB,EAAE,KAAK,CAAC;KAC1C,MAAM,CAAC,YAAY,EAAE,wBAAwB,CAAC;KAC9C,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;KAClD,IAAI,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,EAAE;IACjC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;QACzB,aAAa,EAAE,CAAC;IAClB,CAAC;IACD,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC;AAEL,aAAa,CAAC,OAAO,CAAC,CAAC;AACvB,gBAAgB,CAAC,OAAO,CAAC,CAAC;AAC1B,eAAe,CAAC,OAAO,CAAC,CAAC;AACzB,aAAa,CAAC,OAAO,CAAC,CAAC;AACvB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,UAAU,CAAC,OAAO,CAAC,CAAC;AACpB,eAAe,CAAC,OAAO,CAAC,CAAC;AACzB,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,eAAe,CAAC,OAAO,CAAC,CAAC;AAEzB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QACpC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,UAAU,CAAC;gBACT,KAAK,EAAE,IAAI;gBACX,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QAC1F,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,UAAU,CAAC;YACT,KAAK,EAAE,IAAI;YACX,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;YAC/D,UAAU,EAAE,2CAA2C;SACxD,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,WAAW,CAAC,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,7 @@
+export declare function parseCommaList(value: string): string[];
+export declare function parseJsonString(value: string, fieldName: string): Record<string, unknown>;
+export declare function applyRpcOverride(rpcUrl: string | undefined, network: string): void;
+export declare function parseJsonArray(value: string, fieldName: string): unknown[];
+export declare function parseIntegerOption(value: string, optionName: string): number;
+export declare function parseNumberOption(value: string, optionName: string): number;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAGA,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAKtD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAezF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAOlF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE,CAe1E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAW5E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAO3E"}