Releases: ObolNetwork/obol-stack
Release v0.10.0-rc1
v0.10.0-rc1 — Agents selling to agents
This is a release candidate for Obol's upcoming v0.10.0. It introduces the ability to sell agent based services over x402.
Get started selling services from your stack with obol sell demo. Tag @Obol_Collective on X with your storefront and maybe we'll check it out.
Warning
This software is early alpha, you could lose what you put in. Please use caution when it comes to (non-testnet) assets.
Install / Upgrade
# Install the latest versions
OBOL_RELEASE=v0.10.0-rc0 bash <(curl -s https://stack.obol.org)
# Run the stack
obol stack init && obol stack up
# Try out selling some demo 'Hello World' services
obol sell demo
# And if you want to hand over to your Claude
claude
/plugin marketplace add ObolNetwork/skills
/plugin install obol@obol
"Hey Claude, help me sell services on the Obol Stack that people want to pay for. Make no mistakes."What's Changed
- chore(docker): bump image tags by @OisinKyne in #467
Full Changelog: v0.10.0-rc0...v0.10.0-rc1
v0.10.0-rc0 - Agent Services
v0.10.0-rc0 — Agents selling to agents
This is a release candidate for Obol's upcoming v0.10.0. It introduces the ability to sell agent based services over x402.
Get started selling services from your stack with obol sell demo. Tag @Obol_Collective on X with your storefront and maybe we'll check it out.
Warning
This software is early alpha, you could lose what you put in. Please use caution when it comes to (non-testnet) assets.
Install / Upgrade
# Install the latest versions
OBOL_RELEASE=v0.10.0-rc0 bash <(curl -s https://stack.obol.org)
# Run the stack
obol stack init && obol stack up
# Try out selling some demo 'Hello World' services
obol sell demo
# And if you want to hand over to your Claude
claude
/plugin marketplace add ObolNetwork/skills
/plugin install obol@obol
"Hey Claude, help me sell services on the Obol Stack that people want to pay for. Make no mistakes."What's Changed
- feat(tunnel): make remote setup a real wizard by @bussyjd in #457
- chore: bump frontend to v0.1.23 and hermes-agent to v2026.5.7 by @bussyjd in #461
- feat(storefront): make service endpoint clickable by @bussyjd in #462
- fix(serviceoffer-controller): harden agent reconciliation and storefront by @bussyjd in #463
- feat(stack): selective image rebuild, Claude plugin tip, demo agent model pin by @bussyjd in #464
- fix(serviceoffer-controller): align remote-signer config with v0.3.0 image by @bussyjd in #465
- ci(renovate): add scheduled Renovate workflow by @bussyjd in #460
Full Changelog: v0.9.1-rc0...v0.10.0-rc0
v0.9.1-rc0
What's Changed
- fix(defaults): resolve host gateway via Docker for Colima/Rancher Desktop by @apham0001 in #432
- feat: add Base Sepolia OBOL faucet contracts by @bussyjd in #443
- feat: wire Base Sepolia OBOL faucet env by @bussyjd in #447
- fix: lower Base Sepolia OBOL faucet default amount by @bussyjd in #448
- fix: hermes PVC ownership on Linux k3d + bootstrap ingress URL by @nickh-obol in #446
- chore(frontend): bump frontend image to v0.1.21-rc1 by @bussyjd in #449
- integration: validate tunnel onboarding with live OBOL faucet flow by @bussyjd in #452
- Add release description template by @bussyjd in #456
Full Changelog: v0.9.0...v0.9.1-rc0
v0.9.0 — $OBOL is money
v0.9.0 — $OBOL is money
The obol or obolus (Ancient Greek: ὀβολός) was a form of ancient Greek currency and weight. - Wikipedia
This release introduces the Hermes agent framework by NousResearch, along with support for $OBOL gasless payments on mainnet in obol sell commands, and introduces some demo services to sell for new users to quickly host some sample local agent services they can iterate on later.
Get started selling services from your stack with obol sell demo. Tag @Obol_Collective on X with your storefront and maybe we'll check it out.
Warning
This software is early alpha, you could lose what you put in. Please use caution when it comes to (non-testnet) assets.
Install / Upgrade
# Install the latest versions
OBOL_RELEASE=v0.9.0 bash <(curl -s https://stack.obol.org)
# Run the stack
obol stack init && obol stack up
# Try out selling some demo 'Hello World' services
obol sell demo
# And if you want to hand over to your Claude
claude
/plugin marketplace add ObolNetwork/skills
/plugin install obol@obol
"Hey Claude, help me sell services on the Obol Stack that people want to pay for. Make no mistakes."Release Highlights
🤝 obol sell demo — your first paid endpoint, in one command
The headline of v0.9.0 obol sell demo deploys a small HTTP service into the cluster, gates it behind x402, registers it on a Cloudflare quick tunnel, waits for the offer to reach Ready=True, and prints copy-paste try-it instructions for both curl and the Python x402 SDK.
obol sell demo # hello @ 1 OBOL/req on Ethereum mainnetUse it as the canonical "Hello World" for agent commerce. Once you've watched a paid request settle end-to-end, the same machinery (obol sell inference / obol sell http) wraps anything in your cluster.
💸 $OBOL micropayments with sponsored gas on mainnet
Buyers paying in $OBOL on Ethereum mainnet sign an EIP-2612 permit off-chain. The Obol-operated x402 facilitator (x402.gcp.obol.tech) batches that permit with the on-chain transfer at settlement time. Buyers never spend ETH on gas and skip the one-time approve(Permit2, max) step that most ERC-20 payment flows require. Sellers receive $OBOL directly into their agent wallet.
This is the most concretely better-than-card UX the stack ships: sign a message, pay in OBOL, neither party touches a gas token. Combined with obol sell demo, it's the shortest path to a working agent-to-agent commerce loop. Now its time for agentic founders to build the digital services of the next economy.
🤖 Hermes is now the default agent runtime
Obol Stack 0.9.0 makes Hermes the default Obol Agent. obol stack up provisions a hermes-obol-agent namespace with its own Ethereum signing wallet, a built-in skill set, and an interactive chat TUI:
obol hermes chat # interactive chat with the default agent
obol hermes setup # wire up Telegram / Discord / Slack messaging
obol hermes skills list # live skill catalogueobol hermes <anything> is a passthrough to the in-cluster Hermes binary. OpenClaw remains supported as an alternate runtime — obol agent new --runtime openclaw if you want one.
🧩 Claude Code plugin — ObolNetwork/skills
If you use Claude Code, you can now install the Obol skills as a plugin and let Claude drive your stack:
/plugin marketplace add ObolNetwork/skills
/plugin install obol@obol
The run-obol-stack skill teaches Claude how to install, bring up, debug, and operate the stack — including walking through obol sell demo, registering on ERC-8004, and resolving stuck pods. Source: github.com/ObolNetwork/skills.
Smaller wins
obol model setup custom— point LiteLLM at any OpenAI-compatible endpoint (vLLM, sglang, mlx-lm, a remote GPU box). The setup flow validates the endpoint and rewires the default agent to it in one command.- Auto-configured LiteLLM during
stack up— host Ollama models are detected and registered with sensible ranking (chat-capable models ahead of:cloudaliases, embedding models last). No more "agent picked an unusable cloud model on first boot." - Public storefront refresh — Next.js + Tailwind landing page on the tunnel hostname showing live
ServiceOffers with try-it code snippets. - Preserving public tunnels —
obol stack upnow detects an active Cloudflare quick tunnel and skips redeployingcloudflaredif one's healthy
What's Changed
- chore(openclaw): bump remote-signer chart to 0.3.1 by @bussyjd in #374
- Harden release smoke flows by @bussyjd in #376
- chore: trim duplication and dead code ahead of v0.9.0 by @bussyjd in #375
- ci(x402): fix Trivy security-scan tag mismatch by @bussyjd in #356
- chore: bump frontend image to v0.1.17-rc.4 by @bussyjd in #382
- chore: bump frontend image to v0.1.17-rc.5 by @bussyjd in #383
- Integrate PR #377 (OBOL Permit2) + PR #381 (Hermes runtime), harden flows, add flow-13 dual-stack OBOL by @bussyjd in #386
- First commit towards a demo sell command by @OisinKyne in #355
- Move agent lifecycle UX under obol agent by @bussyjd in #385
- test(flows): tighten live OBOL smoke by @bussyjd in #401
- Update buy/sell skill to be more than just inference by @OisinKyne in #403
- feat(model): enable Anthropic prompt caching by default by @bussyjd in #404
- fix(flows): route OBOL QA through explicit LLM endpoint by @bussyjd in #405
- improve demo sell command by @OisinKyne in #407
- Allow hermes messaging by @OisinKyne in #408
- fix(store): being served old docker images and not detecting a new one by @OisinKyne in #409
- fix: simplify Hermes recreation lifecycle by @bussyjd in #413
- rc8: reconcile stack QA fixes by @bussyjd in #417
- feat(storefront): link previews and metadata by @OisinKyne in #420
- fix(tunnel): warn before invalidating active quick tunnel URL by @bussyjd in #424
- feat(model): auto-discover local OpenAI-compatible inference servers by @bussyjd in #422
- Updates from rc9 test pass by @OisinKyne in #427
- feat(buyer): if a user requests html, give them html by @OisinKyne in #428
- Update with fixes by @OisinKyne in #431
- Fix base registrations, pretty cli sell status by @OisinKyne in #433
- fix(litellm): forgetting api keys on restart by @OisinKyne in #436
- Feedback from another obol buy by @OisinKyne in #438
- Hanan/fix bugs by @HananINouman in #437
New Contributors
- @HananINouman made their first contribution in #343
Full Changelog: v0.8.1...v0.9.0
v0.9.0-rc11
v0.9.0-rc11 — Hermes + $OBOL
The eleventh release candidate for the upcoming v0.9.0. This release introduces the hermes agent framework by NousResearch, along with support for $OBOL gasless payments on mainnet in obol sell commands, and introduces some demo services to sell for new users to quickly host some sample local agent services they can iterate on later.
Get started selling services from your stack with obol sell demo. Tag @Obol_Collective on X with your storefront and maybe we'll check it out.
Warning
This software is early alpha, you could lose what you put in. Please use caution when it comes to (non-testnet) assets.
Upgrade
OBOL_RELEASE=v0.9.0-rc11 bash <(curl -s https://stack.obol.org)
obol stack init && obol stack upWhat's Changed
- Update with fixes by @OisinKyne in #431
Full Changelog: v0.9.0-rc10...v0.9.0-rc11
Release v0.9.0-rc9
v0.9.0-rc9 — Hermes + OBOL
The ninth release candidate for the upcoming v0.9.0. This release introduces the hermes agent framework by NousResearch, along with support for $OBOL on mainnet in obol sell commands, and introduces some demo services to sell for new users to quickly host some sample local agent services they can iterate on later.
Get started selling services from your stack with obol sell demo.
Note
You can get Base Sepolia Eth here and Base Sepolia USDC here. The OBOL Permit2 path uses a fork-local OBOL ERC20Permit token; no public bridged OBOL deployment is required.
Warning
This software is early alpha, you could lose what you put in. Please use caution when it comes to (non-testnet) assets.
Upgrade
OBOL_RELEASE=v0.9.0-rc9 bash <(curl -s https://stack.obol.org)
obol stack init && obol stack upWhat's Changed
- fix(tunnel): warn before invalidating active quick tunnel URL by @bussyjd in #424
- feat(model): auto-discover local OpenAI-compatible inference servers by @bussyjd in #422
Full Changelog: v0.9.0-rc8...v0.9.0-rc9
v0.9.0-rc10
v0.9.0-rc10 — Hermes + $OBOL
The tenth release candidate for the upcoming v0.9.0. This release introduces the hermes agent framework by NousResearch, along with support for $OBOL gasless payments on mainnet in obol sell commands, and introduces some demo services to sell for new users to quickly host some sample local agent services they can iterate on later.
Get started selling services from your stack with obol sell demo. Tag @Obol_Collective on X with your storefront and maybe we'll check it out.
Warning
This software is early alpha, you could lose what you put in. Please use caution when it comes to (non-testnet) assets.
Upgrade
OBOL_RELEASE=v0.9.0-rc10 bash <(curl -s https://stack.obol.org)
obol stack init && obol stack upWhat's Changed
- Updates from rc9 test pass by @OisinKyne in #427
- feat(buyer): if a user requests html, give them html by @OisinKyne in #428
Full Changelog: v0.9.0-rc9...v0.9.0-rc10
v0.8.1 — ERC-8004 Remote-Signer Compatibility Fix
v0.8.1 — ERC-8004 Remote-Signer Compatibility Fix
Patch release for v0.8.0. Fixes ERC-8004 registration transaction signing against remote-signer v0.2.0 by restoring the canonical decimal-string transaction request format.
Upgrade
OBOL_RELEASE=v0.8.1 bash <(curl -s https://stack.obol.org)
obol stack init && obol stack upWhat's Changed
- fix(erc8004): use canonical string signer contract
Full Changelog: v0.8.0...v0.8.1
v0.8.0 — Agent Payments on Base and Mainnet
v0.8.0 — Agent Payments on Base and Mainnet
This release gives Obol Agents the ability to sell inference and http services via x402 payments on Base and Mainnet. Agents can now discover and register themselves on ERC-8004 registries, along with their services to sell. These can be exposed through a cloudflare tunnel with an obol sell command. Like:
obol sell http my-service-for-sale --upstream my-service.openclaw-obol-agent.svc.cluster.local --port 8090 --wallet <your agents wallet> --price 0.001 --chain base
Registration is on by default; pass --no-register to skip the ERC-8004 step.
Note
You can get Base Sepolia Eth here and Base Sepolia USDC here. Human gated so you'll have to get it for your agent.
Warning
This software is early alpha, you could lose what you put in. Please use caution when it comes to (non-testnet) assets.
Upgrade
OBOL_RELEASE=v0.8.0 bash <(curl -s https://stack.obol.org)
obol stack init && obol stack upWhat's Changed
- feat: unified credential detection — interactive menu + CLAUDE_CODE_OAUTH_TOKEN fallback by @bussyjd in #283
- fix: update trivy-action to safe SHA (v0.35.0) by @apham0001 in #285
- security: pin LiteLLM to v1.82.3 (supply chain compromise) by @bussyjd in #289
- feat: CLI agent-readiness optimizations (#268) by @OisinKyne in #284
- feat: CLI agent-readiness optimizations (#268) by @OisinKyne in #291
- fix: install script improvements by @nickh-obol in #292
- Fix bug reports, bump deps by @OisinKyne in #310
- feat(inference): auto-detect local providers in obol sell inference by @bussyjd in #308
- fix: harden PR #310 — log chown errors, path validation, Trivy precision by @bussyjd in #311
- feat: monetization path — sell inference (M1), autoresearch (M2), indexing (M3) by @bussyjd in #288
- Bump frontend, fix 443 issue, and another string issue by @OisinKyne in #318
- Build serviceoffer-controller image by @OisinKyne in #319
- release: merge v0.8.0-rc3 integration branch to main by @bussyjd in #335
- feat: default commerce paths to base mainnet by @bussyjd in #338
- Kody reveiw fixes by @OisinKyne in #341
- docs: clean up internal docs and refresh CRD specs by @bussyjd in #344
- x402 pre-merge follow-up: seller gateway, unsettled metric, verifyOnly warning by @bussyjd in #345
- Opus's fixes to the fixes by @OisinKyne in #354
- feat(x402): buyer-side settlement, HoldSign/ReleaseSpend auth lifecycle by @HananINouman in #343
- fix(erc8004): align with canonical remote-signer string contract by @bussyjd in #359
- fix: aggregate ERC-8004 registration services by @bussyjd in #363
- feat(buy): add agent-managed autorefill reconcile loop by @bussyjd in #364
- fix(serviceoffer): drop orphan shared-registration tests by @bussyjd in #366
- Better error for methods that require the cluster to be running by @OisinKyne in #353
- fix(serviceoffer): restore ERC-8004 registration aggregation by @bussyjd in #367
- fix(flows): verify Bob funding confirms + eRPC reflects it before buy by @bussyjd in #368
- chore(openclaw): bump to v2026.4.21 + chart 0.4.0 by @bussyjd in #370
- fix(flows): auto-pick free ports in flow-11, auto-load .env in lib.sh by @bussyjd in #371
- chore(renovate): track openclaw + remote-signer helm chart pins by @bussyjd in #369
- test(x402-buyer): make ConfirmSpendFailure test work under uid 0 by @bussyjd in #373
- chore(openclaw): bump remote-signer chart to 0.3.1 by @bussyjd in #374
New Contributors
- @apham0001 made their first contribution in #285
- @nickh-obol made their first contribution in #292
- @HananINouman made their first contribution in #343
Full Changelog: v0.7.0...v0.8.0
v0.7.0 - Agent Payments
v0.7.0 — Agent Payments
This release gives Obol Agents the ability to sell inference and http services via x402 payments on Base (and Base Sepolia). Agents can now discover and register themselves on ERC-8004 registries, along with their services to sell. These can be exposed through a cloudflare tunnel with an obol sell command. Like:
obol sell http my-service-for-sale --upstream my-service.openclaw-obol-agent.svc.cluster.local --port 8090 --wallet <your agents wallet> --price 0.001 --chain base-sepolia --register
Note
You can get Base Sepolia Eth here and Base Sepolia USDC here. Human gated so you'll have to get it for your agent.
Warning
This software is early alpha, you could lose what you put in. Please use caution when it comes to (non-testnet) assets.
Highlights
- Agent Registry dashboard — browse on-chain registered agents from the ERC-8004 Identity Registry, filter by x402 payment support or protocol (MCP, A2A, Web)
- Per-MTok pricing — sell inference with token-based pricing (
--per-mtok), not just flat per-request - Wallet backup & restore —
obol openclaw wallet backup/restorefor remote-signer key management - 60-70% token savings — optimized heartbeat reduces daily LLM consumption through compact output and throttled discovery
What's New
Agent Registry (Frontend v0.1.14)
New collapsible Agent Registry section on the dashboard, powered by the 8004scan public API:
- Rich agent cards with avatar, name, description, owner, service endpoints
- x402 badge — identifies payment-gated inference services at a glance
- Filter chips —
x402(client-side),MCP,A2A,Web(server-side via 8004scan) - Free-text search + auto-refresh every 30s
- Sell Inference modal — create ServiceOffer CRs from the browser (no CLI needed)
Payment-Gated Inference
Full commerce loop: sell → 402 → EIP-712 sign → x402-rs facilitator → USDC settled → 200 + inference.
obol sell httpwith--per-mtokand--per-requestpricing- Static
paid/*LiteLLM route through x402-buyer sidecar - Pre-signed ERC-3009 authorization pool (bounded spending, zero signer access)
- Works both via
obol.stack:8080and through Cloudflare tunnel
ERC-8004 Agent Identity
- On-chain registration on Base Sepolia Identity Registry
- OASF-enriched
.well-known/agent-registration.jsonwith skills/domains taxonomy - On-chain metadata:
x402.supported,service.type discovery.py search --x402-onlyfor indexed agent discovery- CLI flags:
--register-skills,--register-domains
Heartbeat Efficiency (#263)
~60-70% reduction in daily LLM token consumption:
monetize.py process --all --quick— single-line compact output- Buy-side discovery throttled to ~every 10 minutes (was every heartbeat)
buy.py maintainreplaces separatebalance+listcalls- Heartbeat interval 1m → 2m
Wallet Management (#260)
obol openclaw wallet backup <id>— encrypted backup with AES-256-GCMobol openclaw wallet restore <id> --input <file>— restore + restart remote-signer- Passphrase-protected or plaintext backup modes
Infrastructure
| Component | Version |
|---|---|
| OpenClaw | v2026.3.13-1 |
| Frontend | v0.1.14 |
| obolup.sh | OpenClaw 2026.3.13-1 |
Upgrade
OBOL_RELEASE=v0.7.0 bash <(curl -s https://stack.obol.org)
obol stack init && obol stack upWhat's Changed
- feat: BDD integration tests + upstream auth injection + tunnel URL by @bussyjd in #256
- Reflect user feedback by @OisinKyne in #259
- Adds
obol openclaw wallet backupandobol openclaw wallet restoreby @OisinKyne in #260 - Add static paid x402 gateway and per-MTok pricing support by @bussyjd in #262
- feat: zero-config stack setup + OASF-enriched ERC-8004 registration by @bussyjd in #257
- perf: optimize heartbeat for token efficiency by @bussyjd in #263
- feat: /skill.md agent-optimized service catalog by @bussyjd in #266
- feat: PR #267 reviewed + model auto-config + security fixes by @bussyjd in #271
Full Changelog: v0.6.0...v0.7.0


