boomkin 0.8.1 → 0.9.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/CHANGELOG.md +16 -0
- package/README.md +74 -130
- package/catalog/providers.json +2298 -0
- package/catalog/skills.json +60 -31
- package/catalog/workflows.json +141 -1
- package/dist/cli.js +2900 -244
- package/docs/AGENT-INDEX.md +39 -0
- package/docs/CHATGPT.md +7 -3
- package/docs/CONNECTIONS.md +30 -10
- package/docs/GETTING-STARTED.md +77 -0
- package/docs/HARNESSES.md +12 -11
- package/docs/IDENTITY.md +2 -2
- package/docs/PROJECTS.md +2 -0
- package/docs/PROVIDERS.md +112 -0
- package/docs/UPDATES.md +52 -56
- package/docs/WEBSITE.md +1 -1
- package/docs/WORKFLOWS.md +105 -1
- package/docs/assets/boomkin-hero.svg +14 -0
- package/llms.txt +34 -0
- package/package.json +15 -3
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,21 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.9.1 · 2026-10-08
|
|
4
|
+
|
|
5
|
+
- Refresh the GitHub and npm introduction with a browser demo, clear installation steps and a public-data first task.
|
|
6
|
+
- Add human and agent documentation indexes, accessible README artwork and current discovery metadata.
|
|
7
|
+
- Update the reviewed catalog to independently published documentation patches for all 17 skill packs.
|
|
8
|
+
- Route Hyperliquid account inspection to its account-monitoring skill.
|
|
9
|
+
- Keep npm commands and the website setup guide aligned; fix the strategy lab heading after an invalid run.
|
|
10
|
+
|
|
11
|
+
## 0.9.0 · 2026-10-08
|
|
12
|
+
|
|
13
|
+
- Add local discovery of 60 providers with primary-source provenance, capability, access, cost and transaction authority metadata.
|
|
14
|
+
- Expand to 27 workflows and 17 reviewed packs containing 48 active skills, including unsigned plans, simulations, Aave V4, payment streams and prediction-market evidence.
|
|
15
|
+
- Add optional Blockscout discovery with 15 explicitly reviewed reads; keep provider selection and connections scoped to the selected profile.
|
|
16
|
+
- Bound public MCP discovery by time, response size and pagination; preserve redacted failures and reject redirected endpoints.
|
|
17
|
+
- Publish source-backed provider documentation and catalogs on the website, and validate tool filters against the pinned native Hermes contract.
|
|
18
|
+
|
|
3
19
|
## 0.8.1 · 2026-10-02
|
|
4
20
|
|
|
5
21
|
- Correct the published README catalog count and list the strategy pack and three new workflows. Keep npm and website installation commands aligned with this patch release.
|
package/README.md
CHANGED
|
@@ -2,191 +2,140 @@
|
|
|
2
2
|
|
|
3
3
|
**Your open-source DeFi desk.**
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Research markets, inspect positions and test a thesis with a native [Hermes agent](https://github.com/NousResearch/hermes-agent). Keep the sources, assumptions and run history in your own profile.
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
[](https://galleonlabs.github.io/boomkin/lab/)
|
|
8
8
|
|
|
9
|
-
[
|
|
9
|
+
**[Try the strategy lab →](https://galleonlabs.github.io/boomkin/lab/)** · [Explore workflows](https://galleonlabs.github.io/boomkin/#workflows) · [Read the docs](https://galleonlabs.github.io/boomkin/docs/)
|
|
10
|
+
|
|
11
|
+
The browser demo needs no installation. Compare daily spot rules, change fees and slippage, and inspect simulated trades using a dated Bitcoin capture, synthetic prices or your own dataset. Uploaded data stays in your browser.
|
|
12
|
+
|
|
13
|
+
**27 workflows · 60 providers in discovery · 17 independent packs · 48 reviewed skills**
|
|
10
14
|
|
|
11
15
|
[](https://github.com/galleonlabs/boomkin/actions/workflows/ci.yml)
|
|
16
|
+
[](https://www.npmjs.com/package/boomkin)
|
|
12
17
|
[](LICENSE)
|
|
13
18
|
|
|
14
19
|
## Get started
|
|
15
20
|
|
|
16
|
-
Use macOS or Linux
|
|
21
|
+
Use macOS or Linux with [Bun](https://bun.sh) 1.3.12+ and Git. Windows users can use WSL2.
|
|
17
22
|
|
|
18
23
|
```bash
|
|
19
|
-
bun install -g boomkin@0.
|
|
24
|
+
bun install -g boomkin@0.9.1
|
|
20
25
|
boomkin onboard
|
|
21
26
|
boomkin doctor --live
|
|
22
27
|
boomkin start
|
|
23
28
|
```
|
|
24
29
|
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
```bash
|
|
28
|
-
git clone https://github.com/galleonlabs/boomkin.git
|
|
29
|
-
cd boomkin
|
|
30
|
-
bun install --frozen-lockfile
|
|
31
|
-
bun run boomkin onboard
|
|
32
|
-
bun run boomkin doctor --live
|
|
33
|
-
bun run boomkin start
|
|
34
|
-
```
|
|
30
|
+
Onboarding prepares `~/.boomkin/hermes`, installs the reviewed packs, configures public CoinGecko data and opens native Hermes model setup. Choose your model provider and sign in there. `start` opens chat in that profile.
|
|
35
31
|
|
|
36
|
-
|
|
32
|
+
CoinGecko is the sole default connection. Model access uses your account or local configuration; optional providers can require credentials, subscriptions or paid requests. Setup creates no wallet, makes no model call and starts no background service.
|
|
37
33
|
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
Model authentication requires your account or local model configuration. Optional providers can require subscriptions, OAuth or scoped credentials. Onboarding makes no model call, pays for no data, creates or funds no wallet, and starts no background service.
|
|
41
|
-
|
|
42
|
-
Useful options:
|
|
43
|
-
|
|
44
|
-
```bash
|
|
45
|
-
bun run boomkin onboard --directory "$HOME/defi-agent" --dry-run
|
|
46
|
-
bun run boomkin onboard --directory "$HOME/defi-agent" --skip-model-setup
|
|
47
|
-
bun run boomkin onboard --directory "$HOME/defi-agent" --no-install
|
|
48
|
-
bun run boomkin model --directory "$HOME/defi-agent"
|
|
49
|
-
```
|
|
34
|
+
[Profiles, install options and source setup](docs/GETTING-STARTED.md) · [Model connections](docs/CONNECTIONS.md)
|
|
50
35
|
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
## Keep the question and the evidence
|
|
36
|
+
## First useful task
|
|
54
37
|
|
|
55
|
-
|
|
38
|
+
Paste this into your new Hermes chat:
|
|
56
39
|
|
|
57
|
-
|
|
58
|
-
boomkin project create --name stablecoin-yields \
|
|
59
|
-
--workflow yield-screen --input-file ./inputs.json
|
|
60
|
-
boomkin project run --name stablecoin-yields --dry-run
|
|
61
|
-
boomkin project run --name stablecoin-yields
|
|
62
|
-
boomkin project check --name stablecoin-yields
|
|
63
|
-
```
|
|
40
|
+
> Use galleon-coingecko-token-research. Resolve CoinGecko ID ethereum and capture a public ETH/USD market observation. Show the asset identity, source URL, observation time and freshness limits. Mark missing data clearly and keep this task read-only.
|
|
64
41
|
|
|
65
|
-
|
|
42
|
+
The result should separate supported observations from unknowns. `doctor --live` establishes public tool discovery; this first task checks whether your configured model can retrieve and explain market evidence.
|
|
66
43
|
|
|
67
44
|
## Pick a job
|
|
68
45
|
|
|
69
46
|
```bash
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
47
|
+
boomkin workflows
|
|
48
|
+
boomkin workflows --protocol Aave
|
|
49
|
+
boomkin workflows --workflow transaction-simulation --json
|
|
50
|
+
boomkin onboard --workflow aave-health
|
|
74
51
|
```
|
|
75
52
|
|
|
76
|
-
|
|
53
|
+
Workflow discovery runs locally. Each job names its inputs, expected result and provider requirements. Selecting a workflow installs its pack and saves that selection for updates. Already copied skills remain; choose a separate `--directory` for a dedicated profile.
|
|
77
54
|
|
|
78
|
-
|
|
|
55
|
+
| You want to… | Start with |
|
|
79
56
|
| --- | --- |
|
|
80
|
-
|
|
|
81
|
-
|
|
|
82
|
-
|
|
|
83
|
-
|
|
|
84
|
-
|
|
|
85
|
-
| `
|
|
86
|
-
| `uniswap-quote` / `bridge-status` | Route review, permissions and settlement evidence |
|
|
87
|
-
| `lido-exit` | Withdrawal NFT ownership, finalization and claimability |
|
|
88
|
-
| `pendle-maturity` / `vault-exit` | Maturity accounting and what can actually be redeemed |
|
|
89
|
-
| `token-research` / `yield-screen` | Contract-based identity and reproducible yield screening |
|
|
90
|
-
| `coinbase-readiness` | CDP/AgentKit capabilities and policy gaps |
|
|
91
|
-
| `hyperliquid-risk` | Venue/account-mode, margin and funding analysis |
|
|
57
|
+
| Capture market evidence or test a rule | `market-snapshot`, `strategy-backtest` |
|
|
58
|
+
| Inspect lending or an exit | `aave-health`, `aave-v4-health`, `morpho-market`, `lido-exit` |
|
|
59
|
+
| Review liquidity and routes | `uniswap-position`, `aerodrome-position`, `across-route` |
|
|
60
|
+
| Screen income or streaming obligations | `yield-screen`, `sablier-stream`, `superfluid-stream` |
|
|
61
|
+
| Review an exact unsigned payload | `unsigned-plan`, `transaction-simulation` |
|
|
62
|
+
| Research prediction markets | `prediction-research`, `prediction-resolution` |
|
|
92
63
|
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
The reviewed catalog contains **15 independent packs and 41 skills**. Install all of them or choose the workflows you need; the agent loads relevant instructions on demand.
|
|
64
|
+
[All 27 workflows, inputs and outputs](docs/WORKFLOWS.md)
|
|
96
65
|
|
|
97
|
-
|
|
98
|
-
| --- | --- |
|
|
99
|
-
| [Infrastructure](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/infra) | RPC, Alchemy, Coinbase, wallet policies and readiness |
|
|
100
|
-
| [Data](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/data) | CoinGecko, DefiLlama and AIXBT research, identity, freshness and source-hashed market captures |
|
|
101
|
-
| [Strategy](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/strategy) | Daily spot simulations, cash flows, costs, drawdown and reproducible benchmarks |
|
|
102
|
-
| [Liquidity provision](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/lp) | Uniswap, Aerodrome, Revert and VFAT position workflows |
|
|
103
|
-
| [Hyperliquid](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/hyperliquid) | Venue-specific analysis, planning, execution, monitoring and review |
|
|
104
|
-
| [Lending](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/lending) | Collateral, borrowing, interest, repayment and liquidation risk |
|
|
105
|
-
| [Staking](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/staking) | Staking, restaking, receipts and withdrawal queues |
|
|
106
|
-
| [Yield](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/yield) | Vault diligence, share accounting and yield sources |
|
|
107
|
-
| [Tokenized assets](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/tokenized-assets) | Asset claims, eligibility, restrictions and redemption |
|
|
108
|
-
| [Routing](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/routing) | Swap and bridge quotes, route limits and settlement |
|
|
109
|
-
| [Derivatives](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/derivatives) | Exposure, margin, funding and venue-specific constraints |
|
|
110
|
-
| [Portfolio](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/portfolio) | Assets, debt, cash flows, performance and rebalance plans |
|
|
111
|
-
| [Security](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/security) | Token diligence, evidence comparisons, transaction effects and permissions |
|
|
112
|
-
| [Payments](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/payments) | Agent payments, x402 challenges and settlement evidence |
|
|
113
|
-
| [Governance](https://github.com/galleonlabs/crypto-defi-skills/tree/main/packages/governance) | Proposals, voting, delegation and execution stages |
|
|
114
|
-
|
|
115
|
-
Start with the protocol workflow matching your task. Use infrastructure and cross-protocol skills when the task needs them. The broader primitive skills use the `galleon-defi-` prefix to avoid upstream name collisions. Read [workflow examples](docs/WORKFLOWS.md) for useful combinations.
|
|
116
|
-
|
|
117
|
-
Each pack is independently versioned and published from [crypto-defi-skills](https://github.com/galleonlabs/crypto-defi-skills). Boomkin's [catalog](catalog/skills.json) records the npm identity, version, immutable source commit, package directory and expected skills. Downloads, installed metadata and every copied supporting file are checked before a successful sync is recorded. Local file digests let `check` and `doctor` detect missing references and changed scripts afterward.
|
|
118
|
-
|
|
119
|
-
Fresh onboarding includes every pack in the checked-out catalog. Select fewer with repeated `--pack` options:
|
|
66
|
+
## Keep the question and the evidence
|
|
120
67
|
|
|
121
|
-
|
|
122
|
-
|
|
68
|
+
Save this public research example as `inputs.json`:
|
|
69
|
+
|
|
70
|
+
```json
|
|
71
|
+
{
|
|
72
|
+
"chain": "Ethereum",
|
|
73
|
+
"asset": "USDC",
|
|
74
|
+
"minimumTvlUsd": "10000000",
|
|
75
|
+
"yieldPreference": "Separate base yield from incentive emissions",
|
|
76
|
+
"limit": 5,
|
|
77
|
+
"question": "What evidence is missing before a deposit decision?"
|
|
78
|
+
}
|
|
123
79
|
```
|
|
124
80
|
|
|
125
|
-
Updates preserve your selection. Future packs are opt-in. To expand an existing installation deliberately:
|
|
126
|
-
|
|
127
81
|
```bash
|
|
128
|
-
|
|
82
|
+
boomkin project create --name stablecoin-yields \
|
|
83
|
+
--workflow yield-screen --input-file ./inputs.json
|
|
84
|
+
boomkin project run --name stablecoin-yields --dry-run
|
|
85
|
+
boomkin onboard --workflow yield-screen --skip-model-setup
|
|
86
|
+
boomkin project run --name stablecoin-yields
|
|
87
|
+
boomkin project check --name stablecoin-yields
|
|
129
88
|
```
|
|
130
89
|
|
|
131
|
-
|
|
90
|
+
Creation and preview make no model or data calls. Onboarding prepares the selected workflow and preserves your configured model. A live run uses that model and your tools, then saves a separate report, raw sources, hashes and unsigned plan. Checks establish the saved evidence contract; they do not certify economic safety or authorize execution. [Project guide](docs/PROJECTS.md)
|
|
132
91
|
|
|
133
|
-
##
|
|
92
|
+
## Discover the right provider
|
|
134
93
|
|
|
135
94
|
```bash
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
bun run boomkin connect --provider defillama
|
|
140
|
-
bun run boomkin connect --provider coinbase
|
|
141
|
-
bun run boomkin connect --provider tenderly
|
|
95
|
+
boomkin providers --search simulation --json
|
|
96
|
+
boomkin providers --capability Data --access keyless
|
|
97
|
+
boomkin providers --provider blockscout
|
|
142
98
|
```
|
|
143
99
|
|
|
144
|
-
|
|
145
|
-
| --- | --- |
|
|
146
|
-
| CoinGecko | Public, keyless MCP configured during onboarding. Its reviewed tools are `execute` and `search_docs`; hosted execution is restricted to the provider's data SDK. |
|
|
147
|
-
| Alchemy | Native Hermes OAuth and explicit tool selection. Select the intended Alchemy app; data/RPC access and wallet/admin actions have different scopes. |
|
|
148
|
-
| AIXBT | Optional crypto intelligence through native Hermes MCP; the key stays in `AIXBT_API_KEY`. Discovery is public; protected research reads require account access. |
|
|
149
|
-
| DeFiLlama | Native Hermes OAuth with an API subscription. Queries consume credits; connecting another client can disconnect the previous client. |
|
|
150
|
-
| Tenderly | Optional paid-plan OAuth with explicit tool selection. Simulations and inspection require the intended project; results persist there. |
|
|
151
|
-
| Coinbase account | Official local MCP through a pinned CLI, with six read tools and a profile-specific configuration/keychain environment. Account credentials remain a separate step. |
|
|
152
|
-
| Agentic Wallet | Separate official `awal` CLI flow for managed wallet and x402 use. Login, wallet creation, funding and spend limits require your choices; see the connection guide. |
|
|
100
|
+
The directory covers 58 studied [skills.eth.sh](https://skills.eth.sh/) entries and two existing connections. Dated sources distinguish authorship, access, cost and authority. Discovery does not install or connect all 60 providers. Keyless access can still cost money; wallet and x402 capabilities need separate choices. [Provider guide](docs/PROVIDERS.md)
|
|
153
101
|
|
|
154
|
-
|
|
102
|
+
## Connect your tools
|
|
155
103
|
|
|
156
104
|
```bash
|
|
157
|
-
|
|
105
|
+
boomkin connect --provider blockscout
|
|
106
|
+
boomkin doctor --live
|
|
158
107
|
```
|
|
159
108
|
|
|
160
|
-
|
|
109
|
+
Blockscout adds optional keyless explorer reads. Other supported connections include AIXBT, Alchemy, DeFiLlama, Tenderly and Coinbase account data, each with its own setup and access boundary. Restart Hermes after changing MCP settings.
|
|
161
110
|
|
|
162
|
-
|
|
111
|
+
Hermes owns tools and authentication. MCP tool selection does not constrain its terminal or replace provider-enforced account and spending limits. [Exact prerequisites and connection scope](docs/CONNECTIONS.md)
|
|
163
112
|
|
|
164
|
-
##
|
|
113
|
+
## Skill packs
|
|
165
114
|
|
|
166
|
-
|
|
115
|
+
Boomkin installs reviewed releases from [crypto-defi-skills](https://github.com/galleonlabs/crypto-defi-skills): agent plans, prediction markets, infrastructure, data, strategy, liquidity, Hyperliquid, lending, staking, yield, tokenized assets, routing, derivatives, portfolio, security, payments and governance.
|
|
167
116
|
|
|
168
|
-
|
|
117
|
+
Each pack installs independently. The [catalog](catalog/skills.json) pins its package, version, immutable source commit and expected skills. Installation checks the copied supporting files; later integrity checks reveal missing or modified instructions and scripts.
|
|
169
118
|
|
|
170
|
-
|
|
119
|
+
Fresh onboarding includes all 17 packs. Repeated `--pack` options choose fewer; updates preserve that selection and future packs remain opt-in. Hermes supplies the native runtime, sessions, memory and model setup. [Other harnesses](docs/HARNESSES.md) receive portable skills only.
|
|
171
120
|
|
|
172
121
|
## Updates and recovery
|
|
173
122
|
|
|
174
123
|
```bash
|
|
175
|
-
bun
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
124
|
+
bun install -g boomkin@0.9.1
|
|
125
|
+
boomkin check --directory "$HOME/.boomkin/hermes"
|
|
126
|
+
boomkin update --directory "$HOME/.boomkin/hermes"
|
|
127
|
+
boomkin doctor --directory "$HOME/.boomkin/hermes" --live
|
|
179
128
|
```
|
|
180
129
|
|
|
181
|
-
|
|
130
|
+
Update Boomkin, selected skill packs and Hermes separately. Preserve local skill edits before updates. [Updates, backups and recovery](docs/UPDATES.md)
|
|
182
131
|
|
|
183
|
-
|
|
132
|
+
## ChatGPT authentication
|
|
184
133
|
|
|
185
|
-
|
|
134
|
+
Use `boomkin chatgpt --action login` and `--action status` for native Hermes ChatGPT OAuth. Model selection stays with Hermes. [The authentication guide](docs/CHATGPT.md) distinguishes sign-in, partner plan consent and verified usage attribution.
|
|
186
135
|
|
|
187
136
|
## Contributing
|
|
188
137
|
|
|
189
|
-
Bug reports, clearer guides
|
|
138
|
+
Bug reports, clearer guides and focused pull requests are welcome. [Contributing guide](CONTRIBUTING.md) · [Issues](https://github.com/galleonlabs/boomkin/issues) · [Private security reporting](SECURITY.md)
|
|
190
139
|
|
|
191
140
|
### Local development
|
|
192
141
|
|
|
@@ -194,17 +143,12 @@ Bug reports, clearer guides, new workflows and focused pull requests are welcome
|
|
|
194
143
|
bun install --frozen-lockfile
|
|
195
144
|
bun run check
|
|
196
145
|
bun run build
|
|
197
|
-
bun run smoke
|
|
198
146
|
```
|
|
199
147
|
|
|
200
|
-
|
|
148
|
+
Run the [change-specific checks](CONTRIBUTING.md#work-locally) before a pull request. Agents can start with [the documentation index](docs/AGENT-INDEX.md) and [AGENTS.md](AGENTS.md).
|
|
201
149
|
|
|
202
150
|
## License and credit
|
|
203
151
|
|
|
204
|
-
[MIT licensed](LICENSE)
|
|
205
|
-
|
|
206
|
-
See [reuse and attribution](ATTRIBUTION.md) for a ready-to-copy credit line. If Boomkin helps your work, [a star on the original repository](https://github.com/galleonlabs/boomkin) is appreciated and entirely optional.
|
|
207
|
-
|
|
208
|
-
## ChatGPT authentication
|
|
152
|
+
[MIT licensed](LICENSE). Created by [Andrew Wilkinson](https://andrewwilkinson.io) and [Galleon Labs](https://github.com/galleonlabs). Preserve copyright and license notices when reusing the project; [attribution guidance](ATTRIBUTION.md) includes an optional credit line. A repository star is appreciated and entirely optional.
|
|
209
153
|
|
|
210
|
-
|
|
154
|
+
Documentation copy controls were inspired by [Rare UI](https://www.rareui.com/components/code-block) and implemented independently.
|