@openscan/cli 0.0.1-alpha

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Openscan
+
+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/dist/bin.d.ts

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

package/dist/bin.d.ts.map

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

package/dist/bin.js

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+import { defineCommand, runMain } from "citty";
+import { CommandRegistry } from "./registry.js";
+import { txHistoryCommand } from "./commands/algo/txHistory.js";
+import { gasPriceCommand } from "./commands/algo/gasPrice.js";
+import { tokenBalanceCommand } from "./commands/algo/tokenBalance.js";
+import { addressTypeCommand } from "./commands/util/addressType.js";
+import { decodeInputCommand } from "./commands/util/decodeInput.js";
+import { balanceCommand } from "./commands/util/balance.js";
+import { formatOutput } from "./output/formatters.js";
+import { resolveRpcUrls } from "./rpc/resolve.js";
+// Initialize command registry
+const registry = new CommandRegistry();
+registry.register(txHistoryCommand);
+registry.register(gasPriceCommand);
+registry.register(tokenBalanceCommand);
+registry.register(addressTypeCommand);
+registry.register(decodeInputCommand);
+registry.register(balanceCommand);
+const main = defineCommand({
+    meta: {
+        name: "openscan",
+        version: "0.1.0",
+        description: "OpenScan CLI - On-chain blockchain analysis tools",
+    },
+    args: {
+        command: {
+            type: "positional",
+            description: "Command to execute (e.g., algo:tx-history, util:balance)",
+            required: true,
+        },
+        args: {
+            type: "positional",
+            description: "Command arguments",
+            required: false,
+        },
+        chain: {
+            type: "string",
+            description: "Chain ID (default: 1)",
+            default: "1",
+        },
+        rpc: {
+            type: "string",
+            description: "RPC URL(s), comma-separated (auto-resolved from public RPCs if omitted)",
+        },
+        "alchemy-key": {
+            type: "string",
+            description: "Alchemy API key (or set ALCHEMY_API_KEY env var)",
+        },
+        output: {
+            type: "string",
+            description: "Output format: json, table, stream",
+            default: "json",
+        },
+        strategy: {
+            type: "string",
+            description: "RPC strategy: fallback, parallel, race",
+            default: "fallback",
+        },
+        verbose: {
+            type: "boolean",
+            description: "Verbose output",
+            default: false,
+        },
+        // Command-specific flags
+        "from-block": { type: "string", description: "Start block" },
+        "to-block": { type: "string", description: "End block" },
+        "page-size": { type: "string", description: "Results per page" },
+        "token-address": { type: "string", alias: "t", description: "Token contract address" },
+        abi: { type: "string", description: "Path to ABI JSON file" },
+        granularity: { type: "string", description: "Data granularity" },
+    },
+    async run({ args }) {
+        const commandName = args.command;
+        const command = registry.get(commandName);
+        if (!command) {
+            console.error(`Unknown command: ${commandName}`);
+            console.error(`\nAvailable commands:`);
+            for (const cmd of registry.list()) {
+                console.error(`  ${cmd.name.padEnd(25)} ${cmd.description}`);
+            }
+            process.exit(1);
+        }
+        const chainId = Number.isNaN(Number(args.chain)) ? args.chain : Number(args.chain);
+        const alchemyKey = args["alchemy-key"] || process.env.ALCHEMY_API_KEY;
+        let rpcUrls;
+        try {
+            rpcUrls = resolveRpcUrls({ chainId, rpcFlag: args.rpc, alchemyKey });
+        }
+        catch (err) {
+            console.error(`Error: ${err.message}`);
+            process.exit(1);
+        }
+        const ctx = {
+            chainId,
+            rpcUrls,
+            outputFormat: args.output,
+            strategyType: args.strategy,
+            verbose: args.verbose,
+        };
+        // Build command args from positional args and flags
+        const commandArgs = {};
+        // First positional arg after command name
+        if (args.args) {
+            const firstArg = command.args[0];
+            if (firstArg) {
+                commandArgs[firstArg.name] = args.args;
+            }
+        }
+        // Copy relevant flags
+        if (args["from-block"])
+            commandArgs["from-block"] = args["from-block"];
+        if (args["to-block"])
+            commandArgs["to-block"] = args["to-block"];
+        if (args["page-size"])
+            commandArgs["page-size"] = Number(args["page-size"]);
+        if (args["token-address"])
+            commandArgs["token-address"] = args["token-address"];
+        if (args.abi)
+            commandArgs.abi = args.abi;
+        if (args.granularity)
+            commandArgs.granularity = args.granularity;
+        // For commands that take data as first arg
+        if (commandName === "util:decode-input" && args.args) {
+            commandArgs.data = args.args;
+        }
+        const result = await registry.execute(commandName, commandArgs, ctx);
+        const output = formatOutput(result, ctx.outputFormat);
+        if (output) {
+            console.log(output);
+        }
+        process.exit(result.exitCode);
+    },
+});
+runMain(main);
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

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

