DOCS.TXT - HoodFund manual
== OVERVIEW ==

HoodFund is a fixed-supply, token-governed RWA fund on Robinhood Chain. Every trade of the fund token pays a 3% tax. The tax buys tokenized stocks chosen by holder vote, and any holder can burn their tokens to withdraw their exact share of everything the fund owns.

The contract has no manager, no deposit function, and no mint function. The constructor mints the entire supply once, and only redemptions shrink it.

ADDRESSES.TXT
TOKENOMICS.TXT
== SUPPLY & TAX ==
  1. Fixed supply. The full supply is minted at deployment. The contract has no mint function, so supply only decreases as holders redeem.
  2. 3% transfer tax. Every transfer pays 3% — pair buys and sells, other pools, and wallet-to-wallet moves alike. The tax accrues inside the contract as the tax reserve.
  3. Exemptions. Mints, burns (redemptions), and whitelisted protocol addresses skip the tax. Admins and executors are exempt while they hold the role, and admins curate the wider whitelist — curation survives ownership renouncement.
VOTING.TXT
== EPOCHS & BALLOT ==
  1. One asset per epoch. Time is split into epochs. Each epoch, holders vote for one whitelisted Robinhood stock token to buy with the accrued tax.
  2. Snapshot voting power. Your voting power is your token balance at the epoch-start block. The contract checkpoints every wallet balance, so buying mid-epoch does not add votes and selling mid-epoch does not remove them.
  3. Whitelist only. Only canonical stock tokens whitelisted by contract admins appear on the ballot. Each entry stores its own swap route. Admins can only curate the whitelist — ownership itself can be renounced, freezing every other lever forever. New or changed routes go live only after a public on-chain delay, so holders can inspect a route and redeem out before it can ever execute.
EXECUTION.TXT
== HOW THE WINNER GETS BOUGHT ==
  1. Epoch ends. An authorized executor finalizes the expired epoch, passing quote-derived minimum outputs and a deadline. Neither the executor nor the owner ever takes custody of funds.
  2. Tax → WETH. The contract sells the collected fund tokens for WETH through the V2 pair (via a dedicated receiver contract, since a V2 pair cannot pay out to its own token).
  3. WETH → winner. The WETH is swapped for the winning stock token through the route stored for it: Uniswap V2, V3, or V4 via the Universal Router. Slippage is enforced on the measured output with minAssetOut.
  4. Stock lands in the vault. Bought tokens sit in the fund contract itself and back every outstanding fund token.
REDEMPTION.TXT
== LEAVING ==
  1. Burn to exit. redeem(amount) burns your fund tokens and sends you the matching percentage of the vault: idle WETH plus every stock token it holds, in kind.
  2. Pro-rata. Burn 1% of supply and receive 1% of every asset. Redemption needs no queue, lockup, or approval.
  3. Untaxed. Redemption is not a pair trade, so the 3% tax does not apply.
💰 HOODFUND.EXE🗳️ BALLOT.EXE💼 PORTFOLIO.DAT🏃 REDEEM.EXE🖥️ CHAIN.LOG📄 DOCS.TXT
🔊 --:--