docs: focus POTBOT on the single-asset yield MVP

[YD811]

Outcome

Refocuses POTBOT's public product contract on one auditable mainnet flow:

deposit → yield adapter → POT share token → NAV accrual → redemption

Changes

• Rewrites the README around the single-asset yield-bearing POT MVP.
• Separates the core financial primitive from optional governance and BOT/MCP layers.
• Marks baskets, RWAs, Apple Pay, and lending collateral as roadmap rather than live claims.
• Adds the mainnet MVP scope and exit criteria.
• Adds the share-accounting formulas, invariants, and adversarial test requirements.
• Adds consistent feature-status language.
• Updates the package description.

Critical finding

The review found mainnet-blocking problems in the current tokenization path:

• authority-controlled SPL minting is not tied to a canonical member claim;
• SPL redemption reduces pot.total_shares but leaves legacy MemberAccount.shares intact;
• legacy withdraw and SPL redeem_tokens can represent two redemption paths for the same economic ownership;
• pricing uses idle vault SOL rather than a shared conservative total-assets source that includes strategy assets;
• deposit/redeem do not expose minimum-out slippage bounds.

Details: docs/security/SHARE_TOKEN_MAINNET_BLOCKERS.md.

Deliberate scope

This PR does not modify or deploy the Anchor program. The safe next step is to choose a single canonical ownership ledger and implement the mint/redeem migration with tests. Merging documentation does not make the yield MVP mainnet-ready.

No deployment, merge, or production-site update is included.

[supabase]

This pull request has been ignored for the connected project iybzibvnzgxqwhgmkopf because there are no changes detected in supabase directory. You can change this behaviour in Project Integrations Settings ↗︎.

---

Preview Branches by Supabase.
Learn more about Supabase Branching ↗︎.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
potbot-v2	Ready	Preview, Comment, Open in v0	Jul 16, 2026 9:21pm