chain-insights 0.43.1 → 0.44.0
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 +13 -36
- package/bin/install.cjs +1 -1
- package/dist/apps/claude-view.html +14 -14
- package/dist/cli.cjs +4 -5
- package/dist/cli.mjs +4 -5
- package/dist/cli.mjs.map +1 -1
- package/dist/mcp-proxy.cjs +8 -90
- package/dist/mcp-proxy.d.cts.map +1 -1
- package/dist/mcp-proxy.d.mts.map +1 -1
- package/dist/mcp-proxy.mjs +8 -90
- package/dist/mcp-proxy.mjs.map +1 -1
- package/dist/{tool-visibility-CDehLWWI.cjs → tool-visibility-CDe-ft0L.cjs} +2 -8
- package/dist/{tool-visibility-Dn91j_gP.mjs → tool-visibility-P9wETx-d.mjs} +3 -9
- package/dist/tool-visibility-P9wETx-d.mjs.map +1 -0
- package/docs/contributing.md +2 -3
- package/docs/graph-query-compatibility.md +1 -2
- package/docs/graph-tools.md +15 -33
- package/docs/mcp-proxy.md +11 -27
- package/docs/stability.md +5 -5
- package/package.json +1 -1
- package/skills/chain-insights-cypher/SKILL.md +114 -429
- package/skills/chain-insights-schema-evm/SKILL.md +109 -212
- package/dist/tool-visibility-Dn91j_gP.mjs.map +0 -1
- package/skills/chain-insights-address-risk/SKILL.md +0 -47
package/README.md
CHANGED
|
@@ -28,16 +28,13 @@ as-is on macOS; on Windows use WSL.
|
|
|
28
28
|
```bash
|
|
29
29
|
npx chain-insights@latest --help # run without installing
|
|
30
30
|
npm install -g chain-insights # or install the cia CLI globally
|
|
31
|
-
cia workflows # list high-level CIA workflow tools
|
|
32
|
-
cia workflow aml-address-risk \
|
|
33
|
-
--address 0xYourAddressHere --network robinhood
|
|
34
31
|
cia networks # network status + dataset overview
|
|
35
32
|
cia network robinhood # details for one network
|
|
36
33
|
cia mcp tools # list remote graph tools
|
|
37
34
|
```
|
|
38
35
|
|
|
39
|
-
Sixty seconds gets you the CLI, a network overview,
|
|
40
|
-
|
|
36
|
+
Sixty seconds gets you the CLI, a network overview, and the available remote
|
|
37
|
+
graph tools for Robinhood.
|
|
41
38
|
To call the same tools from an agent, register the MCP proxy:
|
|
42
39
|
`cia setup claude-code` (or `claude-desktop` / `codex` / `hermes`).
|
|
43
40
|
|
|
@@ -48,13 +45,8 @@ script needs indented JSON:
|
|
|
48
45
|
cia mcp call --json graph_query \
|
|
49
46
|
network=robinhood \
|
|
50
47
|
"query=USE topology MATCH (a:Address) RETURN a.address AS address LIMIT 10"
|
|
51
|
-
cia workflow aml-address-risk --json \
|
|
52
|
-
--address 0xYourAddressHere --network robinhood
|
|
53
48
|
```
|
|
54
49
|
|
|
55
|
-
The AML address-risk contract uses the latest version when `version` is
|
|
56
|
-
omitted. Pin the current contract with `--version v1` on the workflow command.
|
|
57
|
-
|
|
58
50
|
### Claude plugin
|
|
59
51
|
|
|
60
52
|
The `plugin/` folder is the Chain Insights plugin for Claude. It starts the
|
|
@@ -104,8 +96,8 @@ Owns:
|
|
|
104
96
|
|
|
105
97
|
- The `cia` / `chain-insights` CLI and the `chain-insights-mcp-proxy` MCP
|
|
106
98
|
server (source under `src/`).
|
|
107
|
-
- The canonical public tool surface: prefixed `
|
|
108
|
-
|
|
99
|
+
- The canonical public tool surface: prefixed `graph_*` / `meta_*` /
|
|
100
|
+
`wallet_*` tools.
|
|
109
101
|
- Local wallet and payment on Base mainnet (payment chain only).
|
|
110
102
|
- Shipped product skills under `skills/` (`chain-insights-*`), packaged
|
|
111
103
|
into the npm tarball.
|
|
@@ -115,8 +107,7 @@ Never touches:
|
|
|
115
107
|
- Blockchain indexing, graph database storage, or graph serving — those
|
|
116
108
|
belong to the Chain Insights Graph backend.
|
|
117
109
|
- Automatic risk labeling. Address labels are served by the Chain Insights
|
|
118
|
-
Graph backend and read through `
|
|
119
|
-
labels.
|
|
110
|
+
Graph backend and read through `graph_query`; the CLI never writes labels.
|
|
120
111
|
- Custodial wallets or hosted case databases. Investigation data stays with
|
|
121
112
|
the caller.
|
|
122
113
|
|
|
@@ -124,7 +115,6 @@ Never touches:
|
|
|
124
115
|
|
|
125
116
|
| Tool | Use it for |
|
|
126
117
|
| --------------------------- | ---------------------------------------------------------------------------------- |
|
|
127
|
-
| `aml_address_risk` | Screen one address for risk, behavior, neighborhood context, and exchange exposure |
|
|
128
118
|
| `graph_query` | Run one read-only GQL/Cypher query against a Chain Insights Graph layer |
|
|
129
119
|
| `graph_query_batch` | Run related read-only graph queries as one MCP call |
|
|
130
120
|
| `meta_network_capabilities` | Check supported Chain Insights networks and graph tools |
|
|
@@ -188,7 +178,7 @@ Graph queries choose the read graph explicitly:
|
|
|
188
178
|
|
|
189
179
|
| Graph | Use it for |
|
|
190
180
|
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
191
|
-
| `topology` | The unified address / FLOWS_TO / OPERATED_BY / LINKED graph — recent and full historical fund-flow traversal,
|
|
181
|
+
| `topology` | The unified address / FLOWS_TO / OPERATED_BY / LINKED graph — recent and full historical fund-flow traversal, and swap, liquidity-pool and bridge totals (see [Graph tools](docs/graph-tools.md#swaps-liquidity-pools-and-bridges)) |
|
|
192
182
|
| `facts` | Bounded individual `TRANSFER` rows with amount, `amount_usd`, asset, transaction, and block facts, plus single `SWAP`, `LIQUIDITY_ADD`, `LIQUIDITY_REMOVE` and `BRIDGE_CROSSING` rows |
|
|
193
183
|
|
|
194
184
|
One rule is worth reading before writing a query by hand: the `network`
|
|
@@ -199,9 +189,8 @@ on `:Address` without an exact address must scope itself with
|
|
|
199
189
|
database and `Address` carries no `network` property at all. See
|
|
200
190
|
[Graph query compatibility](docs/graph-query-compatibility.md).
|
|
201
191
|
|
|
202
|
-
Agent installs include `chain-insights-
|
|
203
|
-
|
|
204
|
-
`chain-insights-schema-evm` for the EVM / Robinhood graph map.
|
|
192
|
+
Agent installs include `chain-insights-cypher` for graph-query dialect rules
|
|
193
|
+
and `chain-insights-schema-evm` for the EVM / Robinhood graph map.
|
|
205
194
|
|
|
206
195
|
## Billing: Billable Units
|
|
207
196
|
|
|
@@ -222,19 +211,6 @@ cut off. When you see `truncated: true`:
|
|
|
222
211
|
- Page through results with `SKIP` to fetch the next batch.
|
|
223
212
|
- Add a tighter `WHERE` filter before raising the limit.
|
|
224
213
|
|
|
225
|
-
**Workflow tools carry a `usage` block.** `aml_address_risk` runs many graph
|
|
226
|
-
queries behind the scenes to answer one question. Every response includes a
|
|
227
|
-
`usage` block with the total cost of all of them:
|
|
228
|
-
|
|
229
|
-
- **`billable_units`** — total units billed across every internal graph
|
|
230
|
-
query this workflow ran.
|
|
231
|
-
- **`query_count`** — how many internal graph queries it took.
|
|
232
|
-
- **`truncated_queries`** — how many of those internal queries hit their
|
|
233
|
-
row limit and got cut off.
|
|
234
|
-
|
|
235
|
-
Use `usage` to see the real cost of a workflow call, not just of one
|
|
236
|
-
`graph_query`.
|
|
237
|
-
|
|
238
214
|
## Prerequisites And Environment Setup
|
|
239
215
|
|
|
240
216
|
- **Linux** is the reference platform; shell snippets use bash (macOS works
|
|
@@ -267,11 +243,12 @@ cia --version
|
|
|
267
243
|
cia update --check
|
|
268
244
|
```
|
|
269
245
|
|
|
270
|
-
Run a first
|
|
246
|
+
Run a first query from any directory:
|
|
271
247
|
|
|
272
248
|
```bash
|
|
273
|
-
cia
|
|
274
|
-
|
|
249
|
+
cia mcp call graph_query \
|
|
250
|
+
network=robinhood \
|
|
251
|
+
"query=USE topology MATCH (a:Address) RETURN a.address AS address LIMIT 10"
|
|
275
252
|
```
|
|
276
253
|
|
|
277
254
|
Create a local payment wallet when paid access is needed:
|
|
@@ -291,7 +268,7 @@ Example queries. Direct topology:
|
|
|
291
268
|
```bash
|
|
292
269
|
cia mcp call graph_query \
|
|
293
270
|
network=robinhood \
|
|
294
|
-
"query=USE topology MATCH (a:Address) RETURN a.address AS address, a.network AS network, a.labels AS labels
|
|
271
|
+
"query=USE topology MATCH (a:Address) RETURN a.address AS address, a.network AS network, a.labels AS labels LIMIT 10"
|
|
295
272
|
```
|
|
296
273
|
|
|
297
274
|
Batch across graph views:
|
package/bin/install.cjs
CHANGED
|
@@ -50,11 +50,11 @@ const dataDir = path.join(homeDir, '.chain-insights')
|
|
|
50
50
|
const configPath = path.join(dataDir, 'config.json')
|
|
51
51
|
const srcSkillsDir = path.join(__dirname, '..', 'skills')
|
|
52
52
|
const PUBLIC_SKILL_NAMES = Object.freeze([
|
|
53
|
-
'chain-insights-address-risk',
|
|
54
53
|
'chain-insights-cypher',
|
|
55
54
|
'chain-insights-schema-evm',
|
|
56
55
|
])
|
|
57
56
|
const RETIRED_SKILL_NAMES = Object.freeze([
|
|
57
|
+
'chain-insights-address-risk',
|
|
58
58
|
'chain-insights-bittensor-cypher',
|
|
59
59
|
'chain-insights-developer-experience',
|
|
60
60
|
'chain-insights-investigation',
|