package/dist/commands/algo/gasPrice.d.ts

@@ -0,0 +1,5 @@
+import type { CommandDefinition, CommandHandler } from "../../types.js";
+declare const handler: CommandHandler;
+export declare const gasPriceCommand: CommandDefinition;
+export { handler as gasPriceHandler };
+//# sourceMappingURL=gasPrice.d.ts.map

package/dist/commands/algo/gasPrice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gasPrice.d.ts","sourceRoot":"","sources":["../../../src/commands/algo/gasPrice.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAExE,QAAA,MAAM,OAAO,EAAE,cAgBd,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,iBAc7B,CAAC;AAEF,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,CAAC"}

package/dist/commands/algo/gasPrice.js

@@ -0,0 +1,34 @@
+import { GasPriceHistoryAlgorithm } from "@openscan/algorithms";
+const handler = async (args, ctx) => {
+    const algo = new GasPriceHistoryAlgorithm();
+    const result = await algo.execute({
+        chainId: ctx.chainId,
+        rpcUrls: ctx.rpcUrls,
+        strategyType: ctx.strategyType,
+        targetBlock: args["target-block"],
+        granularity: args.granularity,
+    });
+    return {
+        exitCode: result.success ? 0 : 1,
+        data: result.data,
+        error: result.error,
+        metadata: result.metadata,
+    };
+};
+export const gasPriceCommand = {
+    name: "algo:gas-price",
+    description: "Get gas price history for a network",
+    args: [],
+    flags: [
+        { name: "target-block", description: "Block number to sample back to", type: "number" },
+        {
+            name: "granularity",
+            description: "Data granularity: block, hour, day",
+            type: "string",
+            default: "block",
+        },
+    ],
+    handler,
+};
+export { handler as gasPriceHandler };
+//# sourceMappingURL=gasPrice.js.map

package/dist/commands/algo/gasPrice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gasPrice.js","sourceRoot":"","sources":["../../../src/commands/algo/gasPrice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAGhE,MAAM,OAAO,GAAmB,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IAClD,MAAM,IAAI,GAAG,IAAI,wBAAwB,EAAE,CAAC;IAC5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;QAChC,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,WAAW,EAAE,IAAI,CAAC,cAAc,CAAuB;QACvD,WAAW,EAAE,IAAI,CAAC,WAAmD;KACtE,CAAC,CAAC;IAEH,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAsB;IAChD,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,qCAAqC;IAClD,IAAI,EAAE,EAAE;IACR,KAAK,EAAE;QACL,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,gCAAgC,EAAE,IAAI,EAAE,QAAQ,EAAE;QACvF;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,oCAAoC;YACjD,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,OAAO;SACjB;KACF;IACD,OAAO;CACR,CAAC;AAEF,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,CAAC"}

package/dist/commands/algo/tokenBalance.d.ts

@@ -0,0 +1,5 @@
+import type { CommandDefinition, CommandHandler } from "../../types.js";
+declare const handler: CommandHandler;
+export declare const tokenBalanceCommand: CommandDefinition;
+export { handler as tokenBalanceHandler };
+//# sourceMappingURL=tokenBalance.d.ts.map

package/dist/commands/algo/tokenBalance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenBalance.d.ts","sourceRoot":"","sources":["../../../src/commands/algo/tokenBalance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAExE,QAAA,MAAM,OAAO,EAAE,cAqBd,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,iBAgBjC,CAAC;AAEF,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,CAAC"}

package/dist/commands/algo/tokenBalance.js

@@ -0,0 +1,41 @@
+import { TokenBalanceHistoryAlgorithm } from "@openscan/algorithms";
+const handler = async (args, ctx) => {
+    const algo = new TokenBalanceHistoryAlgorithm();
+    const result = await algo.execute({
+        address: args.address,
+        tokenAddress: args["token-address"],
+        chainId: ctx.chainId,
+        rpcUrls: ctx.rpcUrls,
+        strategyType: ctx.strategyType,
+        pagination: {
+            fromBlock: args["from-block"],
+            toBlock: args["to-block"],
+            pageSize: args["page-size"],
+        },
+    });
+    return {
+        exitCode: result.success ? 0 : 1,
+        data: result.data,
+        error: result.error,
+        metadata: result.metadata,
+    };
+};
+export const tokenBalanceCommand = {
+    name: "algo:token-balance",
+    description: "Track ERC-20 token balance history for an address",
+    args: [{ name: "address", description: "Target address", required: true, type: "string" }],
+    flags: [
+        {
+            name: "token-address",
+            alias: "t",
+            description: "ERC-20 token contract address (required)",
+            type: "string",
+        },
+        { name: "from-block", description: "Start block", type: "string" },
+        { name: "to-block", description: "End block", type: "string" },
+        { name: "page-size", description: "Results per page", type: "number", default: 100 },
+    ],
+    handler,
+};
+export { handler as tokenBalanceHandler };
+//# sourceMappingURL=tokenBalance.js.map

