A book, stored by the contract that pays for it.

• Creator: launches the token, writes and seals the book. The author share is paid to the creator wallet, only once the book is sealed.
• Flap Guardian: the only account that can upgrade the vaults, change the treasury or change the payout wallet; backup to seal a book.
• Protocol treasury: the Book Vault team wallet. It receives the protocol share and has no powers.
• Holders: BNB dividends from 10,000 tokens, paid by the Flap dividend tracker.
• Anyone can call distribute(); readers need nothing, any BNB Chain node serves the text.

A book is a list of chapters. Each chapter is a UTF-8 string of at most 16,384 bytes with a title, appended by one transaction. The vault stores every byte in contract storage, not in logs and not on IPFS. The factory records title, author, license and language at launch.

Sealing is one call by the creator (or the Guardian). It sets a flag and the block number. After it, append reverts forever. A book that is not sealed may still grow, and the reader says so.

The vault keeps a rolling keccak256: h0 is zero, and each append sets h to keccak256(h, chapter). The reader recomputes the chain from the chapters it downloaded and compares with the stored value. A match proves the text read is exactly the text published.

h(0) = 0x00...00
h(i) = keccak256(h(i-1) || utf8(chapter(i)))
contentHash() = h(n), frozen at seal

Every launch through the V2 factory carries the same economy. Each trade pays a 3% tax in BNB through the Flap tax processor, cut in three parts:

On the launch form this reads as vault share (mktBps) 5000 and dividend share 5000 of the tax, deflation 0, LP 0, dividend token BNB. The vault recognizes what it receives by balance delta and books 33.33% for the treasury and 66.67% for the creator. Payouts are pulled: anyone calls distribute and the vault sends the treasury share at once and the creator share (to the payout address the creator set) once the book is sealed; until then the creator share accumulates in the vault. A failed transfer stays pending instead of blocking the other party.

50% of every tax payment, 1.5% of the trade, goes to the Flap dividend tracker attached to the token, in native BNB. Every wallet holding at least 10,000 tokens earns its share, pro rata, and claims it on the flap.sh token page. The vault never touches this part.

1. On the launch page, paste, write or upload the text: it is split into chapters and priced in BNB and USD.
2. Fill the token (name, ticker, logo, description, optional links), the book data (title, author, license, language) and the optional first buy. The logo and the metadata go to IPFS through the Flap upload API, a salt gives the token an address ending in 7777, the transaction is simulated, then your wallet calls the Flap VaultPortal with the Book Vault factory 0x8a1df3e2787344ab413e755A11b5Be64519A36bE. The economy is fixed (3% tax, vault 5000, dividends 5000, minimum holder balance 10,000), nothing to set.
3. Once mined, the token and its vault appear, the chapters are sent one transaction each, then the seal. A closed page resumes where the vault stands.
4. The launch goes through the Book Vault launcher, so the book is listed in the library. A token launched on flap.sh with Launch from Factory still gets its vault and can be written from the creator space, but it is not listed.

• Chapters: only the creator, or the Flap Guardian as a backup, can add chapters and seal; there are no delegated writers. A book needs at least one full sentence (32 bytes) before it can be sealed, and a sealed book never changes.
• Logic: vaults are beacon proxies behind one implementation. The beacon has no owner: only the Flap Guardian can upgrade the logic of every vault.
• Treasury: the factory has no owner: only the Flap Guardian can change the treasury address that receives the protocol share.
• Author payout: the author share is paid to the creator wallet. Only the Flap Guardian can change the payout wallet, and every change is recorded on-chain.
• Split: fixed in the contracts, nobody can change it.

MAX_CHUNK_BYTES

16,384 bytes per chapter

tax

300 bps buy and sell, fixed, native BNB only

vaultBps / dividendBps

5000 / 5000 of the tax (50% to the vault, 50% to the holders)

TREASURY_SHARE_BPS

3333: the vault pays 33.33% to the treasury, 66.67% to the creator once sealed

MIN_SEAL_BYTES

32 bytes before a book can be sealed

minimumShareBalance

10,000 tokens to earn dividends

Public domain texts stored so far: The Law by Frederic Bastiat (1850, 1874 translation by Patrick James Stirling, Project Gutenberg eBook 15962) and the Bitcoin whitepaper by Satoshi Nakamoto (2008, MIT license).

A book is launched as a tax token on flap.sh. The token trades on the Flap bonding curve, then on PancakeSwap once 80% of the supply is sold. Every trade pays a fixed 3% tax in BNB. The Flap tax processor sends 50% of it to the dividend tracker of the holders and 50% to the vault, which pays 33.33% to the protocol treasury and 66.67% to the author once the book is sealed. The diagram shows the flow for 1 BNB traded.

1. Trade: a buyer or seller pays the 3% tax through the Flap tax processor. On the bonding curve the Portal collects it per trade; after listing the token liquidates its tax and the processor dispatches BNB.
2. Dividends: 50% of the tax goes to the dividend tracker, 1.5% of the trade; holders with at least 10,000 tokens claim their BNB on flap.sh.
3. Vault: the BookVault receives the other 50%, recognizes it by balance delta and books 33.33% and 66.67%.
4. Protocol: 33.33% of the vault revenue, 0.5% of the trade, paid to the Book Vault team treasury by distribute().
5. Author: 66.67% of the vault revenue, 1% of the trade, paid to the creator (or its payout address) by distribute() once the book is sealed.

Three steps for a creator, all on the launch page: prepare the text, create the token from your wallet with the Book Vault factory (flap.sh stays an option), then write the chapters and seal.