SQUADFI
  • Home
  • Packs
  • Market
  • My Club
  • Squad
  • Tournament
  • Ranks
  • Atlas
  • Tokenomics
  • Docs
SquadFI
SQUADFI
Onchain · Ethereum
Build your squad. Draft your stars. Lift the trophy.
Verifiable randomness · No middlemen · Real prizes.
Docs$SQUADAtlasXTG
© SquadFI · v3 · Sepolia testnet

Docs

How SquadFI works onchain — the protocol, not the marketing.

Game loop

Open packs → mint cards → register a 20-card squad (5 DEF · 6 MID · 7 ATT · 2 GK, no captain) before kick-off → squads lock 30 minutes before the first match and unlock for a 1-hour correction window between rounds → Scoring publishes a Merkle root → claim your prize from PrizeDistribution.

Open a pack →Current stage →

Card model

48 nations × (4 Bronze + 8 Silver + 10 Gold + 4 Star) = 1 248 playerTypes. playerTypeId = country×10 000 + rarity×1 000 + seq. Each minted card has a unique serial; identical types share artwork but score independently.

Player Atlas →

Rarity & odds

Bronze / Silver / Gold packs mint instantly with onchain pseudo-randomness — one tx, one pull. Star packs use a 2-tx commit-reveal flow (~36s wait, $0 oracle fees) so the reveal can't be front-run. Rarity weights and price are onchain on each tier; check getPackTier(tierId) to see them in real time.

Pack Store →

Marketplace

Player cards trade in $SQUAD only — never ETH. EIP-712 signed off-chain orders for gasless listing. Every sale burns 7% of the $SQUAD paid (deflationary by design); the remaining 93% goes to the seller.

Browse market →

Stage scoring

Off-chain data feeds publish a candidate stageScore + manager rankings via Scoring.commitStageScore. A 24-hour challenge window can reject corruption. After expiry anyone may executeFinalization to publish the Merkle root.

Leaderboard →

Prize claim

Once Scoring finalizes, your owed amount is a leaf in PrizeDistribution.managerMerkleRoot. Submit (amount, proof) to claim(). Unclaimed funds expire at claimDeadline and can be swept back to treasury.

Tournament →

Governance

Ownership is held by a TimelockController (1-day delay). The eventual Gnosis Safe is the timelock proposer. PRIZE_GUARDIAN_ROLE retains emergency pause but can't withdraw funds (liability gate enforces).

Tokenomics →