package/dist/commands/algo/tokenBalance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenBalance.js","sourceRoot":"","sources":["../../../src/commands/algo/tokenBalance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAGpE,MAAM,OAAO,GAAmB,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IAClD,MAAM,IAAI,GAAG,IAAI,4BAA4B,EAAE,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;QAChC,OAAO,EAAE,IAAI,CAAC,OAAiB;QAC/B,YAAY,EAAE,IAAI,CAAC,eAAe,CAAW;QAC7C,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,UAAU,EAAE;YACV,SAAS,EAAE,IAAI,CAAC,YAAY,CAAuB;YACnD,OAAO,EAAE,IAAI,CAAC,UAAU,CAAuB;YAC/C,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAuB;SAClD;KACF,CAAC,CAAC;IAEH,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAsB;IACpD,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,mDAAmD;IAChE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC1F,KAAK,EAAE;QACL;YACE,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE,GAAG;YACV,WAAW,EAAE,0CAA0C;YACvD,IAAI,EAAE,QAAQ;SACf;QACD,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE;QAClE,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9D,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE;KACrF;IACD,OAAO;CACR,CAAC;AAEF,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,CAAC"}

package/dist/commands/algo/txHistory.d.ts

@@ -0,0 +1,5 @@
+import type { CommandDefinition, CommandHandler } from "../../types.js";
+declare const handler: CommandHandler;
+export declare const txHistoryCommand: CommandDefinition;
+export { handler as txHistoryHandler };
+//# sourceMappingURL=txHistory.d.ts.map

