@spectratools/etherscan-cli 0.2.4 → 0.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +14 -5
- package/dist/cli.js +645 -190
- package/dist/index.js +1987 -0
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -43,12 +43,13 @@ export ETHERSCAN_API_KEY=your_api_key
|
|
|
43
43
|
|
|
44
44
|
## Command Group Intent Summary
|
|
45
45
|
|
|
46
|
-
- `account` — Wallet balances, normal tx history,
|
|
46
|
+
- `account` — Wallet balances, normal/internal tx history, ERC-20/ERC-721/ERC-1155 transfers
|
|
47
47
|
- `contract` — ABI, verified source, and deployment transaction metadata
|
|
48
48
|
- `tx` — Transaction detail, receipt, and pass/fail status checks
|
|
49
49
|
- `token` — Token metadata, holder distribution, and supply
|
|
50
50
|
- `gas` — Current gas oracle and time-to-confirmation estimates
|
|
51
51
|
- `stats` — ETH price and supply snapshots
|
|
52
|
+
- `logs` — Event log queries with address/topic/block filters
|
|
52
53
|
|
|
53
54
|
## Agent-Oriented Examples
|
|
54
55
|
|
|
@@ -56,20 +57,28 @@ export ETHERSCAN_API_KEY=your_api_key
|
|
|
56
57
|
# 1) Wallet risk scan: balance + recent txs
|
|
57
58
|
etherscan-cli account balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --chain ethereum --format json
|
|
58
59
|
etherscan-cli account txlist 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --chain ethereum --sort desc --offset 20 --format json
|
|
60
|
+
etherscan-cli account internaltx 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --chain ethereum --sort desc --offset 20 --format json
|
|
59
61
|
|
|
60
|
-
# 2)
|
|
62
|
+
# 2) NFT transfer monitoring
|
|
63
|
+
etherscan-cli account nfttx 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --chain ethereum --sort desc --offset 20 --format json
|
|
64
|
+
etherscan-cli account erc1155tx 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --chain ethereum --sort desc --offset 20 --format json
|
|
65
|
+
|
|
66
|
+
# 3) Contract triage for unknown addresses
|
|
61
67
|
etherscan-cli contract creation 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 --chain ethereum --format json
|
|
62
68
|
etherscan-cli contract source 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 --chain ethereum --format json
|
|
63
69
|
|
|
64
|
-
#
|
|
70
|
+
# 4) Tx execution diagnosis
|
|
65
71
|
etherscan-cli tx info 0x1234...abcd --chain abstract --format json
|
|
66
72
|
etherscan-cli tx receipt 0x1234...abcd --chain abstract --format json
|
|
67
73
|
|
|
68
|
-
#
|
|
74
|
+
# 5) Token monitoring loop
|
|
69
75
|
etherscan-cli token info 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 --chain ethereum --format json
|
|
70
76
|
etherscan-cli token holders 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 --offset 25 --chain ethereum --format json
|
|
71
77
|
|
|
72
|
-
#
|
|
78
|
+
# 6) Event log indexing
|
|
79
|
+
etherscan-cli logs get --chain ethereum --address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 --topic0 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55aebec6f6f3c --fromblock 20000000 --toblock latest --offset 25 --format json
|
|
80
|
+
|
|
81
|
+
# 7) Gas-aware scheduling
|
|
73
82
|
etherscan-cli gas oracle --chain abstract --format json
|
|
74
83
|
etherscan-cli gas estimate --gasprice 1000000000 --chain abstract --format json
|
|
75
84
|
```
|