How it works

How folio works

Buy FOLIO. Choose your stack. Receive your stocks.

One passive loop on a steady 30-minute clock, pointed at your own allocation — no games, no leaderboards, nothing to race. Two minutes to understand all of it.

This is an entertainment project
folio is a prototype that runs locally against a dev chain and demo data. Nothing here is an investment product, an offer, or advice. Passive fee-funded distributions of tokenized securities are exactly the mechanics our own research flags as the highest legal and economic risk — this build exists to explore them honestly, not to launch them. Taking any of it live would be a separate human decision that starts with legal review.

The loop

1
Buy and hold FOLIO
FOLIO is a plain ERC-20 — fixed 1B supply, ownerless, no transfer tax, no tricks. Your balance at each distribution snapshot sets your share. Any balance above zero lets you register a stack.
2
Choose your stack
Your stack is your personal allocation across a curated menu of ten tokenized public equities: pick 1–10, weight each at least 1%, total exactly 100%. Saving signs a message — never a transaction — and you can change it any time.
3
Claim your stocks
The vault accrues to you as USDG every 30 minutes; during market hours it buys the stocks in your stack, pro-rata to your FOLIO balance. Rewards pile up as a cumulative balance — claim whenever, one click sweeps everything, no deadline to race.

Holders with no registered stack roll over — their share simply stays in the vault. Settlements run at each 30-minute mark during US market hours (≈9:30 AM–4:00 PM ET, when the equity feeds are fresh); off-hours accrual rolls forward to the next open. Every settlement is public, leg by leg, on distributions.

Fees fund it

Every swap in the FOLIO pool pays a 2.5% protocol fee (hard-capped on-chain at 5%) through a Uniswap v4 hook, taken in the pool's paired currency — never as a tax inside the token. It splits three ways: 1% buys your stocks (the USDG distribution vault, accruing continuously, 24/7), 1% funds the KotH buyback-and-redistribute, and 0.5% goes to the treasury.

The pool also runs a 1% LP fee — and the protocol's seed liquidity is locked in a contract that cannot withdraw principal, ever (the withdrawal function simply does not exist). Its accrued LP fees are the platform's revenue, so the liquidity floor never leaves the pool. All-in, a swap costs 2.5% + 1% = 3.5% each way — and because rewards are pull-based claims with no eligibility floor, more of it reaches you than push-based 3% alternatives that burn most of their stream in delivery gas.

At each market-hours settlement the vault buys the AGGREGATE demanded basket — the sum of every eligible holder's stack — on Uniswap, and each holder is credited their own stocks at oracle prices:

your share = your balance ÷ eligible total × pot, split by your weights

The vault balance, the hook's fee setting, and every past epoch are public on treasury — the promised numbers and the on-chain numbers sit side by side.

Tokenize your folio — once, ever

Every unique stack composition has a deterministic identity, its folioId — a hash of exactly which tokens, at exactly which weights. The first holder of a composition may tokenize it, which requires a registered matching stack and 100,000 FOLIO.

Tokenizing launches that folio's own coin on a bonding curve, and it can never be tokenized again, by anyone, enforced on-chain. 100% of the coin's ongoing fees fill that folio's community pot — paid to wallets that hold the composition's underlying stocks (bought anywhere; your share grows with their value and how long you hold them, √-dampened so whales can't dominate), gated by holding $25+ of FOLIO. No FOLIO, no payout — and no registered stack or folio-coin balance is required.

Explore live folio tokens — composition, holders, reward epochs, and claims — on folios.

The trust surface, honestly

  • Stack saves are signed messages, never transactions — each signature binds your wallet to that exact stack and expires in five minutes. Server checks fail closed.
  • Login is X (Twitter) through Privy with an embedded wallet; the private key is yours to export and the app never touches key material.
  • Settlements are executed by an always-on keeper worker; the web server holds no keys and cannot move funds. Claims are pull-based — you sign your own one-click sweep, and the contract only ever pays what you are owed.
  • Wherever value moves, the exact amounts are restated before you commit, and tx hashes are shown after — verify everything on-chain.
  • Known limits, stated plainly: snapshots enumerate registered wallets only (full holder indexing needs infrastructure this prototype doesn't have), and tokenized stocks are issuer IOUs with pause and deny-list powers — not shares.

What folio deliberately doesn't do

Research on frictionless trading apps links engagement mechanics to worse financial outcomes. folio takes the opposite posture, on purpose:

  • No streaks, badges, confetti, or celebration when money moves.
  • No push notifications or nudges to trade, buy, or "act now."
  • The 30-minute clock is an accrual cadence, not a scarcity timer — rewards pile up and wait, nothing expires, and there is never a deadline to race.
  • Deliberate friction where value moves: sends and claims always restate the exact amounts, the recipient, and their irreversibility before you confirm.

If folio is ever boring, that is working as intended: register a stack, hold, and check in when a distribution lands.

The fine print
Read it — it is short and it is true.
This build runs locally against anvil and deterministic demo fixtures demo — numbers on these pages are real computations over demo data, labeled where fixture-sourced. Deploying to a live network, launching a token, or distributing real tokenized securities are separate, explicit human decisions with legal review first; our own research analysis of those risks stands unchanged. Nothing here is investment advice.

folio is an entertainment project. This build runs locally against test networks and demo fixtures. Registering a stack signs a message — it opens no position; distributions of tokenized stocks are prototype mechanics, not an offer of securities. Deploying to a live network, launching a token, or distributing real tokenized securities are separate, explicit decisions with legal review. Nothing here is investment advice.

Search folio

Search folios, stocks, chat rooms, pages and quick actions