package/dist/commands/algo/txHistory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"txHistory.d.ts","sourceRoot":"","sources":["../../../src/commands/algo/txHistory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAExE,QAAA,MAAM,OAAO,EAAE,cAoBd,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,iBAU9B,CAAC;AAEF,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/commands/algo/txHistory.js

@@ -0,0 +1,34 @@
+import { TransactionHistoryAlgorithm } from "@openscan/algorithms";
+const handler = async (args, ctx) => {
+    const algo = new TransactionHistoryAlgorithm();
+    const result = await algo.execute({
+        address: args.address,
+        chainId: ctx.chainId,
+        rpcUrls: ctx.rpcUrls,
+        strategyType: ctx.strategyType,
+        pagination: {
+            fromBlock: args["from-block"],
+            toBlock: args["to-block"],
+            pageSize: args["page-size"],
+        },
+    });
+    return {
+        exitCode: result.success ? 0 : 1,
+        data: result.data,
+        error: result.error,
+        metadata: result.metadata,
+    };
+};
+export const txHistoryCommand = {
+    name: "algo:tx-history",
+    description: "Get transaction history for an address",
+    args: [{ name: "address", description: "Target address", required: true, type: "string" }],
+    flags: [
+        { name: "from-block", description: "Start block", type: "string" },
+        { name: "to-block", description: "End block", type: "string" },
+        { name: "page-size", description: "Results per page", type: "number", default: 100 },
+    ],
+    handler,
+};
+export { handler as txHistoryHandler };
+//# sourceMappingURL=txHistory.js.map

package/dist/commands/algo/txHistory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"txHistory.js","sourceRoot":"","sources":["../../../src/commands/algo/txHistory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AAGnE,MAAM,OAAO,GAAmB,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IAClD,MAAM,IAAI,GAAG,IAAI,2BAA2B,EAAE,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;QAChC,OAAO,EAAE,IAAI,CAAC,OAAiB;QAC/B,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,UAAU,EAAE;YACV,SAAS,EAAE,IAAI,CAAC,YAAY,CAAuB;YACnD,OAAO,EAAE,IAAI,CAAC,UAAU,CAAuB;YAC/C,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAuB;SAClD;KACF,CAAC,CAAC;IAEH,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IACjD,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,wCAAwC;IACrD,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC1F,KAAK,EAAE;QACL,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE;QAClE,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9D,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE;KACrF;IACD,OAAO;CACR,CAAC;AAEF,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/commands/util/addressType.d.ts

@@ -0,0 +1,5 @@
+import type { CommandDefinition, CommandHandler } from "../../types.js";
+declare const handler: CommandHandler;
+export declare const addressTypeCommand: CommandDefinition;
+export { handler as addressTypeHandler };
+//# sourceMappingURL=addressType.d.ts.map

package/dist/commands/util/addressType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addressType.d.ts","sourceRoot":"","sources":["../../../src/commands/util/addressType.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAExE,QAAA,MAAM,OAAO,EAAE,cAgCd,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,iBAMhC,CAAC;AAEF,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,CAAC"}

package/dist/commands/util/addressType.js

@@ -0,0 +1,42 @@
+import { validateAddress, detectAddressType } from "@openscan/utils";
+const handler = async (args, ctx) => {
+    const address = args.address;
+    const info = validateAddress(address);
+    if (!info.isValid) {
+        return {
+            exitCode: 1,
+            error: { code: "INVALID_ADDRESS", message: `Invalid address: ${address}` },
+        };
+    }
+    // If chain ID is provided, try to detect EOA vs contract
+    if (ctx.rpcUrls.length > 0) {
+        try {
+            const nc = await import("@openscan/network-connectors");
+            const config = {
+                type: ctx.strategyType,
+                rpcUrls: ctx.rpcUrls,
+            };
+            const client = nc.ClientFactory.createClient(ctx.chainId, config);
+            try {
+                const fullInfo = await detectAddressType(address, client);
+                return { exitCode: 0, data: fullInfo };
+            }
+            finally {
+                await client.close();
+            }
+        }
+        catch {
+            // Fall through to return basic validation info
+        }
+    }
+    return { exitCode: 0, data: info };
+};
+export const addressTypeCommand = {
+    name: "util:address-type",
+    description: "Detect address type (EOA/contract)",
+    args: [{ name: "address", description: "Address to check", required: true, type: "string" }],
+    flags: [],
+    handler,
+};
+export { handler as addressTypeHandler };
+//# sourceMappingURL=addressType.js.map

package/dist/commands/util/addressType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addressType.js","sourceRoot":"","sources":["../../../src/commands/util/addressType.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAIrE,MAAM,OAAO,GAAmB,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAiB,CAAC;IACvC,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAEtC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO;YACL,QAAQ,EAAE,CAAC;YACX,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,oBAAoB,OAAO,EAAE,EAAE;SAC3E,CAAC;IACJ,CAAC;IAED,yDAAyD;IACzD,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,8BAA8B,CAAC,CAAC;YACxD,MAAM,MAAM,GAAG;gBACb,IAAI,EAAE,GAAG,CAAC,YAAgD;gBAC1D,OAAO,EAAE,GAAG,CAAC,OAAO;aACrB,CAAC;YACF,MAAM,MAAM,GAAG,EAAE,CAAC,aAAa,CAAC,YAAY,CAAC,GAAG,CAAC,OAA2B,EAAE,MAAM,CAAC,CAAC;YACtF,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC1D,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YACzC,CAAC;oBAAS,CAAC;gBACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACvB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,+CAA+C;QACjD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACrC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAsB;IACnD,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,oCAAoC;IACjD,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC5F,KAAK,EAAE,EAAE;IACT,OAAO;CACR,CAAC;AAEF,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,CAAC"}

package/dist/commands/util/balance.d.ts

@@ -0,0 +1,5 @@
+import type { CommandDefinition, CommandHandler } from "../../types.js";
+declare const handler: CommandHandler;
+export declare const balanceCommand: CommandDefinition;
+export { handler as balanceHandler };
+//# sourceMappingURL=balance.d.ts.map

package/dist/commands/util/balance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance.d.ts","sourceRoot":"","sources":["../../../src/commands/util/balance.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAExE,QAAA,MAAM,OAAO,EAAE,cAqDd,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,iBAM5B,CAAC;AAEF,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,CAAC"}

package/dist/commands/util/balance.js

@@ -0,0 +1,58 @@
+import { weiToEther, validateAddress } from "@openscan/utils";
+const handler = async (args, ctx) => {
+    const address = args.address;
+    const info = validateAddress(address);
+    if (!info.isValid) {
+        return {
+            exitCode: 1,
+            error: { code: "INVALID_ADDRESS", message: `Invalid address: ${address}` },
+        };
+    }
+    if (ctx.rpcUrls.length === 0) {
+        return {
+            exitCode: 1,
+            error: { code: "NO_RPC", message: "At least one RPC URL is required" },
+        };
+    }
+    const nc = await import("@openscan/network-connectors");
+    const config = {
+        type: ctx.strategyType,
+        rpcUrls: ctx.rpcUrls,
+    };
+    const client = nc.ClientFactory.createClient(ctx.chainId, config);
+    try {
+        const result = await client.execute("eth_getBalance", [address, "latest"]);
+        if (!result.success || !result.data) {
+            return {
+                exitCode: 1,
+                error: {
+                    code: "RPC_ERROR",
+                    message: result.errors?.[0]?.error ?? "Failed to get balance",
+                },
+            };
+        }
+        const balanceWei = result.data;
+        const balanceEther = weiToEther(BigInt(balanceWei));
+        return {
+            exitCode: 0,
+            data: {
+                address,
+                balanceWei,
+                balanceEther,
+                chainId: ctx.chainId,
+            },
+        };
+    }
+    finally {
+        await client.close();
+    }
+};
+export const balanceCommand = {
+    name: "util:balance",
+    description: "Get native token balance for an address",
+    args: [{ name: "address", description: "Address to check", required: true, type: "string" }],
+    flags: [],
+    handler,
+};
+export { handler as balanceHandler };
+//# sourceMappingURL=balance.js.map

package/dist/commands/util/balance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance.js","sourceRoot":"","sources":["../../../src/commands/util/balance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAI9D,MAAM,OAAO,GAAmB,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAiB,CAAC;IACvC,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAEtC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO;YACL,QAAQ,EAAE,CAAC;YACX,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,oBAAoB,OAAO,EAAE,EAAE;SAC3E,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO;YACL,QAAQ,EAAE,CAAC;YACX,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kCAAkC,EAAE;SACvE,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,8BAA8B,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG;QACb,IAAI,EAAE,GAAG,CAAC,YAAgD;QAC1D,OAAO,EAAE,GAAG,CAAC,OAAO;KACrB,CAAC;IACF,MAAM,MAAM,GAAG,EAAE,CAAC,aAAa,CAAC,YAAY,CAAC,GAAG,CAAC,OAA2B,EAAE,MAAM,CAAC,CAAC;IAEtF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAS,gBAAgB,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAEnF,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACpC,OAAO;gBACL,QAAQ,EAAE,CAAC;gBACX,KAAK,EAAE;oBACL,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,uBAAuB;iBAC9D;aACF,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC;QAC/B,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;QAEpD,OAAO;YACL,QAAQ,EAAE,CAAC;YACX,IAAI,EAAE;gBACJ,OAAO;gBACP,UAAU;gBACV,YAAY;gBACZ,OAAO,EAAE,GAAG,CAAC,OAAO;aACrB;SACF,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,yCAAyC;IACtD,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC5F,KAAK,EAAE,EAAE;IACT,OAAO;CACR,CAAC;AAEF,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,CAAC"}

package/dist/commands/util/decodeInput.d.ts

@@ -0,0 +1,5 @@
+import type { CommandDefinition, CommandHandler } from "../../types.js";
+declare const handler: CommandHandler;
+export declare const decodeInputCommand: CommandDefinition;
+export { handler as decodeInputHandler };
+//# sourceMappingURL=decodeInput.d.ts.map

package/dist/commands/util/decodeInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decodeInput.d.ts","sourceRoot":"","sources":["../../../src/commands/util/decodeInput.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAExE,QAAA,MAAM,OAAO,EAAE,cAad,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,iBAahC,CAAC;AAEF,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,CAAC"}

package/dist/commands/util/decodeInput.js

@@ -0,0 +1,28 @@
+import { decodeTxInput } from "@openscan/utils";
+const handler = async (args) => {
+    const data = args.data;
+    if (!data || !data.startsWith("0x")) {
+        return {
+            exitCode: 1,
+            error: { code: "INVALID_INPUT", message: "Data must be a hex string starting with 0x" },
+        };
+    }
+    const decoded = decodeTxInput(data);
+    return { exitCode: 0, data: decoded };
+};
+export const decodeInputCommand = {
+    name: "util:decode-input",
+    description: "Decode transaction input data",
+    args: [
+        {
+            name: "data",
+            description: "Hex-encoded transaction input data",
+            required: true,
+            type: "string",
+        },
+    ],
+    flags: [{ name: "abi", description: "Path to ABI JSON file", type: "string" }],
+    handler,
+};
+export { handler as decodeInputHandler };
+//# sourceMappingURL=decodeInput.js.map

package/dist/commands/util/decodeInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decodeInput.js","sourceRoot":"","sources":["../../../src/commands/util/decodeInput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,MAAM,OAAO,GAAmB,KAAK,EAAE,IAAI,EAAE,EAAE;IAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAc,CAAC;IAEjC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO;YACL,QAAQ,EAAE,CAAC;YACX,KAAK,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,4CAA4C,EAAE;SACxF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAEpC,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACxC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAsB;IACnD,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,+BAA+B;IAC5C,IAAI,EAAE;QACJ;YACE,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,oCAAoC;YACjD,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,QAAQ;SACf;KACF;IACD,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,uBAAuB,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC9E,OAAO;CACR,CAAC;AAEF,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,CAAC"}

package/dist/handlers/index.d.ts

@@ -0,0 +1,7 @@
+export { txHistoryHandler } from "../commands/algo/txHistory.js";
+export { gasPriceHandler } from "../commands/algo/gasPrice.js";
+export { tokenBalanceHandler } from "../commands/algo/tokenBalance.js";
+export { addressTypeHandler } from "../commands/util/addressType.js";
+export { decodeInputHandler } from "../commands/util/decodeInput.js";
+export { balanceHandler } from "../commands/util/balance.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/handlers/index.js

@@ -0,0 +1,8 @@
+// Re-export all command handlers for programmatic use
+export { txHistoryHandler } from "../commands/algo/txHistory.js";
+export { gasPriceHandler } from "../commands/algo/gasPrice.js";
+export { tokenBalanceHandler } from "../commands/algo/tokenBalance.js";
+export { addressTypeHandler } from "../commands/util/addressType.js";
+export { decodeInputHandler } from "../commands/util/decodeInput.js";
+export { balanceHandler } from "../commands/util/balance.js";
+//# sourceMappingURL=index.js.map

package/dist/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { CommandRegistry } from "./registry.js";
+export { formatOutput } from "./output/formatters.js";
+export { txHistoryCommand } from "./commands/algo/txHistory.js";
+export { gasPriceCommand } from "./commands/algo/gasPrice.js";
+export { tokenBalanceCommand } from "./commands/algo/tokenBalance.js";
+export { addressTypeCommand } from "./commands/util/addressType.js";
+export { decodeInputCommand } from "./commands/util/decodeInput.js";
+export { balanceCommand } from "./commands/util/balance.js";
+export { txHistoryHandler, gasPriceHandler, tokenBalanceHandler, addressTypeHandler, decodeInputHandler, balanceHandler, } from "./handlers/index.js";
+export { resolveRpcUrls, getAlchemyUrl } from "./rpc/index.js";
+export type { ResolveRpcOptions } from "./rpc/index.js";
+export type { CommandDefinition, CommandHandler, CommandContext, CommandResult, CommandRegistry as ICommandRegistry, ArgDefinition, FlagDefinition, OutputFormat, } from "./types.js";
+//# 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":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/D,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGxD,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,aAAa,EACb,eAAe,IAAI,gBAAgB,EACnC,aAAa,EACb,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+// Programmatic entry point - exports handlers and registry
+export { CommandRegistry } from "./registry.js";
+export { formatOutput } from "./output/formatters.js";
+// Command definitions
+export { txHistoryCommand } from "./commands/algo/txHistory.js";
+export { gasPriceCommand } from "./commands/algo/gasPrice.js";
+export { tokenBalanceCommand } from "./commands/algo/tokenBalance.js";
+export { addressTypeCommand } from "./commands/util/addressType.js";
+export { decodeInputCommand } from "./commands/util/decodeInput.js";
+export { balanceCommand } from "./commands/util/balance.js";
+// Handlers for direct invocation
+export { txHistoryHandler, gasPriceHandler, tokenBalanceHandler, addressTypeHandler, decodeInputHandler, balanceHandler, } from "./handlers/index.js";
+// RPC resolution
+export { resolveRpcUrls, getAlchemyUrl } from "./rpc/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,sBAAsB;AACtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,iCAAiC;AACjC,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,iBAAiB;AACjB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/output/formatters.d.ts

@@ -0,0 +1,6 @@
+import type { OutputFormat, CommandResult } from "../types.js";
+/**
+ * Format a CommandResult for output.
+ */
+export declare function formatOutput<T>(result: CommandResult<T>, format: OutputFormat): string;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/output/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/output/formatters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE/D;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAkBtF"}

package/dist/output/formatters.js

@@ -0,0 +1,80 @@
+/**
+ * Format a CommandResult for output.
+ */
+export function formatOutput(result, format) {
+    if (!result.data) {
+        if (result.error) {
+            return formatError(result.error.code, result.error.message);
+        }
+        return "";
+    }
+    switch (format) {
+        case "json":
+            return JSON.stringify(result.data, null, 2);
+        case "table":
+            return formatTable(result.data);
+        case "stream":
+            return JSON.stringify(result.data);
+        default:
+            return JSON.stringify(result.data, null, 2);
+    }
+}
+function formatError(code, message) {
+    return JSON.stringify({ error: { code, message } }, null, 2);
+}
+function formatTable(data) {
+    if (Array.isArray(data)) {
+        return formatArrayAsTable(data);
+    }
+    if (typeof data === "object" && data !== null) {
+        // Check if it has an entries array (common pattern for algorithm results)
+        const obj = data;
+        if (Array.isArray(obj.entries)) {
+            return formatArrayAsTable(obj.entries);
+        }
+        // Format single object as key-value pairs
+        return Object.entries(obj)
+            .map(([key, value]) => `${key}: ${formatValue(value)}`)
+            .join("\n");
+    }
+    return String(data);
+}
+function formatArrayAsTable(rows) {
+    if (rows.length === 0)
+        return "(empty)";
+    const firstRow = rows[0];
+    if (typeof firstRow !== "object" || firstRow === null) {
+        return rows.map(String).join("\n");
+    }
+    const keys = Object.keys(firstRow);
+    const widths = keys.map((key) => {
+        const values = rows.map((row) => {
+            const val = row[key];
+            return formatValue(val).length;
+        });
+        return Math.max(key.length, ...values);
+    });
+    const header = keys.map((key, i) => key.padEnd(widths[i] ?? 0)).join(" | ");
+    const separator = widths.map((w) => "-".repeat(w)).join("-+-");
+    const body = rows.map((row) => {
+        return keys
+            .map((key, i) => {
+            const val = row[key];
+            return formatValue(val).padEnd(widths[i] ?? 0);
+        })
+            .join(" | ");
+    });
+    return [header, separator, ...body].join("\n");
+}
+function formatValue(value) {
+    if (value === null || value === undefined)
+        return "";
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number" || typeof value === "bigint")
+        return value.toString();
+    if (typeof value === "boolean")
+        return value ? "true" : "false";
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=formatters.js.map

package/dist/output/formatters.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,9 @@
+import type { CommandDefinition, CommandContext, CommandResult, CommandRegistry as ICommandRegistry } from "./types.js";
+export declare class CommandRegistry implements ICommandRegistry {
+    private commands;
+    register(command: CommandDefinition): void;
+    get(name: string): CommandDefinition | undefined;
+    list(): CommandDefinition[];
+    execute(name: string, args: Record<string, unknown>, ctx: CommandContext): Promise<CommandResult>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,eAAe,IAAI,gBAAgB,EACpC,MAAM,YAAY,CAAC;AAEpB,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,QAAQ,CAAwC;IAExD,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAO1C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIhD,IAAI,IAAI,iBAAiB,EAAE;IAIrB,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,aAAa,CAAC;CAwB1B"}

package/dist/registry.js

@@ -0,0 +1,38 @@
+export class CommandRegistry {
+    commands = new Map();
+    register(command) {
+        if (this.commands.has(command.name)) {
+            throw new Error(`Command "${command.name}" is already registered`);
+        }
+        this.commands.set(command.name, command);
+    }
+    get(name) {
+        return this.commands.get(name);
+    }
+    list() {
+        return Array.from(this.commands.values());
+    }
+    async execute(name, args, ctx) {
+        const command = this.commands.get(name);
+        if (!command) {
+            return {
+                exitCode: 1,
+                error: { code: "UNKNOWN_COMMAND", message: `Unknown command: ${name}` },
+            };
+        }
+        // Validate required args
+        for (const argDef of command.args) {
+            if (argDef.required && !(argDef.name in args)) {
+                return {
+                    exitCode: 1,
+                    error: {
+                        code: "MISSING_ARGUMENT",
+                        message: `Missing required argument: ${argDef.name}`,
+                    },
+                };
+            }
+        }
+        return command.handler(args, ctx);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,eAAe;IAClB,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;IAExD,QAAQ,CAAC,OAA0B;QACjC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,YAAY,OAAO,CAAC,IAAI,yBAAyB,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,OAAO,CACX,IAAY,EACZ,IAA6B,EAC7B,GAAmB;QAEnB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,QAAQ,EAAE,CAAC;gBACX,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,oBAAoB,IAAI,EAAE,EAAE;aACxE,CAAC;QACJ,CAAC;QAED,yBAAyB;QACzB,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YAClC,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;gBAC9C,OAAO;oBACL,QAAQ,EAAE,CAAC;oBACX,KAAK,EAAE;wBACL,IAAI,EAAE,kBAAkB;wBACxB,OAAO,EAAE,8BAA8B,MAAM,CAAC,IAAI,EAAE;qBACrD;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/rpc/index.d.ts

@@ -0,0 +1,3 @@
+export { resolveRpcUrls, getAlchemyUrl } from "./resolve.js";
+export type { ResolveRpcOptions } from "./resolve.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/rpc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rpc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/rpc/index.js

@@ -0,0 +1,2 @@
+export { resolveRpcUrls, getAlchemyUrl } from "./resolve.js";
+//# sourceMappingURL=index.js.map

package/dist/rpc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rpc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/rpc/resolve.d.ts

@@ -0,0 +1,8 @@
+export interface ResolveRpcOptions {
+    chainId: number | string;
+    rpcFlag?: string;
+    alchemyKey?: string;
+}
+export declare function getAlchemyUrl(chainId: number, key: string): string | null;
+export declare function resolveRpcUrls(options: ResolveRpcOptions): string[];
+//# sourceMappingURL=resolve.d.ts.map

package/dist/rpc/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/rpc/resolve.ts"],"names":[],"mappings":"AA6BA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIzE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,EAAE,CA+BnE"}

package/dist/rpc/resolve.js

@@ -0,0 +1,58 @@
+import { createRequire } from "node:module";
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+const ALCHEMY_CHAINS = {
+    1: "eth-mainnet",
+    10: "opt-mainnet",
+    56: "bnb-mainnet",
+    97: "bnb-testnet",
+    137: "polygon-mainnet",
+    8453: "base-mainnet",
+    42161: "arb-mainnet",
+    43114: "avax-mainnet",
+    11155111: "eth-sepolia",
+};
+export function getAlchemyUrl(chainId, key) {
+    const subdomain = ALCHEMY_CHAINS[chainId];
+    if (!subdomain)
+        return null;
+    return `https://${subdomain}.g.alchemy.com/v2/${key}`;
+}
+export function resolveRpcUrls(options) {
+    const { chainId, rpcFlag, alchemyKey } = options;
+    if (rpcFlag) {
+        return rpcFlag
+            .split(",")
+            .map((u) => u.trim())
+            .filter(Boolean);
+    }
+    const urls = [];
+    const numericChainId = typeof chainId === "string" ? Number(chainId) : chainId;
+    if (alchemyKey) {
+        const alchemyUrl = getAlchemyUrl(numericChainId, alchemyKey);
+        if (alchemyUrl) {
+            urls.push(alchemyUrl);
+        }
+    }
+    const metadataUrls = loadMetadataRpcs(numericChainId);
+    urls.push(...metadataUrls);
+    if (urls.length === 0) {
+        throw new Error(`No RPC endpoints available for chain ${chainId}. ` +
+            "Provide --rpc explicitly or use --alchemy-key for supported chains.");
+    }
+    return urls;
+}
+function loadMetadataRpcs(chainId) {
+    try {
+        const require = createRequire(import.meta.url);
+        const metadataBase = dirname(require.resolve("@openscan/metadata/package.json"));
+        const rpcFile = join(metadataBase, "dist", "rpcs", "evm", `${chainId}.json`);
+        const raw = readFileSync(rpcFile, "utf-8");
+        const data = JSON.parse(raw);
+        return data.endpoints.filter((e) => e.isPublic).map((e) => e.url);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=resolve.js.map

package/dist/rpc/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/rpc/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,cAAc,GAA2B;IAC7C,CAAC,EAAE,aAAa;IAChB,EAAE,EAAE,aAAa;IACjB,EAAE,EAAE,aAAa;IACjB,EAAE,EAAE,aAAa;IACjB,GAAG,EAAE,iBAAiB;IACtB,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,aAAa;IACpB,KAAK,EAAE,cAAc;IACrB,QAAQ,EAAE,aAAa;CACxB,CAAC;AAqBF,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,GAAW;IACxD,MAAM,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,OAAO,WAAW,SAAS,qBAAqB,GAAG,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAA0B;IACvD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAEjD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO;aACX,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IAED,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,cAAc,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAE/E,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,UAAU,GAAG,aAAa,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;QAC7D,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,gBAAgB,CAAC,cAAc,CAAC,CAAC;IACtD,IAAI,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC;IAE3B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,wCAAwC,OAAO,IAAI;YACjD,qEAAqE,CACxE,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe;IACvC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC,CAAC;QACjF,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,OAAO,CAAC,CAAC;QAC7E,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAgB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,43 @@
+import type { OpError, OpMetadata } from "@openscan/utils";
+export interface CommandDefinition {
+    name: string;
+    description: string;
+    args: ArgDefinition[];
+    flags: FlagDefinition[];
+    handler: CommandHandler;
+}
+export interface ArgDefinition {
+    name: string;
+    description: string;
+    required: boolean;
+    type: "string" | "number" | "boolean";
+}
+export interface FlagDefinition {
+    name: string;
+    alias?: string;
+    description: string;
+    type: "string" | "number" | "boolean";
+    default?: unknown;
+}
+export type OutputFormat = "json" | "table" | "stream";
+export interface CommandContext {
+    outputFormat: OutputFormat;
+    chainId: number | string;
+    rpcUrls: string[];
+    strategyType: "fallback" | "parallel" | "race";
+    verbose: boolean;
+}
+export interface CommandResult<T = unknown> {
+    exitCode: number;
+    data?: T;
+    error?: OpError;
+    metadata?: OpMetadata;
+}
+export type CommandHandler = (args: Record<string, unknown>, ctx: CommandContext) => Promise<CommandResult>;
+export interface CommandRegistry {
+    register(command: CommandDefinition): void;
+    get(name: string): CommandDefinition | undefined;
+    list(): CommandDefinition[];
+    execute(name: string, args: Record<string, unknown>, ctx: CommandContext): Promise<CommandResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEvD,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,YAAY,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED,MAAM,MAAM,cAAc,GAAG,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,cAAc,KAChB,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5B,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC3C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAC;IACjD,IAAI,IAAI,iBAAiB,EAAE,CAAC;IAC5B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACnG"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@openscan/cli",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openscan-explorer/ia.git",
+    "directory": "packages/cli"
+  },
+  "version": "0.0.1-alpha",
+  "type": "module",
+  "bin": {
+    "openscan": "dist/bin.js"
+  },
+  "dependencies": {
+    "@openscan/metadata": "1.1.2-alpha.0",
+    "citty": "^0.2.1",
+    "@openscan/algorithms": "0.0.1-alpha",
+    "@openscan/utils": "0.0.1-alpha"
+  },
+  "peerDependencies": {
+    "@openscan/network-connectors": "^1.7.0"
+  },
+  "devDependencies": {
+    "@openscan/network-connectors": "^1.7.0",
+    "@types/node": "^24.10.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "@openscan/tsconfig": "0.0.0"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "tsx --test tests/**/*.test.ts",
+    "typecheck": "tsc --noEmit"
+  }
+}