Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Buy via the Boson dApp · Boson Protocol
Skip to content

Buy via the Boson dApp

The simplest way to buy on Boson without writing code. Open bosonapp.io, connect a wallet, browse offers, commit, redeem.

1. Connect a wallet

MetaMask, WalletConnect, or any EIP-1193 provider. The dApp prompts you to switch to the right chain — currently Polygon for production. See Concepts → Networks & ConfigIds for the full list.

2. Browse offers

Three entry points:

  • All sellers — the dApp's main marketplace view.
  • Direct seller URL — bosonapp.io/#/store/<sellerId> or a seller's custom storefront (see Sellers → Sell via the Boson dApp → Storefront).
  • Direct offer URL — shared from search, social, or a partner site.

Token-gated offers display a lock icon. Hover or click to see what token / balance is required.

3. Commit

  1. Click Commit on an offer.
  2. If it's an ERC-20 offer, the dApp prompts an Approve transaction first (granting the Diamond an allowance). If you've already approved enough, this step is skipped.
  3. Commit — your wallet pays offer.price. The dApp builds and broadcasts the transaction.
  4. The dApp mints you an rNFT (voucher) which appears in your wallet. The exchange is now in COMMITTED state.

If anything reverts ("offer voided", "sold out", "gating condition not met"), the dApp surfaces a friendly message.

For the code equivalent: Build → Buyers → Commit to an offer.

4. Wait for delivery → Redeem

When the goods arrive (physical), or when you're ready (digital), come back to the dApp and click Redeem on your exchange.

The dApp may prompt you for delivery info on this step (shipping address, email) which it sends to the seller via XMTP.

Redeeming transitions the exchange to REDEEMED and starts the dispute window. The voucher (rNFT) is burned.

5. Optional — raise a dispute

If the goods aren't right, within the dispute window:

  1. Redeem first (you can't dispute an unredeemed exchange — use Cancel instead).
  2. Open the exchange → Raise dispute.
  3. The dApp guides you through mutual resolution (offer a buyerPercent), then escalation if needed.

See Concepts → Dispute state machine and Build → Buyers → Raise a dispute.

When to graduate to code

  • You're buying programmatically — for an agent, a procurement system, a bot.
  • You need scripted retries / idempotency.
  • You want to bridge from another wallet system (HSM, MPC, smart account).

Switch to Tooling → Core SDK or Tooling → MCP / agent stack.