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 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, a CIA workflow, and the
40
- available remote graph tools for Robinhood.
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` and `chain-insights-schema-evm` skills. The proxy
64
- serves the views itself (a graph, a chart or a table, picked from the column
65
- names of a `graph_query` answer, and the balance), and reaches the Chain
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 `aml_*` / `graph_*` / `meta_*`
108
- / `wallet_*` tools.
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 `aml_address_risk`; the CLI never writes
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, the node `risk_score`/`risk_level` verdict, and swap, liquidity-pool and bridge totals (see [Graph tools](docs/graph-tools.md#swaps-liquidity-pools-and-bridges)) |
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-address-risk` for one-address
203
- screens, `chain-insights-cypher` for graph-query dialect rules, and
204
- `chain-insights-schema-evm` for the EVM / Robinhood graph map.
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 screen from any directory:
246
+ Run a first query from any directory:
271
247
 
272
248
  ```bash
273
- cia workflow aml-address-risk \
274
- --address 0xYourAddressHere --network robinhood
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, a.risk_level AS risk_level LIMIT 10"
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
  ])