chain-insights 0.43.1 → 0.44.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 +17 -40
- package/bin/install.cjs +3 -5
- 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/public-tools-CZyeptJQ.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 +5 -7
- package/docs/graph-tools.md +27 -43
- package/docs/mcp-proxy.md +11 -28
- package/docs/stability.md +5 -5
- package/package.json +1 -1
- package/skills/chain-insights-cypher/SKILL.md +170 -418
- package/skills/chain-insights-cypher/agents/openai.yaml +1 -1
- package/dist/tool-visibility-Dn91j_gP.mjs.map +0 -1
- package/skills/chain-insights-address-risk/SKILL.md +0 -47
- package/skills/chain-insights-schema-evm/SKILL.md +0 -644
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,22 +45,16 @@ 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
|
|
61
53
|
local Chain Insights MCP proxy on your computer over stdio
|
|
62
54
|
(`chain-insights-mcp-proxy` from the npm package, through `npx`), and brings the
|
|
63
|
-
`chain-insights-cypher`
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
Insights Graph for the data.
|
|
55
|
+
`chain-insights-cypher` skill. The proxy serves the views itself (a graph, a
|
|
56
|
+
chart or a table, picked from the column names of a `graph_query` answer, and
|
|
57
|
+
the balance), and reaches the Chain Insights Graph for the data.
|
|
67
58
|
|
|
68
59
|
- **Runs in:** Claude Desktop, Cowork sessions on your computer, and Claude Code.
|
|
69
60
|
- **Cannot start it:** claude.ai on the web, the Claude mobile apps and Cowork
|
|
@@ -104,8 +95,8 @@ Owns:
|
|
|
104
95
|
|
|
105
96
|
- The `cia` / `chain-insights` CLI and the `chain-insights-mcp-proxy` MCP
|
|
106
97
|
server (source under `src/`).
|
|
107
|
-
- The canonical public tool surface: prefixed `
|
|
108
|
-
|
|
98
|
+
- The canonical public tool surface: prefixed `graph_*` / `meta_*` /
|
|
99
|
+
`wallet_*` tools.
|
|
109
100
|
- Local wallet and payment on Base mainnet (payment chain only).
|
|
110
101
|
- Shipped product skills under `skills/` (`chain-insights-*`), packaged
|
|
111
102
|
into the npm tarball.
|
|
@@ -115,8 +106,7 @@ Never touches:
|
|
|
115
106
|
- Blockchain indexing, graph database storage, or graph serving — those
|
|
116
107
|
belong to the Chain Insights Graph backend.
|
|
117
108
|
- Automatic risk labeling. Address labels are served by the Chain Insights
|
|
118
|
-
Graph backend and read through `
|
|
119
|
-
labels.
|
|
109
|
+
Graph backend and read through `graph_query`; the CLI never writes labels.
|
|
120
110
|
- Custodial wallets or hosted case databases. Investigation data stays with
|
|
121
111
|
the caller.
|
|
122
112
|
|
|
@@ -124,7 +114,6 @@ Never touches:
|
|
|
124
114
|
|
|
125
115
|
| Tool | Use it for |
|
|
126
116
|
| --------------------------- | ---------------------------------------------------------------------------------- |
|
|
127
|
-
| `aml_address_risk` | Screen one address for risk, behavior, neighborhood context, and exchange exposure |
|
|
128
117
|
| `graph_query` | Run one read-only GQL/Cypher query against a Chain Insights Graph layer |
|
|
129
118
|
| `graph_query_batch` | Run related read-only graph queries as one MCP call |
|
|
130
119
|
| `meta_network_capabilities` | Check supported Chain Insights networks and graph tools |
|
|
@@ -188,7 +177,7 @@ Graph queries choose the read graph explicitly:
|
|
|
188
177
|
|
|
189
178
|
| Graph | Use it for |
|
|
190
179
|
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
191
|
-
| `topology` | The unified address / FLOWS_TO / OPERATED_BY / LINKED graph — recent and full historical fund-flow traversal,
|
|
180
|
+
| `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
181
|
| `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
182
|
|
|
194
183
|
One rule is worth reading before writing a query by hand: the `network`
|
|
@@ -199,9 +188,9 @@ on `:Address` without an exact address must scope itself with
|
|
|
199
188
|
database and `Address` carries no `network` property at all. See
|
|
200
189
|
[Graph query compatibility](docs/graph-query-compatibility.md).
|
|
201
190
|
|
|
202
|
-
Agent installs include `chain-insights-
|
|
203
|
-
|
|
204
|
-
|
|
191
|
+
Agent installs include `chain-insights-cypher` for graph-query dialect rules,
|
|
192
|
+
one query for each kind of graph search, and how to find the fields of the
|
|
193
|
+
EVM / Robinhood graph.
|
|
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
|
@@ -49,17 +49,15 @@ const homeDir = os.homedir()
|
|
|
49
49
|
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
|
-
const PUBLIC_SKILL_NAMES = Object.freeze([
|
|
53
|
-
'chain-insights-address-risk',
|
|
54
|
-
'chain-insights-cypher',
|
|
55
|
-
'chain-insights-schema-evm',
|
|
56
|
-
])
|
|
52
|
+
const PUBLIC_SKILL_NAMES = Object.freeze(['chain-insights-cypher'])
|
|
57
53
|
const RETIRED_SKILL_NAMES = Object.freeze([
|
|
54
|
+
'chain-insights-address-risk',
|
|
58
55
|
'chain-insights-bittensor-cypher',
|
|
59
56
|
'chain-insights-developer-experience',
|
|
60
57
|
'chain-insights-investigation',
|
|
61
58
|
'chain-insights-monitoring',
|
|
62
59
|
'chain-insights-schema-bittensor',
|
|
60
|
+
'chain-insights-schema-evm',
|
|
63
61
|
'ci-status',
|
|
64
62
|
'test-chain-insights-graph',
|
|
65
63
|
])
|