DOC_01 / OVERVIEW
TWINS, NOT CLONES.
Launch Twins is designed as a coordination interface for launching one project through two existing BNB launch ecosystems. It does not merge Flap and Four into one exchange and it does not invent a synthetic shared market.
The intended output is two native launches linked by one verifiable pair identity. Each twin can develop its own holders, price, liquidity and lifecycle while remaining visibly connected to its sibling.
PROJECT INPUT
│
├──> FLAP ADAPTER ──> FLAP TWIN
│
└──> FOUR ADAPTER ──> FOUR TWIN
FLAP CA + FOUR CA ──> TWIN REGISTRY ──> TWIN ID
CORE RULETwo native contracts. Two native markets. One verified relationship.
DOC_02 / ARCHITECTURE
FIVE LAYERS.
01 / LAUNCHER UICollects shared metadata, wallet state and platform-specific configuration.
02 / FLAP ADAPTERMaps approved UI inputs into the verified Flap launch interface.
03 / FOUR ADAPTERMaps approved UI inputs into the verified Four launch interface.
04 / TWIN REGISTRYStores or exposes the canonical relationship between both deployed contracts.
05 / INDEXERReads public events and market state for the post-launch Twin dashboard.
The frontend intentionally does not guess unknown contract calls. Adapter execution remains locked until verified contract addresses, ABI definitions and supported creation methods are supplied.
DOC_03 / LAUNCH FLOW
SYNC LAUNCH.
01CONNECTRequest the browser EVM wallet and switch to BNB Chain.
02IDENTITYEnter project image, token name, ticker, description and links once.
03PREPAREBuild both platform payloads and show the creator exactly what differs.
04EXECUTESubmit the verified Flap and Four creation calls through the connected wallet.
05CAPTURERead the resulting contract addresses from confirmed transactions/events.
06REGISTERBind both addresses to the original shared metadata and creator.
NOT ATOMIC BY DEFAULTTwo external launch systems cannot be described as a single atomic deployment unless their verified interfaces actually support that guarantee.
DOC_04 / REGISTRY
THE PAIR IS THE PRODUCT.
A Twin ID exists to solve a simple problem: two independent contracts need one public source of truth declaring that they were intentionally launched as a pair.
twinIdcanonical pair identifier
creatorlaunching wallet / authorized creator
flapTokennative Flap-side contract
fourTokennative Four-side contract
metadataHashshared project identity hash
createdAtregistration timestamp
DOC_05 / FEES + TREASURY
ATTRIBUTE, DON'T BLUR.
Launch Twins should distinguish underlying platform fees from any creator-directed or beneficiary revenue supported by the native launch configuration.
If a future Twin Treasury is enabled, the dashboard should preserve source attribution instead of presenting all inflows as if Launch Twins owns platform revenue.
FLAP-SIDE CREATOR FLOW ──┐
├──> TWIN TREASURY / CREATOR DESTINATION
FOUR-SIDE CREATOR FLOW ──┘
PLATFORM FEES: remain subject to each native platform's own rules.
DOC_06 / WALLET + SECURITY
THE WALLET SIGNS. THE SITE DOESN'T CUSTODY.
The Connect Wallet button uses the injected EIP-1193 provider exposed by MetaMask-compatible browsers. The frontend requests accounts, then requests BNB Smart Chain mainnet (chain ID 56). If the chain is missing, it can request that the wallet add it.
✓No seed phrase requested
✓No private key stored
✓Transactions require wallet approval
✓Network switch is explicit
Before production deployment, verified contract allowlists, transaction simulation/review, error decoding and testnet/mainnet validation should be added.
DOC_07 / INTEGRATION STATUS
WHAT IS REAL TODAY.
FRONTEND / ROUTINGREADY
METAMASK CONNECTREADY
BNB CHAIN SWITCHREADY
PROJECT FORM + PREVIEWREADY
FLAP DEPLOY ADAPTERNEEDS VERIFIED ABI
FOUR DEPLOY ADAPTERNEEDS VERIFIED ABI
TWIN REGISTRY CONTRACTNOT DEPLOYED
MARKET INDEXERNOT CONFIGURED
The launch button remains intentionally non-transactional until the underlying platform interfaces are verified. This is safer than presenting guessed calls as a live launchpad.