v0.12.0-rc1 - Custom Storefronts

v0.12.0-rc1 — Make the storefront yours

Brand your storefront, sell it from more than one domain, and give the agents shopping it a cleaner buy flow.

v0.11.0 opened up the agent marketplace — bring-your-own-key inference, multi-currency offers, and permanent Cloudflare tunnels. v0.12.0 builds on that shopfront: set your storefront's name, tagline, and logo, expose it on more than one domain, and a tidier buy experience for the agents purchasing your services — plus payment-correctness and dependency fixes.

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 on a permanent URL, consider listing them on x402scan.

Note

Base Sepolia ETH faucet · Base Sepolia USDC faucet.

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.12.0-rc1 bash <(curl -s https://stack.obol.org)

# Run the stack
obol stack init && obol stack up

# Brand your storefront, then preview it as buyers see it
obol sell info set --display-name "Acme Labs" --tagline "Paid APIs." --logo-url "https://acme.example/logo.png"
obol sell info

# Stand up a paid service and an agent that uses a model
obol sell demo
obol sell demo quant

---

Release Highlights

Storefront branding — name, tagline, and logo

obol sell info set sets your storefront's display name, tagline, and logo. They flow into the public catalog (/api/services.json), the storefront landing page, and its OpenGraph/social preview. obol sell info shows the storefront and everything on sale exactly as buyers see it, and obol sell info <name> focuses a single service with how-to-buy instructions.

obol sell info set --display-name "Acme Labs" --tagline "Paid APIs."
obol sell info

Sell from more than one domain — multi-hostname tunnels

obol tunnel hostname add puts your storefront on additional domains without disturbing the ones already live, obol tunnel hostname list shows them, and obol tunnel delete tears a tunnel down cleanly. Headless setups now reuse an existing cloudflared cert.

Cleaner buy flow

HTTP service cards link straight to Swagger UI and openapi.json, and the buy prompts are clearer — they require a real task and tidy up the agent, inference, and HTTP copy.

---

Smaller wins

• Base Sepolia USDC payments — corrected the USDC EIP-712 domain name to "USDC" (it's FiatTokenV2_2, not mainnet's "USD Coin"), so real facilitators accept otherwise-valid signatures.
• Multi-currency --accept — stopped cli/v3 from comma-splitting a multi-currency --accept value, so multi-token offers parse whole.
• x402 Go SDK — bumped to /v2 (v2.16.0).
• Frontend v0.1.28-rc0 — storefront/UI refresh bundled in.
• Dependency & client bumps — Hermes agent, cloudflared, Gateway API v1.6.0, Ethereum EL/CL clients, Aztec, and the obolup.sh toolchain (kubectl, helm, k3d, helmfile, k9s, ollama).

Breaking changes / Migration notes

• /api/services.json is now an envelope, not a bare array: { "displayName", "tagline", "logoUrl", "services": [ … ] } (services moved under the services key). This backs storefront branding, and there is no backward compatibility — update sellers and buyers together (obol update on every stack). A current buyer against an un-upgraded seller (still serving the old array) will fail to read the catalog.
• No schema or volume-ownership breaks since v0.10.0 — upgrading in place is otherwise expected to work.

---

What's Changed

• fix(hermes): unblock pay-agent buys from obol.stack chat by @HananINouman in #684
• feat(agent): fix sub-agent hang, improve guide prompts by @OisinKyne in #685
• fix(x402): accept x402 v2 PAYMENT-SIGNATURE header in ForwardAuth verifier by @bussyjd in #689
• Revert "fix(x402): accept x402 v2 PAYMENT-SIGNATURE header in ForwardAuth verifier" by @OisinKyne in #691
• chore(frontend): pin dashboard image to v0.1.28-rc1 by @HananINouman in #692
• integration(x402): buyer-funnel stack + v2 PAYMENT-SIGNATURE (supersedes #686–689) by @bussyjd in #690

Full Changelog: v0.12.0-rc0...v0.12.0-rc1