launch-bnb-token-on-flap

🦋 Launch a BNB Token on Flap

Launch a token on Flap (BNB Chain). Execute each step in order. Read each reference file at the step that requires it — do not pre-load them.

---

⚠️ Security Notice

This skill requires sensitive capabilities that must be provided:

• EVM wallet with signing capability — hardware wallet, browser wallet, MPC, or other secure signing method for BNB Chain (chain ID 56). The skill mainly focuses on constructing transaction data and then the transaction should be signed by the EVM wallet. Always verify transaction details independently before signing.
• BNB mainnet RPC endpoint — a trusted RPC URL for reading blockchain state and broadcasting transactions. If not presently available, this skill will use the public fallback https://bsc-dataseed.binance.org/.

---

Directory structure

skills/launch-bnb-token-on-flap/
├── SKILL.md                        ← this file
└── references/
    ├── preflight.md                ← Step 0: prerequisites
    ├── quote-tokens.md              ← Step 1: quote token selection
    ├── vault-factory.md            ← Step 2: vault factory setup
    ├── meta-upload.md              ← Steps 3 & 6: metadata upload
    ├── tax-params.md               ← Step 4: tax parameters
    ├── salt-finding.md             ← Step 7: vanity salt mining
    └── construct-tx.md             ← Step 8: transaction construction

---

Step 0 — Preflight check

Before starting, verify that all required reference files are present. If any are missing, you MUST obtain them before proceeding:

Required files:

• references/preflight.md
• references/quote-tokens.md
• references/vault-factory.md
• references/meta-upload.md
• references/tax-params.md
• references/salt-finding.md
• references/construct-tx.md

Check each file exists, then read references/preflight.md and verify every prerequisite is satisfied before continuing.

---

Step 1 — Choose token type and quote token

Every token launched by this skill is a Flap Tax Token V3 (TOKEN_TAXED_V3). Standard (non-tax) tokens are out of scope for this skill.

Determine the token configuration:

1. Use a Vault Factory for revenue management?
2. Which quote token to launch against? Read references/quote-tokens.md to fetch the current list of supported quote tokens on BNB Chain and resolve the quoteToken address and decimals to use in later steps. Defaults to native BNB if the user has no preference.

Decision map:

Choice	Contract to call
Tax token, no vault	Portal.newTokenV6 with tokenVersion = TOKEN_TAXED_V3
Tax token + vault	VaultPortal.newTokenV6WithVault with tokenVersion = TOKEN_TAXED_V3

---

Step 2 — Vault Factory setup (tax + vault only)

Read references/vault-factory.md to:

1. Determine the vault factory address to use.
2. Call the factory's vaultDataSchema() to understand the required vaultData encoding.
3. Determine the values needed to encode vaultData.

Skip this step for tax tokens without a vault.

---

Step 3 — Token metadata

Determine the following token metadata fields:

• Required: name, symbol, image file path
• Optional: description, twitter handle, telegram handle (omit if not available)

Read references/meta-upload.md when ready to upload the image and construct the metadata JSON.

---

Step 4 — Tax parameters

Read references/tax-params.md to determine and validate:

• buyTaxRate, sellTaxRate
• taxDuration, antiFarmerDuration
• mktBps, deflationBps, dividendBps, lpBps
• minimumShareBalance
• beneficiary address (only for tax token without vault)

---

Step 5 — Launch buy amount

Determine quoteAmt: the amount of the chosen quote token (Step 1) to spend on the initial buy at launch, in human units. Convert to base units using the quote token's decimals (see references/quote-tokens.md) before encoding. If the quote token is native BNB, this also equals the msg.value of the transaction; for any other (ERC-20) quote token, msg.value is 0 and the wallet must instead hold and approve quoteAmt of that token beforehand. Use 0 to skip the initial buy.

---

Step 6 — Upload metadata

Follow references/meta-upload.md to upload the image and metadata JSON to Flap's upload API. Store the returned IPFS CID as meta.

---

Step 7 — Find the salt

Read references/salt-finding.md to mine a vanity salt using CREATE2 prediction:

• Tax token address must end in 7777.

Save the resulting salt (bytes32) and the predicted tokenAddress.

---

Step 8 — Construct the EVM transaction

Read references/construct-tx.md to assemble the full calldata, value, and to address for the correct contract entry point (Portal or VaultPortal).

---

Step 9 — Send the transaction

Broadcast the constructed transaction to BNB Chain using the available wallet. After confirmation, report the token address and a link to https://flap.sh/bnb/<tokenAddress>.