dash.foogy
dash.foogy
notes updated 2026-06-30 building
Related task Rewrite case study to the real product (whitelist + sweepstakes, NFTSweeps folded in) doing

Agents4.fun — notes

Working notes for the case-study rewrite. The goal is to describe the real product as it exists in the agent-wl repo.

What it is

Agents4.fun is an on-chain fair allowlist / raffle tool on Ethereum and Base (live at agents4.fun). An operator creates an event, eligible wallets enter through a token-gated on-chain path, the list closes, a verifiable draw (Chainlink VRF v2.5 + Solady LibPRNG) picks winners, and the winning wallets are exported as an allowlist (CSV). The system issues no rewards itself — there is no prize pool, no payout, no buyback, and no reward token. The deliverable is the exported winner list, used off-chain (for example, an NFT mint allowlist).

Important: the domain is agents4.fun — not agent4.fun. Keep them distinct.

Earlier framing vs. reality

An earlier draft framed this as a “whitelist + sweepstakes” product with NFTSweeps mechanics folded in (ERC-1155 tradeable ticket tokens, “buy/sell your odds,” an NFTSweeps-style prize/payout layer) and “our own PRNG from the DePunks lineage.” None of that matches the shipped code:

  • It is a fair-selection allowlist tool, not a monetary sweepstakes — no prize pool, payout, or buyback.
  • Entries are recorded as on-chain entries gated by ERC-721/ERC-1155 ownership, not minted as separate tradeable ticket tokens.
  • Randomness is Chainlink VRF v2.5 for the seed plus Solady LibPRNG for deterministic expansion (partial Fisher-Yates per tier) — there is no homegrown seed PRNG.

The docs now lead with the accurate, shipped description.

Mechanics (as shipped)

  • Token-gated entries via the built-in table-driven StandardHook: ERC-721 (ticketsPerToken) and ERC-1155 (per-unit, capped by a per-id capacity). A keccak256(collection, tokenId) use key stops a token being re-used to farm tickets, and survives transfer.
  • Per-event draws — each event runs its own VRF-seeded draw; no single shared pool.
  • Tier-priority weighting — strict tier order, uniform per-ticket within a tier, per-wallet caps. Not stake-weighted.
  • Fees — ~0.01 ETH default entry fee per ticket + a setup fee, non-refundable, swept to the project Safe.
  • Winner export — winners emitted on-chain and exported as CSV once the result reaches chain finality.

Status

  • Building (~40%). Docs aligned to the actual code (allowlist + VRF; sweepstakes / NFTSweeps framing dropped).
  • Visuals still to define: dashboard / onchain flow.

Don’t confuse with

  • agent4.fun (singular) — a separate “Agent4” onchain-analytics concept referenced in the foogy.xyz restructure. This project is the plural agents4.fun fair-allowlist tool.