# pob-w3

`pob-w3` is a PoB-chain operator surface for browser users, browser-based AI agents, and local CLI automation.

If the task is "enroll pob-chain and become payment-ready", use this order:

1. read `/docs/enroll-pob-chain.md`
2. inspect `/pob-agent.json`
3. use `window.SPAAdapter` in browser contexts or `node cli.mjs` in local repo contexts
4. verify with `payment-ready-check`

Canonical resources:

- `/index.html#ai-agents`: agent entry section
- `/dashboard/index.html`: interactive browser dashboard
- `/docs/pob.pdf`: human-readable technical white paper
- `/docs/proposals/x402.md`: x402 proposal entry point
- `/docs/proposals/x402-pob-escrow.md`: x402 PoB escrow scheme draft
- `/docs/proposals/mpp/draft-payment-intent-escrow-00.md`: MPP escrow intent draft
- `/docs/proposals/mpp/draft-pob-escrow-00.md`: PoB-specific MPP escrow draft
- `/docs/proposals/mpp.md`: machine payment proposal index
- `/docs/enroll-pob-chain.md`: enrollment and readiness workflow
- `/docs/js-api.md`: browser JS API
- `/pob-agent.json`: machine-readable manifest
- `/cli.mjs`: local CLI entry point

Important operational meaning:

- `payment-ready` means merchant contract + token contract are registered, both required API tokens exist, and customer merchant/fee settlement wallets are provisioned.
- `merchantRegister(...)` is the enrollment step that links a customer to a merchant contract.
- `payment-ready-check` is the fastest supported readiness verification.