Hyperpush Solana economy: on-chain whale protection and exempt wallet model

[snowdamiz]

Parent epic

• Hyperpush: Solana treasury, configurable token/SOL payouts, and whale-proof token mechanics #21

Outcome

Enforce the hard per-wallet whale cap on-chain, define sensible exempt system wallets, and choose truthful anti-whale launch mechanics.

Clarified requirement

The hard cap should be based on circulating supply, not an ambiguous LP-only notion.

Target rule:

• non-exempt wallets may not end a buy/transfer above 3% of circulating supply

Circulating supply model

This issue should produce an explicit circulating-supply definition. A reasonable initial model is:

• circulating supply = total minted supply minus explicitly excluded non-circulating balances

Likely excluded balances:

• project treasury reserve
• hyperpush treasury reserve
• bounty escrow balances
• explicitly locked reserve/vesting balances
• any other declared non-circulating system accounts

Exempt wallet model

The exempt-wallet policy should be explicit, not implied. Likely exempt accounts include:

• pool accounts
• project treasury
• hyperpush treasury
• payout / bounty escrow vaults
• explicitly approved governance/admin/system wallets

Anti-bundler / anti-snipe scope

Investigate whether launch-time mechanics can reduce bundler concentration and early sniping. Examples worth evaluating:

• stricter early-launch wallet caps
• cooldowns
• per-slot / per-epoch buy limits
• launch-phase anti-snipe configuration
• suspicious-pattern detection / monitoring for aggregation that cannot be prevented on-chain

This issue should stay truthful: hard ownership-cap enforcement matters more than pretending we can fully solve Sybil/bundler behavior on-chain.

Acceptance criteria

• 3% cap is enforced on-chain per wallet using the explicit circulating-supply model.
• Exempt wallet model is explicit and documented.
• Public whale-resistance claims match what is actually enforceable.
• Launch-time anti-bundler mitigations are chosen truthfully, with clear distinction between enforceable rules and monitoring-only detection.
• A PR for this issue is not treated as ready until the whale-protection path is tested and working on Solana localnet.

Localnet proof gate

Minimum proof before PR submission:

• tests that show non-exempt wallets are rejected when a buy/transfer would move them above the cap
• tests that show exempt system wallets can still operate correctly
• tests that prove the circulating-supply exclusions are applied as designed
• localnet evidence for the chosen launch-time anti-bundler / anti-snipe behavior, if implemented

Tracker context

• Labels: enhancement, roadmap
• Project-backed: yes