๐Ÿ‘จโ€๐ŸณQuirk.exeโ€” Cooking a Tastier Future...
โ€”โ–กร—
QUIRK.EXE / KITCHEN MANUAL / BNB MAINNET

THE QUIRK
COOKBOOK

How references become tokens, how the Pancake pool works, where taxes go, and what traders can verify on-chain.

PROTOCOL AT A GLANCE1Bfixed supply per launch0/0 ยท 1/1 ยท 3/3allowed tax recipes245approved reference pairingsBSC 56live network
01

Start Here

Quirk is a BNB Smart Chain token launchpad where every launch is attached to an approved real-world reference such as a fruit, vegetable, burger, CPU, RAM kit or graphics card. The reference is informational; the actual DEX market is always the token against WBNB.

๐Ÿณ Simple model: choose reference โ†’ upload logo โ†’ set token name/symbol โ†’ choose tax โ†’ sign โ†’ Quirk creates the token and PancakeSwap V2 pool.
02

Launch Recipe

1Pick ReferenceChoose one approved category and exact item.
2Brand TokenName, ticker and creator-supplied logo.
3Pick TaxOnly 0/0, 1/1 or 3/3.
4Optional Dev BuyIncluded visibly in the wallet transaction.
5SignYour wallet signs the BSC transaction.
6Go LiveToken/WBNB pool is created automatically.
03

Reference Pairings

Quirk currently ships a 245-item catalog across tech, iPhone, food and burgers. Each approved item carries a pairing ID, proof URL and price-source URL. At launch, the Factory verifies a Merkle proof and stores the reference snapshot and timestamp.

fruit:applevegetable:potatomcd:big-maccpu:amd-ryzen-7-7800x3diphone:17-pro-256
๐Ÿ”— HOW THE REFERENCE IS CONNECTED ON-CHAIN

When a creator chooses a reference, Quirk sends its pairing ID, proof URL, price-source URL, price snapshot, timestamp and Merkle proof intoQuirkFactory.launchToken().

The Factory computes the approved catalog leaf frompairingId + proofURI + priceURI and verifies the supplied Merkle proof against the live pairingCatalogRoot.

If the proof is valid, Quirk stores that reference metadata in the token's Factory launch record and emits the ReferencePaired event. A fake or unapproved reference cannot pass this catalog check.

REFERENCEโ†’MERKLE PROOFโ†’QUIRK FACTORYโ†’ON-CHAIN RECORD
๐Ÿณ IMPORTANT: The real-world item is a reference, not the DEX liquidity asset. A token paired with an iPhone, Big Mac, RAM kit or fruit still trades in a real PancakeSwap V2 TOKEN / WBNB pool. Quirk does not create TOKEN/iPhone or TOKEN/BigMac liquidity, and the reference price is not a peg or oracle.

Reference prices are benchmarks only. They are not a peg, oracle, redemption promise, guaranteed retail quote or token valuation.

04

Taxes & Supply

1,000,000,000fixed token supply
18decimals
0% / 1% / 3%buy and sell tax choices
NO MINTafter deployment

When a taxed recipe is selected, pair-involving transfers route the configured percentage to the creator wallet. Ordinary wallet-to-wallet transfers are not treated as buys or sells.

05

Liquidity

Quirkโ€™s โ€œLP-free creator UXโ€ still uses real DEX liquidity. The launch manager creates a PancakeSwap V2 TOKEN/WBNB pair and bootstraps it with the configured BNB amount. Initial LP tokens are sent to the dead address.

TOKEN+WBNBโ†’PANCAKE V2โ†’LP ๐Ÿ”’ DEAD
06

Trading

The token page has a wallet-signed Trade.exe panel for BNB โ†” token swaps. It shows wallet balances, a MAX sell shortcut, estimated output, minimum received and the token tax. Approval and swap transactions require explicit wallet confirmation.

๐Ÿ“ˆ The embedded Dexscreener chart is read-only. Quirkโ€™s Trade.exe sends swaps through the configured PancakeSwap V2 Router.
07

Market Data

Market cards combine Quirkโ€™s on-chain registry with live Dexscreener data: USD price, market cap/FDV, 24h volume, liquidity, price change and buy/sell counts. Token pages additionally read PancakeSwap Swap events directly from BSC for the recent-trades table.

External indexers can lag or temporarily disagree with chain state. Contract addresses and BscScan remain the source for on-chain verification.

08

Holders

The holder panel reconstructs token balances from Transfer history and verifies current balances with the token contract. Dust-only addresses are filtered from the visible count. The Pancake pool and creator wallet are labeled separately so concentration is easier to understand.

๐Ÿ‘ฅ Holder counts are informational and can change every block. Pool inventory is not the same thing as a normal trader wallet.
09

Contracts & Infrastructure

QUIRK FACTORY0x45dE9C52a8be5136Ad05eFb3Bf3AEc710299CCC4BSCSCAN โ†—
LAUNCH MANAGER0x6fB4Dfba10001D7BFbE466E3066Ba719B6d186faBSCSCAN โ†—
PANCAKE V2 ROUTER0x10ED43C718714eb63d5aA57B78B54704E256024E
PANCAKE V2 FACTORY0xcA143Ce32Fe78f1f7019d7d551a6402fC5350c73
WBNB0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c
CHAINBNB Smart Chain ยท 56
10

Security Model

  • Fixed 1B supply and no post-launch mint path.
  • Only approved tax recipes are accepted.
  • Reference metadata must match the approved on-chain Merkle catalog.
  • Initial LP is sent to the dead address.
  • Creators cannot arbitrarily change the Pancake pair after launch.
  • Quirk does not ask users to paste private keys into the web app.

None of these controls removes market risk. Tokens can still lose all value and smart-contract/DEX/indexer risk still exists.

11

Reference Example ยท iPhone

Device references use exact approved IDs such as iphone:17-pro-256. Quirk displays the current Apple Germany EUR retail reference, proof source and snapshot timestamp before launch.

๐Ÿ“ฑ The iPhone price is a real-world reference only. The launched token still trades against WBNB on PancakeSwap V2.
12

FAQ

Is the real-world item literally inside the liquidity pool?

No. The approved item is a reference recorded with the launch. Trading liquidity is TOKEN/WBNB.

Can creators choose any tax?

No. The contracts only accept 0/0, 1/1 or 3/3.

Can Quirk mint more later?

Official launches have a fixed one-billion-token supply and no later mint path.

Where do I verify a token?

Use its token page, BscScan contract/pair links, reference proof and Dexscreener chart.