Releases: ObolNetwork/obol-stack
v0.11.0 - Agents for hire
v0.11.0 — Agents for hire
Permanent storefront URLs, multi-currency offerings, and cheaper remote inference providers, let agent businesses improve their retention, incentivization, and profit margins.
v0.11.0 widens both ends of the agent marketplace. On the supply side, a bring-your-own-key provider registry turns obol model setup into a one-command on-ramp to hosted inference — Openrouter, Venice, NVIDIA NIM, NVIDIA GMI, Novita and Hugging Face — so a capable agent no longer needs a local GPU or the most expensive of remote inference. On the demand side, a single service can now be priced and paid in multiple currencies across multiple networks (USDC via EIP-3009, OBOL via Permit2, on Base and mainnet, others if configured manually), and persistent Cloudflare tunnels are secured and simplified so your agent sells from a permanent domain.
Get started with obol sell demo for a hello-world service, then obol model setup and obol sell demo quant to put a model-backed agent up for sale. Tag @Obol_Collective on X with your storefront URL and maybe we'll check it out. 👀 Once you've services up and running on a permanent URL, consider listing them on x402scan.
Note
Base Sepolia ETH faucet · Base Sepolia USDC faucet. This release also wires a Base Sepolia OBOL faucet for testing OBOL-priced offers.
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 this release
OBOL_RELEASE=v0.11.0 bash <(curl -s https://stack.obol.org)
# Run the stack
obol stack init && obol stack up
# Bring your own inference provider (Openrouter, Venice, NVIDIA NIM/GMI, Novita, HF)
obol model setup
# Stand up a paid service and an agent that uses that model
obol sell demo
obol sell demo quant
# Hand over to your Claude and build an agent business of your own
claude
/plugin marketplace add ObolNetwork/skills
/plugin install obol@obol
"Help me sell a service on the Obol Stack that agents will pay for."Release Highlights
Bring your own key — one command to use many inference providers
obol model setup is now a guided BYOK on-ramp backed by a provider registry: pick Openrouter, Venice, NVIDIA NIM, NVIDIA GMI, Novita, or Hugging Face, and the CLI opens the provider's sign-up page when you don't yet have a key.
obol model setupThis is the fastest way to give your stack a capable model without hosting one, and it's the foundation every paid agent offer builds on.
Multi-currency, multi-network services — priced and settled in the tokens your buyers hold
An offer can now advertise multiple payment assets across multiple networks instead of a single currency. Buyers pay in what they already hold; settlement is USDC (EIP-3009) or OBOL (Permit2) on Base and mainnet, gated by x402.
Permanent storefronts — persistent Cloudflare tunnels, simplified
Tunnel setup is secured and streamlined so your agent sells from a permanent domain instead of an ephemeral quick-tunnel. Walkthrough in the permanent-url guide.
Ecosystem — sell from your editor
Install the Obol skills into Claude and let it package and sell services for you:
/plugin marketplace add ObolNetwork/skills
/plugin install obol@obolSmaller wins
- Remote-signer secret handling — fixed secret-modification path; chart + image bumped.
- Controller regression guard — a test pins the
NetworkPolicyGVR mapping so agent provisioning can't silently wedge. - Frontend
v0.1.27— storefront/UI refresh bundled in. - Ethereum clients — reth bumped to
v2.3.0plus EL/CL client updates for local nodes.
Breaking changes / Migration notes
-
No schema or volume-ownership breaks since v0.10.0 — upgrading in place is expected to work.
-
Pre-release tester warning: If you ran an unreleased marketplace or chart-consolidation branch before this release,
obol stack upmay fail with Helminvalid ownership metadataerrors for resources that moved into thebasechart. This is not a supported production migration path. Back up anything you need, then recreate:obol stack export obol stack down obol stack purge --force obol stack init obol stack up
What's Changed
- test(controller): guard resourceFor NetworkPolicy GVR mapping by @bussyjd in #631
- feat: obol buy inference — BYOK onboarding (Venice, OpenRouter & co.) on a single provider registry by @bussyjd in #638
- feat(remote-signer): fix secret modification by @OisinKyne in #643
- feat(tunnel): simplify tunnel setup by @OisinKyne in #645
- chore(docker): bump images by @OisinKyne in #647
- chore(deps): update ethereum el/cl client updates by @github-actions[bot] in #604
- chore(network): bump ethereum reth image to v2.3.0 by @bussyjd in #652
- feat: sell and buy services in multiple currencies + networks by @OisinKyne in #655
- chore(frontend): bump obol-stack-front-end image to v0.1.27 by @HananINouman in #660
Full Changelog: v0.10.0...v0.11.0
v0.11.0-rc1 - Multi-currency businesses
v0.11.0-rc1 — Agents with permanent storefronts and multi currency offerings
Permanent storefront URLs, and cheaper remote inference providers, allows for agent businesses to improve their retention and profit margins.
This is a release candidate for Obol's upcoming v0.11.0. This release introduces a number of alternative upstream inference providers for the stack, including Openrouter, Venice, NVIDIA NIM, NVIDIA GMI, Novita, and Hugging Face. This release also secures and simplifies the setup of persistent CloudFlare tunnels for your agents, such that you can get them selling on a permanent domain with ease. Check out the guide for doing so here.
Get started selling services from your stack with obol sell demo to sell a basic hello-world service, and if you have a capable model setup (locally or remotely, use obol model setup), run obol sell demo quant to sell a basic Obol Agent that can answer on-chain queries. Tag @Obol_Collective on X with your storefront URL and maybe we'll check it out. 👀
Once the demos work, your next step is to build your own agent businesses. What alpha will you create, package, and sell to the growing agentic economy? A Polymarket sharp, a Bankr Bot analyst, a Uniswap Unicorn, an expert on all things Base, or your favourite DeFi app? You show us. Read more about selling services in our docs, and send your feedback and feature wishlist here.
Note
Base Sepolia ETH faucet · Base Sepolia USDC faucet. This release also wires a Base Sepolia OBOL faucet for testing OBOL-priced offers.
Important
Upgrading an existing stack? Pre-existing clusters must be recreated — this release line changed how cluster volumes are owned. See Breaking changes / Migration notes before running obol stack up with the new CLI.
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 this release
OBOL_RELEASE=v0.11.0-rc1 bash <(curl -s https://stack.obol.org)
# Run the stack
obol stack init && obol stack up
# Sell something
obol sell demo
# Setup a remote model unless your local one is fast enough
obol model setup
# Now sell a demo agent that leverages that model
obol sell demo quant
# Chat with your agent, (maybe tell it to buy one of its services to see it work)
obol hermes chat
# Next hand over to your Claude, install the skills, and make an agent business of your own
claude
/plugin marketplace add ObolNetwork/skills
/plugin install obol@obol
"Help me sell a service on the Obol Stack that agents will pay for."What's Changed
- chore(deps): update ethereum el/cl client updates by @github-actions[bot] in #604
- chore(network): bump ethereum reth image to v2.3.0 by @bussyjd in #652
- feat: sell and buy services in multiple currencies + networks by @OisinKyne in #655
- chore(frontend): bump obol-stack-front-end image to v0.1.27 by @HananINouman in #660
Full Changelog: v0.11.0-rc0...v0.11.0-rc1
v0.11.0-rc0
v0.11.0-rc0 — Agents with permanent storefronts
Permanent storefront URLs, and cheaper remote inference providers, allows for agent businesses to improve their retention and profit margins.
This is a release candidate for Obol's upcoming v0.11.0. This release introduces a number of alternative upstream inference providers for the stack, including Openrouter, Venice, NVIDIA NIM, NVIDIA GMI, Novita, and Hugging Face. This release also secures and simplifies the setup of persistent CloudFlare tunnels for your agents, such that you can get them selling on a permanent domain with ease. Check out the guide for doing so here.
Get started selling services from your stack with obol sell demo to sell a basic hello-world service, and if you have a capable model setup (locally or remotely, use obol model setup), run obol sell demo quant to sell a basic Obol Agent that can answer on-chain queries. Tag @Obol_Collective on X with your storefront URL and maybe we'll check it out. 👀
Once the demos work, your next step is to build your own agent businesses. What alpha will you create, package, and sell to the growing agentic economy? A Polymarket sharp, a Bankr Bot analyst, a Uniswap Unicorn, an expert on all things Base, or your favourite DeFi app? You show us. Read more about selling services in our docs, and send your feedback and feature wishlist here.
Note
Base Sepolia ETH faucet · Base Sepolia USDC faucet. This release also wires a Base Sepolia OBOL faucet for testing OBOL-priced offers.
Important
Upgrading an existing stack? Pre-existing clusters must be recreated — this release line changed how cluster volumes are owned. See Breaking changes / Migration notes before running obol stack up with the new CLI.
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 this release
OBOL_RELEASE=v0.11.0-rc0 bash <(curl -s https://stack.obol.org)
# Run the stack
obol stack init && obol stack up
# Sell something
obol sell demo
# Setup a remote model unless your local one is fast enough
obol model setup
# Now sell a demo agent that leverages that model
obol sell demo quant
# Chat with your agent, (maybe tell it to buy one of its services to see it work)
obol hermes chat
# Next hand over to your Claude, install the skills, and make an agent business of your own
claude
/plugin marketplace add ObolNetwork/skills
/plugin install obol@obol
"Help me sell a service on the Obol Stack that agents will pay for."What's Changed
- test(controller): guard resourceFor NetworkPolicy GVR mapping by @bussyjd in #631
- feat: obol buy inference — BYOK onboarding (Venice, OpenRouter & co.) on a single provider registry by @bussyjd in #638
- feat(remote-signer): fix secret modification by @OisinKyne in #643
- feat(tunnel): simplify tunnel setup by @OisinKyne in #645
- chore(docker): bump images by @OisinKyne in #647
Full Changelog: v0.10.0...v0.11.0-rc0
v0.10.0 — Agents that earn
v0.10.0 — Agents that earn
Sellers know more than buyers about their products. This is true for agents too. This release allows stack users to sell specialised agents alongside their x402 APIs.
v0.10.0 is the release where Obol agents become economic actors. They sell services over x402 micropayments — raw inference, whole agents, gated HTTP APIs, and MCP tool calls.
Get started selling services from your stack with obol sell demo to sell a basic hello-world service, and if you have a capable model setup (locally or remotely, use obol model setup), run obol sell demo quant to sell a basic Obol Agent that can answer on-chain queries. Tag @Obol_Collective on X with your storefront URL and maybe we'll check it out. 👀
Once the demos work, your next step is to build your own agent businesses. What alpha will you create, package, and sell to the growing agentic economy? A Polymarket sharp, a Bankr Bot analyst, a Uniswap Unicorn, an expert on all things Base, or your favourite DeFi app? You show us. Read more about selling services in our docs, and send your feedback and feature wishlist here.
Note
Base Sepolia ETH faucet · Base Sepolia USDC faucet. This release also wires a Base Sepolia OBOL faucet for testing OBOL-priced offers.
Important
Upgrading an existing stack? Pre-existing clusters must be recreated — this release line changed how cluster volumes are owned. See Breaking changes / Migration notes before running obol stack up with the new CLI.
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 this release
OBOL_RELEASE=v0.10.0 bash <(curl -s https://stack.obol.org)
# Run the stack
obol stack init && obol stack up
# Sell something
obol sell demo
# Setup a remote model unless your local one is fast enough
obol model setup
# Now sell a demo agent that leverages that model
obol sell demo quant
# Chat with your agent, (maybe tell it to buy one of its services to see it work)
obol hermes chat
# Next hand over to your Claude, install the skills, and make an agent business of your own
claude
/plugin marketplace add ObolNetwork/skills
/plugin install obol@obol
"Help me sell a service on the Obol Stack that agents will pay for."Release Highlights
Agents selling to agents — the full commerce loop
The buy and sell sides both landed. A stack can publish a paid service and another stack can pay for it, end to end:
# Seller — gate any model, agent, HTTP API, or MCP tool behind x402
obol sell inference my-model --per-mtok 0.50 --chain base-sepolia --pay-to 0x...
obol sell http my-api --upstream svc --port 8080 --per-request 0.001 --pay-to 0x...
obol sell agent quant --price 0.001 --chain base-sepolia # sell a whole agent
obol sell mcp weather --price 0.001 ... # sell one tool, key stays server-side
# Buyer — discover, pay, and spend from inside an agent
buy.py probe <seller-url>
buy.py pay-agent <seller-url> --model <id> --message 'summarize the docs' # streaming, one-shot
obol buy inference <seller-url> [--token USDC|OBOL] [--set-default] # wires paid/<model> via a sidecar poolPayment is USDC (EIP-3009) on Base or mainnet, or OBOL (Permit2) on mainnet.
Agent namespace isolation — your agent's keys and API, sandboxed
Every agent business (obol agent new / obol sell agent) runs behind an agent-isolation NetworkPolicy with an "internet-open, cluster-closed" shape. Each agent business is a sealed tenant:
- Agent A cannot reach Agent B — not its Hermes API, and crucially not its remote-signer, the process that holds the wallet key. Cross-agent traffic is denied by default.
- Paid traffic reaches only the agent's API, never the signer. The endpoint that takes money is exposed through the tunnel; the endpoint that holds keys isn't reachable from outside the namespace at all.
- Egress is allowlisted to exactly what an agent needs — DNS, LiteLLM, chain RPC via eRPC, Traefik, and the public internet for skills/facilitators — while the cloud instance-metadata endpoint (
169.254.169.254) is blocked, so semi-untrusted skill code can't SSRF a node's IAM credentials. - Defense in depth: a per-agent remote-signer bearer token is provisioned alongside the policy.
An operator can now run a dozen agents — each with its own wallet, skills, and customers — and know a compromise of one won't drain or impersonate another. Future versions will grant more fine grained LLM spend management for your agent businesses.
Paid MCP tools without exposing your API key — obol sell mcp
Any credentialed HTTP service can be resold to agents per call as a paid MCP tool. The buyer's tool arguments are forwarded to your backend with your API key injected server-side — the credential is never sent to buyers. Payment rides in-band in the MCP request's _meta, and the wrapper runs verify → execute → settle inside the tool call, so a caller is never charged for a failed tool.
Discover, register, and front your storefront
Offers publish discovery metadata the rest of the network can find: a /skill.md catalog, an /api/services.json feed, and an ERC-8004 on-chain registration (obol sell register) served from /.well-known/agent-registration.json. A Next.js storefront landing page fronts the tunnel hostname with clickable service endpoints, and obol tunnel setup is now a real wizard for binding a persistent hostname. Let us know how these storefronts can be more compelling and user/agent-friendly.
Smaller wins
pay-agentstreaming — agents re-emit a remote agent's reply token-by-token; long replies keep tunnels alive instead of timing out on a buffered body.- Per-offer payment clock —
--max-timeout(up to 24h) flows into the 402, so long-running paid work no longer has to fit in a 60s window. - Path-conflict protection — two offers can no longer silently shadow each other on the verifier's route table; first-claimant-wins is explicit, and the CLI fails fast before anything is created.
- Reboot & recreation resilience —
obol sell resume(andobol stack up) replay every persisted offer;obol stack export/obol stack importcapture a whole stack — agents, wallets, config, and offers — into one archive. - Model ergonomics — a freshly configured model auto-promotes to the agents' primary;
obol model preferpins ordering. - HA-safe controller — client-go leader election so the serviceoffer-controller can scale without double-reconciling.
- Friendlier ops — disk-pressure handling, and
obol stack down/purgenow confirm when services are actively serving traffic.
Security hardening
- Agent namespace isolation (see Highlights) — cross-agent and signer access denied by default; IMDS egress blocked; per-agent signer bearer auth.
- Controller Secret RBAC scoped to named secrets — the serviceoffer-controller can no longer enumerate arbitrary Secrets; cross-namespace wallet reads are denied, and
ca-certificates/x402-buyer-adminwere dropped from the agent allow-list. - Cross-namespace
spec.agent.refrejected — an offer can't point at an Agent in another namespace to borrow its identity. - Restricted Pod Security Standard across embedded workloads — non-root, no privilege escalation, dropped capabilities.
- Hardened
obol stack import— symlink-target escapes and decompression bombs are rejected, so importing an untrusted archive can't write outside the extraction root or fill the disk.
CLI changes
New commands
obol sell agent— wrap an Agent CR in atype=agentServiceOffer (sell a whole agent).obol sell resume— replay every persisted offer after a host reboot (--install-boot-uniton Linux).obol sell pricing | register | identity | info— quote prices, publish ERC-8004 registration, manage identity, print buyer instructions.obol stack export/obol stack import— back up and restore a full stack (agents, wallets, config, offers).obol sell mcp— run an x402-paid MCP tool server (forwards to a backend, injects your key server-side).obol agent new(aliasonboard) — declare a CRD-backed sub-agent via--model,--skills,--objective,--create-wallet.obol model prefer— pin one or more models to the head of the agents' model list.
Changed flags / behavior
obol buy inference [<seller-url>]— seller URL is now positional; auto-resolves model + token from the catalog, supports--token OBOL,--set-default,--cost-cap, and opt-in identity verification via--expected-agent-id.obol model setup— a freshly configured model auto-promotes to the agents' primary (no separatepreferstep needed for the common case).obol stack down/obol stack purge— prompt for confirmation when offers are actively serving traffic;purge --forcenow offers a full stack export first.obol sell http --max-timeout— payment window is configurable per offer (default 300s, up to 24h).
Renamed / removed / deprecated
hermes token→obol agent auth(aliastoken) — token retrieval mo...
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.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
v0.6.0 Local First Agents
v0.6.0 — Local Agents for Ethereum
This is the Obol Stack's v0.6.0 release. It allows you to run AI agents on your own hardware with local-first inference and decentralised infrastructure.
Highlights
- Qwen 3.5 as default local model —
obol model setupnow also recommendsqwen3.5:9b, a strong general-purpose model that runs well on consumer hardware. (~12GB of RAM, up to 256k context) - LiteLLM gateway — replaced llmspy with LiteLLM, an industry-standard OpenAI-compatible proxy with wildcard routing, provider fallbacks, and broad model support
- Smart model hierarchy — cloud models (Anthropic, OpenAI) automatically become the primary when added via
obol model setup, with local models as fallbacks - Sell-side monetization —
obol sellenables pay-per-request access to local compute via x402 micropayments (USDC on Base Sepolia) - Buy-side payments — x402-buyer sidecar with pre-signed ERC-3009 authorizations for bounded, zero-signer-access spending
- On-chain agent registration — ERC-8004 Identity Registry on Base Sepolia with
obol sell register - Agent discovery skill — agents can search the ERC-8004 registry to find and purchase services from other agents
- Base Network Support - Adds Coinbase's Base network as a default free RPC
What's New
LLM Routing
- LiteLLM with wildcard routing (
anthropic/*,openai/*) — add a provider once, use any model obol model syncpushes LiteLLM model list to all OpenClaw instances via host-side file patching (hot-reload, no pod restart)obol model setupauto-detects Ollama models and registers them in LiteLLM- Tool calling support through LiteLLM for Ollama models
Monetize (x402)
- Full sell → discover → buy → settle roundtrip tested end-to-end
- ServiceOffer CRD with 6-stage reconciliation (monetize.py)
- x402-verifier ForwardAuth middleware for Traefik Gateway API
- Buyer sidecar with pre-signed authorization pool
Infrastructure
- Pinned Ethereum client versions for reproducible deployments
- Local networks registered in eRPC with proper aliases
- Disabled default public tunnel (opt-in via
obol tunnel provision) - Remote-signer chart bumped to 0.3.0
- OpenClaw chart 0.1.7 with LiteLLM defaults and model fallback support
CLI
obol sell— inference, http, list, status, stop, delete, pricing, registerobol model sync— refresh OpenClaw model lists from LiteLLMobol model pull— interactive model selection with pull progress- Renamed:
obol rpc→obol network,obol monetize→obol sell
Upgrade
OBOL_RELEASE=v0.6.0 ./obolup.sh
obol stack init && obol stack up
# To upgrade from a local model to a remote anthropic or openAI model
obol model setupWhat's Changed
- Local networks in erpc with proper alias by @OisinKyne in #247
- Fix ethereum chart, pin version by @OisinKyne in #248
- Pin Ethereum client versions by @OisinKyne in #249
- feat: replace llmspy with LiteLLM as LLM gateway by @bussyjd in #243
- Update llm selection to ensure if you add a remote one it takes priority by @OisinKyne in #252
- Upgrade just one chart by @OisinKyne in #242
- Fix flicker and password prompt by @OisinKyne in #253
- Add Obol's Base env by @OisinKyne in #254
- Fix unbound variable crash by @OisinKyne in #255
Full Changelog: v0.5.0...v0.6.0
Release v0.5.0
v0.5.0 — Selling on Ethereum
This is the Obol Stack's v0.5.0 release. This release begins the support for x402 payments on Base Sepolia testnet. An upcoming v0.6.0 will roll out wider support on mainnet and Base mainnet, and a further update will add flexibility to the assets that you can pay in, and resources you can pay for.
Get started with the quickstart guide here.
Warning
The Obol Stack is in early alpha, please expect breaking changes. Do not use the stack with must-work applications, nor should you give Obol Agents more crypto that you are comfortable with them losing. The x402 feature is very early and under-documented, YMMV.
Upgrading
bash <(curl -s https://stack.obol.org)
obol stack up
obol openclaw syncWhat's Changed
- Fix OpenAI inference through llmspy by @bussyjd in #214
- feat: secure enclave inference, x402 monetization, and ERC-8004 registration by @OisinKyne in #218
- Bump remote signer chart by @OisinKyne in #240
- Simplify erpc by @OisinKyne in #241
- Prep for a change to upstream erpc by @OisinKyne in #233
- Updates for rc3 by @OisinKyne in #244
- Disable default public tunnel by @OisinKyne in #245
- Fix network installation by @OisinKyne in #246
Full Changelog: v0.4.0...v0.5.0


