lifish0/chainfolio

选用指南

AI 根据 README 整理 · 2026/11/5 19:47:26

使用方式

通过命令行使用，支持快照、导出、监控和本地网页仪表盘。

查看 README 依据

| --- | --- | | `chainfolio snapshot` | Fetch balances + prices, print a table | | `chainfolio snapshot --format json` | Same, as JSON | | `chainfolio snapshot --chain base` | Only one chain | | `chainfolio export --format csv --output out.csv` | Write a snapshot to a file | | `chainfolio watch --interval 120` | Poll every 120s, alert on big moves / price thresholds | | `chainfolio serve --port 3000` | Local dashboard at http://localhost:3000 | ## Config `config/wallets.json`: ```json { "wallets": [ { "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",

部署要求

需要 Node.js 20 或更高版本，无需安装依赖。

查看 README 依据

# 1. Create your config from the example (public addresses only!) cp config/wallets.example.json config/wallets.json # 2. Edit config/wallets.json with your wallet addresses # 3. Run it npm start # snapshot in the terminal # or node src/cli.js snapshot --format json ``` Requires **Node.js ≥ 20**. No `npm install` needed — there are no dependencies. > ⚠️ **Never put private keys, seed phrases, or API secrets in `config/wallets.json`.** > chainfolio only needs your *public* wallet addresses to read balances. It never signs anything. ## Commands | Command | What it does |

已知限制

仅支持预定义的代币列表，自定义代币需手动编辑源码；价格来源依赖 CoinGecko，若其不可用则价格显示为 n/a。

查看 README 依据

| BNB Smart Chain | BNB | USDT, USDC, WBNB, CAKE, ETH | | Base | ETH | USDC, WETH, cbETH, DAI | | Arbitrum One | ETH | USDT, USDC, WETH, ARB | | Optimism | ETH | USDT, USDC, WETH, OP, DAI | | Polygon | POL | USDT, USDC.e, WETH, WMATIC, DAI | Token addresses are the canonical deployments — verify on the chain explorer before relying on them for large sums. Add your own in `src/tokens.js`. ## How it works 1. `eth_getBalance` for native assets, `eth_call(balanceOf)` for ERC-20s, via public RPCs. 2. Prices in one batched CoinGecko request, cached for 60 seconds.

- [ ] More chains (Solana via RPC, zkSync, Linea) - [ ] Price source fallback (CoinGecko → DeFiLlama) ## FAQ **Does it need my private key?** No — never. Public addresses only, read-only RPC calls. **Does it send transactions?** No. It never signs or broadcasts anything. **What if CoinGecko is down?** Balances still show; prices show as `n/a` and the last cached price is reused where available. **Why is a token missing?** Either its balance is zero, or it isn't in `src/tokens.js` yet — add it there (address + decimals + CoinGecko id). ## Contributing