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 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,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 `aml_*` / `graph_*` / `meta_*`
108
- / `wallet_*` tools.
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 `aml_address_risk`; the CLI never writes
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, 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)) |
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-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.
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 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
@@ -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',