chainbase-cli 0.1.0

package/README.md

@@ -0,0 +1,188 @@
+# Chainbase CLI
+
+A command-line interface for the [Chainbase Web3 API](https://docs.chainbase.com/api-reference/overview). Designed for both human use and AI agent automation — outputs JSON by default, with an optional `--pretty` flag for human-readable format.
+
+## Install
+
+```bash
+npm install -g chainbase-cli
+```
+
+Or run directly with npx:
+
+```bash
+npx chainbase-cli --help
+```
+
+## Quick Start
+
+```bash
+# Set your API key (get one at https://console.chainbase.com)
+chainbase config set api-key YOUR_API_KEY
+
+# Get latest Ethereum block number
+chainbase block latest
+
+# Get USDT price
+chainbase token price 0xdac17f958d2ee523a2206206994597c13d831ec7
+
+# Resolve ENS domain
+chainbase domain ens-resolve vitalik.eth
+
+# Query on BSC (chain ID 56)
+chainbase token price 0x55d398326f99059fF775485246999027B3197955 --chain 56
+```
+
+## Global Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--chain <id>` | Chain ID | `1` (Ethereum) |
+| `--pretty` | Human-readable output | `false` |
+| `--page <n>` | Page number | `1` |
+| `--limit <n>` | Results per page | `20` |
+
+## Commands
+
+### `config` — Configuration
+
+```bash
+chainbase config set api-key <key>      # Set API key
+chainbase config set default-chain 137  # Set default chain to Polygon
+chainbase config get api-key            # Get a config value
+chainbase config list                   # List all config
+```
+
+### `block` — Block Queries
+
+```bash
+chainbase block latest                  # Latest block number
+chainbase block detail 20000000         # Block details by number
+```
+
+### `tx` — Transaction Queries
+
+```bash
+chainbase tx detail <hash>                        # Transaction by hash
+chainbase tx list <address>                        # Account transactions
+chainbase tx list <address> --from-block 20000000  # With block range filter
+```
+
+### `token` — Token Queries
+
+```bash
+chainbase token metadata <contract>                # Token metadata
+chainbase token price <contract>                   # Current price
+chainbase token price-history <contract> --from <ts> --to <ts>  # Price history
+chainbase token holders <contract>                 # All holders
+chainbase token top-holders <contract>             # Top holders
+chainbase token transfers --contract <addr>        # Transfer history
+```
+
+### `nft` — NFT Queries
+
+```bash
+chainbase nft metadata <contract> <token_id>       # NFT metadata
+chainbase nft collection <contract>                # Collection info
+chainbase nft collection-items <contract>          # Items in collection
+chainbase nft search "Bored Ape"                   # Search by name
+chainbase nft owner <contract> <token_id>          # Current owner
+chainbase nft owners <contract>                    # All owners
+chainbase nft owner-history <contract> <token_id>  # Owner history
+chainbase nft transfers --contract <addr>          # Transfer history
+chainbase nft floor-price <contract>               # Floor price
+chainbase nft price-history <contract> --from <ts> --to <ts>  # Price history
+chainbase nft trending                             # Trending collections
+chainbase nft rarity <contract>                    # Rarity scores
+```
+
+### `balance` — Balance & Portfolio
+
+```bash
+chainbase balance native <address>                 # Native token balance (ETH, BNB, etc.)
+chainbase balance tokens <address>                 # ERC20 token balances
+chainbase balance nfts <address>                   # NFTs owned
+chainbase balance portfolios <address>             # DeFi positions
+chainbase balance portfolios <address> --chains 1,137  # Filter by chains
+```
+
+### `domain` — ENS & Space ID
+
+```bash
+chainbase domain ens <address>                     # ENS domains held by address
+chainbase domain ens-resolve vitalik.eth           # Resolve ENS → address
+chainbase domain ens-reverse <address>             # Reverse resolve address → ENS
+chainbase domain spaceid-resolve <domain>          # Resolve Space ID (BSC)
+chainbase domain spaceid-reverse <address>         # Reverse resolve Space ID
+```
+
+### `contract` — Smart Contract
+
+```bash
+chainbase contract call \
+  --address <contract> \
+  --function "balanceOf" \
+  --abi '[...]' \
+  --params '["0x..."]'
+```
+
+### `sql` — SQL Queries
+
+```bash
+chainbase sql execute "SELECT number FROM ethereum.blocks LIMIT 5"  # Execute async query
+chainbase sql status <execution_id>                                 # Check status
+chainbase sql results <execution_id>                                # Get results
+```
+
+## Supported Chains
+
+| Chain | ID | Chain | ID |
+|-------|----|-------|----|
+| Ethereum | `1` | Arbitrum | `42161` |
+| BSC | `56` | Optimism | `10` |
+| Polygon | `137` | Base | `8453` |
+| Avalanche | `43114` | zkSync | `324` |
+
+## Authentication
+
+The API key can be configured in three ways (in priority order):
+
+1. **Environment variable**: `CHAINBASE_API_KEY=xxx chainbase block latest`
+2. **Config file**: `chainbase config set api-key xxx` (stored at `~/.chainbase/config.json`, mode 0600)
+
+## For AI Agents
+
+This CLI is designed to be controlled by AI agents. Key features:
+
+- **JSON output by default** — machine-parseable, no colors or formatting
+- **Consistent error format** — errors output as `{"error":"message"}` to stderr
+- **Discoverable** — `chainbase --help` and `chainbase <command> --help` list all available commands
+- **Predictable** — every command follows the same pattern: `chainbase <group> <action> [args] [options]`
+
+Example agent usage:
+
+```bash
+# Parse output directly
+PRICE=$(chainbase token price 0xdac17f958d2ee523a2206206994597c13d831ec7 | jq '.data.price')
+
+# Check if command succeeded
+if chainbase balance native 0x... 2>/dev/null; then
+  echo "Success"
+fi
+```
+
+## Development
+
+```bash
+git clone https://github.com/chainbase-labs/cli.git
+cd cli
+npm install
+npm run build      # Build
+npm test           # Run tests
+npm run lint       # Type-check
+npm link           # Install globally for local dev
+```
+
+## License
+
+ISC

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,633 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command as Command11 } from "commander";
+
+// src/commands/config.ts
+import { Command } from "commander";
+
+// src/config.ts
+import fs from "fs";
+import path from "path";
+import os from "os";
+function getConfigDir() {
+  return process.env.CHAINBASE_CONFIG_DIR || path.join(os.homedir(), ".chainbase");
+}
+function getConfigPath() {
+  return path.join(getConfigDir(), "config.json");
+}
+function readConfigFile() {
+  const configPath = getConfigPath();
+  if (!fs.existsSync(configPath)) return {};
+  try {
+    return JSON.parse(fs.readFileSync(configPath, "utf-8"));
+  } catch {
+    throw new Error(`Config file corrupted: ${configPath}
+Delete it and re-configure: chainbase config set api-key <your-key>`);
+  }
+}
+function writeConfigFile(config) {
+  const dir = getConfigDir();
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true, mode: 448 });
+  fs.writeFileSync(getConfigPath(), JSON.stringify(config, null, 2), { mode: 384 });
+}
+function setConfig(key, value) {
+  const config = readConfigFile();
+  config[key] = value;
+  writeConfigFile(config);
+}
+function getConfig(key) {
+  const config = readConfigFile();
+  return config[key];
+}
+function listConfig() {
+  return readConfigFile();
+}
+function getApiKey() {
+  const envKey = process.env.CHAINBASE_API_KEY;
+  if (envKey) return envKey;
+  const fileKey = getConfig("api-key");
+  if (fileKey) return fileKey;
+  throw new Error("No API key configured. Run: chainbase config set api-key <your-key>");
+}
+function getDefaultChain() {
+  return getConfig("default-chain") || "1";
+}
+
+// src/output.ts
+import chalk from "chalk";
+function formatOutput(data, pretty) {
+  if (pretty) {
+    process.stdout.write(JSON.stringify(data, null, 2) + "\n");
+  } else {
+    process.stdout.write(JSON.stringify(data) + "\n");
+  }
+}
+function formatError(message, pretty) {
+  const error = { error: message };
+  if (pretty) {
+    process.stderr.write(chalk.red(`Error: ${message}`) + "\n");
+  } else {
+    process.stderr.write(JSON.stringify(error) + "\n");
+  }
+}
+
+// src/commands/config.ts
+function createConfigCommand() {
+  const cmd = new Command("config").description("\u7BA1\u7406 CLI \u914D\u7F6E");
+  cmd.command("set <key> <value>").description("\u8BBE\u7F6E\u914D\u7F6E\u9879\uFF08api-key, default-chain\uFF09").action((key, value) => {
+    setConfig(key, value);
+    const pretty = cmd.parent?.opts().pretty ?? false;
+    formatOutput({ status: "ok", key, value: key === "api-key" ? "***" : value }, pretty);
+  });
+  cmd.command("get <key>").description("\u83B7\u53D6\u914D\u7F6E\u9879").action((key) => {
+    const pretty = cmd.parent?.opts().pretty ?? false;
+    let value = getConfig(key) ?? null;
+    if (key === "api-key" && value) value = "***" + value.slice(-4);
+    formatOutput({ key, value }, pretty);
+  });
+  cmd.command("list").description("\u5217\u51FA\u6240\u6709\u914D\u7F6E\u9879").action(() => {
+    const pretty = cmd.parent?.opts().pretty ?? false;
+    const config = listConfig();
+    const safe = { ...config };
+    if (safe["api-key"]) safe["api-key"] = "***" + safe["api-key"].slice(-4);
+    formatOutput(safe, pretty);
+  });
+  return cmd;
+}
+
+// src/commands/block.ts
+import { Command as Command2 } from "commander";
+
+// src/client.ts
+import axios from "axios";
+var WEB3_BASE = "https://api.chainbase.online";
+var SQL_BASE = "https://api.chainbase.com/api/v1";
+var ChainbaseClient = class {
+  constructor(apiKey) {
+    this.apiKey = apiKey;
+  }
+  getBaseUrl(path2) {
+    if (path2.startsWith("/query/") || path2.startsWith("/execution/")) {
+      return SQL_BASE;
+    }
+    return WEB3_BASE;
+  }
+  async get(path2, params) {
+    return this.request("GET", path2, { params });
+  }
+  async post(path2, data) {
+    return this.request("POST", path2, { data });
+  }
+  async request(method, path2, options) {
+    const baseUrl = this.getBaseUrl(path2);
+    const response = await axios.request({
+      method,
+      url: `${baseUrl}${path2}`,
+      headers: {
+        "x-api-key": this.apiKey,
+        "Content-Type": "application/json"
+      },
+      params: options.params,
+      data: options.data
+    });
+    const body = response.data;
+    if (body && typeof body === "object" && "code" in body && body.code !== 0) {
+      throw new Error(body.message || `API error code: ${body.code}`);
+    }
+    return body;
+  }
+};
+function createClient(opts) {
+  const apiKey = getApiKey();
+  const chainId = opts.chain || getDefaultChain();
+  return { client: new ChainbaseClient(apiKey), chainId };
+}
+
+// src/commands/block.ts
+function createBlockCommand() {
+  const cmd = new Command2("block").description("\u533A\u5757\u67E5\u8BE2");
+  cmd.command("latest").description("\u83B7\u53D6\u6700\u65B0\u533A\u5757\u53F7").action(async () => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const result = await client.get("/v1/block/number/latest", { chain_id: chainId });
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("detail <number>").description("\u6309\u533A\u5757\u53F7\u67E5\u8BE2\u533A\u5757\u8BE6\u60C5").action(async (number) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const result = await client.get("/v1/block/detail", { chain_id: chainId, number });
+    formatOutput(result, opts.pretty);
+  });
+  return cmd;
+}
+
+// src/commands/tx.ts
+import { Command as Command3 } from "commander";
+function createTxCommand() {
+  const cmd = new Command3("tx").description("\u4EA4\u6613\u67E5\u8BE2");
+  cmd.command("detail <hash>").description("\u6309\u54C8\u5E0C\u67E5\u8BE2\u4EA4\u6613\u8BE6\u60C5").action(async (hash) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const result = await client.get("/v1/tx/detail", { chain_id: chainId, hash });
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("list <address>").description("\u67E5\u8BE2\u8D26\u6237\u4EA4\u6613\u5217\u8868").option("--from-block <n>", "\u8D77\u59CB\u533A\u5757\u53F7").option("--to-block <n>", "\u7ED3\u675F\u533A\u5757\u53F7").option("--from-timestamp <n>", "\u8D77\u59CB\u65F6\u95F4\u6233").option("--end-timestamp <n>", "\u7ED3\u675F\u65F6\u95F4\u6233").option("--page <n>", "\u9875\u7801").option("--limit <n>", "\u6BCF\u9875\u6761\u6570").action(async (address, cmdOpts) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const params = {
+      chain_id: chainId,
+      address
+    };
+    if (cmdOpts.page) params.page = cmdOpts.page;
+    if (cmdOpts.limit) params.limit = cmdOpts.limit;
+    if (cmdOpts.fromBlock) params.from_block = cmdOpts.fromBlock;
+    if (cmdOpts.toBlock) params.to_block = cmdOpts.toBlock;
+    if (cmdOpts.fromTimestamp) params.from_timestamp = cmdOpts.fromTimestamp;
+    if (cmdOpts.endTimestamp) params.end_timestamp = cmdOpts.endTimestamp;
+    const result = await client.get("/v1/account/txs", params);
+    formatOutput(result, opts.pretty);
+  });
+  return cmd;
+}
+
+// src/commands/contract.ts
+import { Command as Command4 } from "commander";
+function createContractCommand() {
+  const cmd = new Command4("contract").description("\u667A\u80FD\u5408\u7EA6\u4EA4\u4E92");
+  cmd.command("call").description("\u8C03\u7528\u5408\u7EA6\u53EA\u8BFB\u51FD\u6570").requiredOption("--address <addr>", "\u5408\u7EA6\u5730\u5740").requiredOption("--function <name>", "\u51FD\u6570\u540D").requiredOption("--abi <json>", "\u5408\u7EA6 ABI\uFF08JSON \u5B57\u7B26\u4E32\uFF09").option("--params <json>", "\u51FD\u6570\u53C2\u6570\uFF08JSON \u6570\u7EC4\uFF09", "[]").option("--to-block <n>", "\u533A\u5757\u53F7").action(async (cmdOpts) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const body = {
+      chain_id: Number(chainId),
+      contract_address: cmdOpts.address,
+      function_name: cmdOpts.function,
+      abi: cmdOpts.abi,
+      params: (() => {
+        try {
+          return JSON.parse(cmdOpts.params);
+        } catch {
+          throw new Error(`--params \u683C\u5F0F\u9519\u8BEF\uFF0C\u8BF7\u63D0\u4F9B\u5408\u6CD5 JSON \u6570\u7EC4\uFF0C\u5982 '["0x..."]'`);
+        }
+      })(),
+      ...cmdOpts.toBlock && { to_block: cmdOpts.toBlock }
+    };
+    const result = await client.post("/v1/contract/call", body);
+    formatOutput(result, opts.pretty);
+  });
+  return cmd;
+}
+
+// src/commands/address.ts
+import { Command as Command5 } from "commander";
+function createAddressCommand() {
+  const cmd = new Command5("address").description("\u5730\u5740\u67E5\u8BE2");
+  cmd.command("labels <address>").description("\u83B7\u53D6\u5730\u5740\u6807\u7B7E").action(async (address) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const result = await client.get("/v1/address/labels", { chain_id: chainId, address });
+    formatOutput(result, opts.pretty);
+  });
+  return cmd;
+}
+
+// src/commands/token.ts
+import { Command as Command6 } from "commander";
+function createTokenCommand() {
+  const cmd = new Command6("token").description("\u4EE3\u5E01\u67E5\u8BE2");
+  cmd.command("metadata <contract>").description("\u83B7\u53D6\u4EE3\u5E01\u5143\u6570\u636E").action(async (contract) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const result = await client.get("/v1/token/metadata", {
+      chain_id: chainId,
+      contract_address: contract
+    });
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("transfers").description("\u83B7\u53D6\u4EE3\u5E01\u8F6C\u8D26\u8BB0\u5F55").option("--contract <addr>", "\u5408\u7EA6\u5730\u5740").option("--address <addr>", "\u94B1\u5305\u5730\u5740").option("--from-block <n>", "\u8D77\u59CB\u533A\u5757\u53F7").option("--to-block <n>", "\u7ED3\u675F\u533A\u5757\u53F7").option("--from-timestamp <n>", "\u8D77\u59CB\u65F6\u95F4\u6233").option("--end-timestamp <n>", "\u7ED3\u675F\u65F6\u95F4\u6233").action(async (cmdOpts) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const params = {
+      chain_id: chainId
+    };
+    if (cmdOpts.contract) params.contract_address = cmdOpts.contract;
+    if (cmdOpts.address) params.address = cmdOpts.address;
+    if (cmdOpts.fromBlock) params.from_block = cmdOpts.fromBlock;
+    if (cmdOpts.toBlock) params.to_block = cmdOpts.toBlock;
+    if (cmdOpts.fromTimestamp) params.from_timestamp = cmdOpts.fromTimestamp;
+    if (cmdOpts.endTimestamp) params.end_timestamp = cmdOpts.endTimestamp;
+    if (opts.page) params.page = opts.page;
+    if (opts.limit) params.limit = opts.limit;
+    const result = await client.get("/v1/token/transfers", params);
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("holders <contract>").description("\u83B7\u53D6\u4EE3\u5E01\u6301\u6709\u8005\u5217\u8868").action(async (contract) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const params = {
+      chain_id: chainId,
+      contract_address: contract
+    };
+    if (opts.page) params.page = opts.page;
+    if (opts.limit) params.limit = opts.limit;
+    const result = await client.get("/v1/token/holders", params);
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("top-holders <contract>").description("\u83B7\u53D6\u4EE3\u5E01 Top \u6301\u6709\u8005").action(async (contract) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const params = {
+      chain_id: chainId,
+      contract_address: contract
+    };
+    if (opts.page) params.page = opts.page;
+    if (opts.limit) params.limit = opts.limit;
+    const result = await client.get("/v1/token/top-holders", params);
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("price <contract>").description("\u83B7\u53D6\u4EE3\u5E01\u4EF7\u683C").action(async (contract) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const result = await client.get("/v1/token/price", {
+      chain_id: chainId,
+      contract_address: contract
+    });
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("price-history <contract>").description("\u83B7\u53D6\u4EE3\u5E01\u5386\u53F2\u4EF7\u683C").requiredOption("--from <timestamp>", "\u8D77\u59CB\u65F6\u95F4\u6233").requiredOption("--to <timestamp>", "\u7ED3\u675F\u65F6\u95F4\u6233").action(async (contract, cmdOpts) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const result = await client.get("/v1/token/price/history", {
+      chain_id: chainId,
+      contract_address: contract,
+      from_timestamp: cmdOpts.from,
+      end_timestamp: cmdOpts.to
+    });
+    formatOutput(result, opts.pretty);
+  });
+  return cmd;
+}
+
+// src/commands/nft.ts
+import { Command as Command7 } from "commander";
+function createNftCommand() {
+  const cmd = new Command7("nft").description("NFT \u67E5\u8BE2");
+  cmd.command("metadata <contract> <token_id>").description("\u83B7\u53D6 NFT \u5143\u6570\u636E").action(async (contract, tokenId) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const result = await client.get("/v1/nft/metadata", {
+      chain_id: chainId,
+      contract_address: contract,
+      token_id: tokenId
+    });
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("collection <contract>").description("\u83B7\u53D6 NFT \u96C6\u5408\u4FE1\u606F").action(async (contract) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const result = await client.get("/v1/nft/collection", {
+      chain_id: chainId,
+      contract_address: contract
+    });
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("collection-items <contract>").description("\u83B7\u53D6 NFT \u96C6\u5408\u5185\u6240\u6709\u9879\u76EE").option("--page <n>", "\u9875\u7801").option("--limit <n>", "\u6BCF\u9875\u6761\u6570").action(async (contract, cmdOpts) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const params = {
+      chain_id: chainId,
+      contract_address: contract
+    };
+    if (cmdOpts.page) params.page = cmdOpts.page;
+    if (cmdOpts.limit) params.limit = cmdOpts.limit;
+    const result = await client.get("/v1/nft/collection/items", params);
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("search <name>").description("\u6309\u540D\u79F0\u641C\u7D22 NFT \u96C6\u5408").option("--contract <addr>", "\u5408\u7EA6\u5730\u5740").option("--page <n>", "\u9875\u7801").option("--limit <n>", "\u6BCF\u9875\u6761\u6570").action(async (name, cmdOpts) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const params = {
+      chain_id: chainId,
+      name
+    };
+    if (cmdOpts.contract) params.contract_address = cmdOpts.contract;
+    if (cmdOpts.page) params.page = cmdOpts.page;
+    if (cmdOpts.limit) params.limit = cmdOpts.limit;
+    const result = await client.get("/v1/nft/search", params);
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("transfers").description("\u83B7\u53D6 NFT \u8F6C\u8D26\u8BB0\u5F55").option("--contract <addr>", "\u5408\u7EA6\u5730\u5740").option("--token-id <id>", "Token ID").option("--address <addr>", "\u94B1\u5305\u5730\u5740").option("--from-block <n>", "\u8D77\u59CB\u533A\u5757\u53F7").option("--to-block <n>", "\u7ED3\u675F\u533A\u5757\u53F7").option("--from-timestamp <n>", "\u8D77\u59CB\u65F6\u95F4\u6233").option("--end-timestamp <n>", "\u7ED3\u675F\u65F6\u95F4\u6233").option("--page <n>", "\u9875\u7801").option("--limit <n>", "\u6BCF\u9875\u6761\u6570").action(async (cmdOpts) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const params = {
+      chain_id: chainId
+    };
+    if (cmdOpts.contract) params.contract_address = cmdOpts.contract;
+    if (cmdOpts.tokenId) params.token_id = cmdOpts.tokenId;
+    if (cmdOpts.address) params.address = cmdOpts.address;
+    if (cmdOpts.fromBlock) params.from_block = cmdOpts.fromBlock;
+    if (cmdOpts.toBlock) params.to_block = cmdOpts.toBlock;
+    if (cmdOpts.fromTimestamp) params.from_timestamp = cmdOpts.fromTimestamp;
+    if (cmdOpts.endTimestamp) params.end_timestamp = cmdOpts.endTimestamp;
+    if (cmdOpts.page) params.page = cmdOpts.page;
+    if (cmdOpts.limit) params.limit = cmdOpts.limit;
+    const result = await client.get("/v1/nft/transfers", params);
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("owner <contract> <token_id>").description("\u83B7\u53D6 NFT \u5F53\u524D\u6301\u6709\u8005").option("--to-block <n>", "\u533A\u5757\u53F7").action(async (contract, tokenId, cmdOpts) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const params = {
+      chain_id: chainId,
+      contract_address: contract,
+      token_id: tokenId
+    };
+    if (cmdOpts.toBlock) params.to_block = cmdOpts.toBlock;
+    const result = await client.get("/v1/nft/owner", params);
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("owners <contract>").description("\u83B7\u53D6 NFT \u96C6\u5408\u6240\u6709\u6301\u6709\u8005").option("--page <n>", "\u9875\u7801").option("--limit <n>", "\u6BCF\u9875\u6761\u6570").action(async (contract, cmdOpts) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const params = {
+      chain_id: chainId,
+      contract_address: contract
+    };
+    if (cmdOpts.page) params.page = cmdOpts.page;
+    if (cmdOpts.limit) params.limit = cmdOpts.limit;
+    const result = await client.get("/v1/nft/owners", params);
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("owner-history <contract> <token_id>").description("\u83B7\u53D6 NFT \u6301\u6709\u8005\u5386\u53F2").option("--from-block <n>", "\u8D77\u59CB\u533A\u5757\u53F7").option("--to-block <n>", "\u7ED3\u675F\u533A\u5757\u53F7").option("--from-timestamp <n>", "\u8D77\u59CB\u65F6\u95F4\u6233").option("--end-timestamp <n>", "\u7ED3\u675F\u65F6\u95F4\u6233").option("--page <n>", "\u9875\u7801").option("--limit <n>", "\u6BCF\u9875\u6761\u6570").action(async (contract, tokenId, cmdOpts) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const params = {
+      chain_id: chainId,
+      contract_address: contract,
+      token_id: tokenId
+    };
+    if (cmdOpts.fromBlock) params.from_block = cmdOpts.fromBlock;
+    if (cmdOpts.toBlock) params.to_block = cmdOpts.toBlock;
+    if (cmdOpts.fromTimestamp) params.from_timestamp = cmdOpts.fromTimestamp;
+    if (cmdOpts.endTimestamp) params.end_timestamp = cmdOpts.endTimestamp;
+    if (cmdOpts.page) params.page = cmdOpts.page;
+    if (cmdOpts.limit) params.limit = cmdOpts.limit;
+    const result = await client.get("/v1/nft/owner/history", params);
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("floor-price <contract>").description("\u83B7\u53D6 NFT \u5730\u677F\u4EF7").action(async (contract) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const result = await client.get("/v1/nft/floor_price", {
+      chain_id: chainId,
+      contract_address: contract
+    });
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("price-history <contract>").description("\u83B7\u53D6 NFT \u5386\u53F2\u5730\u677F\u4EF7").requiredOption("--from <timestamp>", "\u8D77\u59CB\u65F6\u95F4\u6233").requiredOption("--to <timestamp>", "\u7ED3\u675F\u65F6\u95F4\u6233").action(async (contract, cmdOpts) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const result = await client.get("/v1/nft/price/history", {
+      chain_id: chainId,
+      contract_address: contract,
+      from_timestamp: cmdOpts.from,
+      end_timestamp: cmdOpts.to
+    });
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("trending").description("\u83B7\u53D6\u70ED\u95E8 NFT \u96C6\u5408").option("--range <period>", "\u65F6\u95F4\u8303\u56F4", "7d").option("--exchange <name>", "\u4EA4\u6613\u6240\u540D\u79F0").option("--sort <order>", "\u6392\u5E8F\u65B9\u5F0F").option("--page <n>", "\u9875\u7801").option("--limit <n>", "\u6BCF\u9875\u6761\u6570").action(async (cmdOpts) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const params = {
+      chain_id: chainId,
+      range: cmdOpts.range
+    };
+    if (cmdOpts.exchange) params.exchange_name = cmdOpts.exchange;
+    if (cmdOpts.sort) params.sort = cmdOpts.sort;
+    if (cmdOpts.page) params.page = cmdOpts.page;
+    if (cmdOpts.limit) params.limit = cmdOpts.limit;
+    const result = await client.get("/v1/nft/collection/trending", params);
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("rarity <contract>").description("\u83B7\u53D6 NFT \u7A00\u6709\u5EA6").option("--token-id <id>", "Token ID").option("--rank-min <n>", "\u6700\u4F4E\u6392\u540D").option("--rank-max <n>", "\u6700\u9AD8\u6392\u540D").option("--page <n>", "\u9875\u7801").option("--limit <n>", "\u6BCF\u9875\u6761\u6570").action(async (contract, cmdOpts) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const params = {
+      chain_id: chainId,
+      contract_address: contract
+    };
+    if (cmdOpts.tokenId) params.token_id = cmdOpts.tokenId;
+    if (cmdOpts.rankMin) params.rank_min = cmdOpts.rankMin;
+    if (cmdOpts.rankMax) params.rank_max = cmdOpts.rankMax;
+    if (cmdOpts.page) params.page = cmdOpts.page;
+    if (cmdOpts.limit) params.limit = cmdOpts.limit;
+    const result = await client.get("/v1/nft/rarity", params);
+    formatOutput(result, opts.pretty);
+  });
+  return cmd;
+}
+
+// src/commands/balance.ts
+import { Command as Command8 } from "commander";
+function createBalanceCommand() {
+  const cmd = new Command8("balance").description("\u4F59\u989D\u4E0E\u8D26\u6237\u67E5\u8BE2");
+  cmd.command("native <address>").description("\u83B7\u53D6\u539F\u751F\u4EE3\u5E01\u4F59\u989D").option("--to-block <n>", "\u533A\u5757\u53F7").action(async (address, cmdOpts) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const params = {
+      chain_id: chainId,
+      address
+    };
+    if (cmdOpts.toBlock) params.to_block = cmdOpts.toBlock;
+    const result = await client.get("/v1/account/balance", params);
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("tokens <address>").description("\u83B7\u53D6 ERC20 \u4EE3\u5E01\u4F59\u989D").option("--contract <addr>", "\u6309\u5408\u7EA6\u5730\u5740\u7B5B\u9009").option("--page <n>", "\u9875\u7801").option("--limit <n>", "\u6BCF\u9875\u6761\u6570").action(async (address, cmdOpts) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const params = {
+      chain_id: chainId,
+      address
+    };
+    if (cmdOpts.contract) params.contract_address = cmdOpts.contract;
+    if (cmdOpts.page) params.page = cmdOpts.page;
+    if (cmdOpts.limit) params.limit = cmdOpts.limit;
+    const result = await client.get("/v1/account/tokens", params);
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("portfolios <address>").description("\u83B7\u53D6 DeFi \u7EC4\u5408\u6301\u4ED3").option("--chains <ids>", "\u94FE ID\uFF08\u9017\u53F7\u5206\u9694\uFF09").action(async (address, cmdOpts) => {
+    const opts = cmd.parent.opts();
+    const { client } = createClient(opts);
+    const params = {
+      address
+    };
+    if (cmdOpts.chains) params.chain_id = cmdOpts.chains.split(",");
+    const result = await client.get("/v1/account/portfolios", params);
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("nfts <address>").description("\u83B7\u53D6\u6301\u6709\u7684 NFT \u5217\u8868").option("--contract <addr>", "\u6309\u5408\u7EA6\u5730\u5740\u7B5B\u9009").option("--page <n>", "\u9875\u7801").option("--limit <n>", "\u6BCF\u9875\u6761\u6570").action(async (address, cmdOpts) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const params = {
+      chain_id: chainId,
+      address
+    };
+    if (cmdOpts.contract) params.contract_address = cmdOpts.contract;
+    if (cmdOpts.page) params.page = cmdOpts.page;
+    if (cmdOpts.limit) params.limit = cmdOpts.limit;
+    const result = await client.get("/v1/account/nfts", params);
+    formatOutput(result, opts.pretty);
+  });
+  return cmd;
+}
+
+// src/commands/domain.ts
+import { Command as Command9 } from "commander";
+function createDomainCommand() {
+  const cmd = new Command9("domain").description("\u57DF\u540D\u67E5\u8BE2");
+  cmd.command("ens <address>").description("\u83B7\u53D6\u5730\u5740\u6301\u6709\u7684 ENS \u57DF\u540D").option("--to-block <n>", "\u533A\u5757\u53F7").action(async (address, cmdOpts) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const params = {
+      chain_id: chainId,
+      address
+    };
+    if (cmdOpts.toBlock) params.to_block = cmdOpts.toBlock;
+    const result = await client.get("/v1/account/ens", params);
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("ens-resolve <domain>").description("\u89E3\u6790 ENS \u57DF\u540D").option("--to-block <n>", "\u533A\u5757\u53F7").action(async (domain, cmdOpts) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const params = {
+      chain_id: chainId,
+      domain
+    };
+    if (cmdOpts.toBlock) params.to_block = cmdOpts.toBlock;
+    const result = await client.get("/v1/ens/records", params);
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("ens-reverse <address>").description("\u53CD\u5411\u89E3\u6790\u5730\u5740\u5230 ENS \u57DF\u540D").option("--to-block <n>", "\u533A\u5757\u53F7").action(async (address, cmdOpts) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const params = {
+      chain_id: chainId,
+      address
+    };
+    if (cmdOpts.toBlock) params.to_block = cmdOpts.toBlock;
+    const result = await client.get("/v1/ens/reverse", params);
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("spaceid-resolve <domain>").description("\u89E3\u6790 Space ID \u57DF\u540D").option("--to-block <n>", "\u533A\u5757\u53F7").action(async (domain, cmdOpts) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const params = {
+      chain_id: chainId,
+      domain
+    };
+    if (cmdOpts.toBlock) params.to_block = cmdOpts.toBlock;
+    const result = await client.get("/v1/space-id/records", params);
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("spaceid-reverse <address>").description("\u53CD\u5411\u89E3\u6790\u5730\u5740\u5230 Space ID \u57DF\u540D").option("--to-block <n>", "\u533A\u5757\u53F7").action(async (address, cmdOpts) => {
+    const opts = cmd.parent.opts();
+    const { client, chainId } = createClient(opts);
+    const params = {
+      chain_id: chainId,
+      address
+    };
+    if (cmdOpts.toBlock) params.to_block = cmdOpts.toBlock;
+    const result = await client.get("/v1/space-id/reverse", params);
+    formatOutput(result, opts.pretty);
+  });
+  return cmd;
+}
+
+// src/commands/sql.ts
+import { Command as Command10 } from "commander";
+function createSqlCommand() {
+  const cmd = new Command10("sql").description("SQL \u67E5\u8BE2\u4E0E\u6267\u884C");
+  cmd.command("execute <sql>").description("\u5F02\u6B65\u6267\u884C SQL \u8BED\u53E5").action(async (sql) => {
+    const opts = cmd.parent.opts();
+    const { client } = createClient(opts);
+    const result = await client.post("/query/execute", { sql });
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("status <execution_id>").description("\u67E5\u8BE2\u6267\u884C\u72B6\u6001").action(async (executionId) => {
+    const opts = cmd.parent.opts();
+    const { client } = createClient(opts);
+    const result = await client.get(`/execution/${executionId}/status`, {});
+    formatOutput(result, opts.pretty);
+  });
+  cmd.command("results <execution_id>").description("\u83B7\u53D6\u6267\u884C\u7ED3\u679C").action(async (executionId) => {
+    const opts = cmd.parent.opts();
+    const { client } = createClient(opts);
+    const result = await client.get(`/execution/${executionId}/results`, {});
+    formatOutput(result, opts.pretty);
+  });
+  return cmd;
+}
+
+// src/index.ts
+var program = new Command11();
+program.name("chainbase").description("Chainbase Web3 API \u547D\u4EE4\u884C\u5DE5\u5177").version("0.1.0").option("--chain <id>", "\u94FE ID\uFF08\u9ED8\u8BA4\u4ECE\u914D\u7F6E\u8BFB\u53D6\uFF0C\u5426\u5219\u4E3A 1\uFF09").option("--pretty", "\u4EE5\u4EBA\u7C7B\u53EF\u8BFB\u683C\u5F0F\u8F93\u51FA", false).option("--page <n>", "\u9875\u7801", "1").option("--limit <n>", "\u6BCF\u9875\u6761\u6570", "20");
+program.addCommand(createConfigCommand());
+program.addCommand(createBlockCommand());
+program.addCommand(createTxCommand());
+program.addCommand(createContractCommand());
+program.addCommand(createAddressCommand());
+program.addCommand(createTokenCommand());
+program.addCommand(createNftCommand());
+program.addCommand(createBalanceCommand());
+program.addCommand(createDomainCommand());
+program.addCommand(createSqlCommand());
+async function main() {
+  try {
+    await program.parseAsync();
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    formatError(message, program.opts().pretty);
+    process.exit(1);
+  }
+}
+main();

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "chainbase-cli",
+  "version": "0.1.0",
+  "description": "CLI for Chainbase Web3 API",
+  "type": "module",
+  "bin": {
+    "chainbase": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "dev": "tsup src/index.ts --format esm --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit"
+  },
+  "files": ["dist"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chainbase-com/chainbase-cli.git"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/chainbase-com/chainbase-cli/issues"
+  },
+  "homepage": "https://github.com/chainbase-com/chainbase-cli#readme",
+  "dependencies": {
+    "axios": "^1.13.5",
+    "chalk": "^5.6.2",
+    "cli-table3": "^0.6.5",
+    "commander": "^14.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  }
+}