Repository

Repository

Public source code:

https://github.com/velinussage/boon-protocol

The app and shared packages remain on the 0.5.6 release line. The independently installable npm CLI is @velinussage/boon-cli@0.7.0.

Important files

Path	Purpose
contracts/	Boon settlement and soulbound attestation contracts.
contracts/test/	Contract behavior, invariant, gas, and fork tests.
app/src/	Vite + React app for send, claim, board, profile, receipt, attestation.
cli/src/index.ts	OWS-funded agent CLI.
packages/normalize/	Shared handle normalization.
skill/boon/SKILL.md	Agent skill and safety rules.
CHANGELOG.md	Release history.

Recent changes

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

• Agent mode is OWS-only for live CLI sends.
• The hosted claim flow supports identity-first OAuth, relayed link/claim, and CLI device-code approval.
• The send flow supports public tips, private tips, agent recipients, and optional soulbound recipient proofs.
• Score suggestions now report the deterministic boon.recognition-score/v2 policy and use explicit artifact and service-cost context.
• Free all-handle Boon probes and non-executing workflow cost previews are discoverable through OpenAPI, ACP, A2A metadata, the CLI, and the hosted skill.

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

Validation commands

forge test -vvv
pnpm --filter @boon/normalize test
pnpm --filter @velinussage/boon-cli test
pnpm --filter boon-app typecheck
pnpm --filter boon-app build

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