Skip to content

Repository and changelog

Source code, release state, and validation commands for Boon.

Source code:

https://github.com/velinussage/boon

Current package version in the repo is 0.5.6 across the root package, CLI, Worker, app, normalize package, and subgraph package.

PathPurpose
contracts/Boon.solUSDC-only handle escrow and push contract
worker/src/index.tsOAuth, vouchers, claim sessions, Onramp, Boon Points, x402 API
app/src/Vite + React app for send, claim, board, profile, receipt
cli/src/index.tsOWS-funded agent CLI
packages/normalize/shared handle normalization
skill/boon/SKILL.mdagent skill and safety rules
CHANGELOG.mdrelease history
DEPLOYMENT.mdoperational cutover and verification runbook

The release history lives in CHANGELOG.md on the main branch. Latest highlights (see the file for full context):

  • Unreleased — CLI agent mode is OWS-only. Browser spend-delegation, the /delegate and /setup app routes, the Worker /permissions relay endpoints, and the legacy CLI --spender escape hatch were removed.
  • v0.5.6 (2026-05-21) — Primary onboarding leads with one-time send + just-in-time Coinbase Onramp funding; the /send flow is the recommended human path.

Per Documentation maintenance, any change that affects deployed behavior, env vars, endpoints, or operator flow updates CHANGELOG.md in the same PR.

Terminal window
forge test -vvv
pnpm --filter @boon/normalize test
pnpm --filter boon-worker test
pnpm --filter boon-cli test
pnpm --filter boon-app build
pnpm run typecheck

Some gates require live environment variables, signer keys, or funded burner wallets. Do not treat skipped gated tests as production proof.