Your losses, insured by the crowd.

How the contract works

Freecoin is a fully on-chain Anchor program. No admin can move funds. No backend signs payouts. The Treasury PDA can only be drained by the contract's own logic, which requires real holder votes. Every account, claim, vote, and payout is a public on-chain record.

1. 1. Pool fills from pump.fun creator fees

   Each trade of $FREE generates a creator fee. Those fees are automatically swept into the Treasury PDA - a contract-owned account with no private key. Anyone can call deposit() to add SOL; nobody can call anything to take it out.

2. 2. Lost holders submit a claim

   To file a claim, your wallet asks the oracle to verify your loss. The oracle reads your $FREE trade history on chain, computes your realized loss in SOL, and signs an 80-byte attestation. That signed proof goes into your submit_claim transaction. The contract verifies the Ed25519 signature inline against the oracle pubkey stored in Config - if the proof is real and the amount is within your verified loss, a Claim PDA is created. The claim text itself is stored as a SHA-256 hash on chain; the narrative lives off chain.

3. 3. $FREE holders vote, weighted by balance

   Each claim is open for community vote. Vote weight = your live $FREE balance at the moment of voting (read from your token account). Each wallet can vote yes or no once per claim. You cannot vote on your own claim. Votes are stored as on-chain Vote PDAs and are immutable once cast.

4. 4. Top-voted claims drain the pool every 5 minutes

   A permissionless cron runs every 5 minutes. It orders all open claims by yes-weight descending and calls finalize_claim top-down. The contract pays each claim if (a) yes > no, (b) at least one vote exists, and (c) the pool can cover it. Claims the pool can't fund stay open and roll into the next round automatically.

5. 5. Verified 501(c)(3) attribution

   The Hack Foundation (EIN 81-2908499) is registered in the Config PDA as the protocol's fiscal sponsor for on-chain attribution.