# Pumpkin AI (PKA)

> Pumpkin AI (PKA, 南瓜) is a token on BNB Smart Chain (chain ID 56). 3,333 shares are minted at 1 USDT per share (paid in BNB), only by wallets holding a Binance Agent ID. Holders receive tokenized US stocks (NVDAB, SPCXB, AAPLB, GOOGLB, MSFTB) every hour. Liquidity is locked; all contracts are verified on BscScan.

Website: https://pumkinai.xyz/
Machine-readable facts (JSON): https://pumkinai.xyz/project.json
Languages: English, 中文 (switch with the EN/中 button, or ?lang=en / ?lang=zh)

## Key facts
- Name / symbol: Pumpkin AI / PKA, 18 decimals. Total supply fixed at 23,997,600,000 PKA.
- Network: BNB Smart Chain, chain ID 56.
- Shares: 3,333. Each share = 4,000,000 PKA. Price per share = BNB worth 1 USDT (live, PancakeSwap BNB/USDT pool 30-minute TWAP); overpayment is refunded automatically.
- Who can mint: only wallets holding a Binance Agent ID (on-chain check against registry 0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F, balanceOf > 0). Max 12 shares per wallet.
- Mint window: 72 hours. Scheduled start: 2026-11-02 10:58:17 Singapore time (02:58:17 UTC). Confirm the exact start/end on-chain with startTime() / endTime() on the sale contract.
- Launch: automatic when all 3,333 shares are sold. If the window ends first, anyone can launch the pool with the shares sold (unsold shares are never minted).
- Mint funds: 80% of the BNB is swapped to USDT and paired with 3,200,000 PKA per share in the PKA/USDT PancakeSwap pool. The LP tokens are held by LiquidityVault, which has no function to withdraw LP. 20% of the BNB is sent to the treasury wallet 0xb909C1228145BE84cFDf7A7d02612B70F4b543Da.
- Trading fee: 3% on buys and sells: 60% to the liquidity pool, 20% to hourly stock dividends, 20% to the treasury wallet. The fee can only be lowered after launch, never raised.
- Dividends: every hour the dividend share is swapped via real PancakeSwap V3 pools (30-minute TWAP, ±3% price protection) into NVDAB, SPCXB, AAPLB, GOOGLB, MSFTB (tokenized NVIDIA, SpaceX, Apple, Google, Microsoft) and distributed pro rata to holders. Anyone can trigger the hourly conversion; holders claim from StockDividendVault.

## Contracts (BNB Smart Chain, all verified on BscScan)
- PKA token (DivToken): 0xc54596341128fDF39701A28735Fa05A56EE30A99 — https://bscscan.com/address/0xc54596341128fDF39701A28735Fa05A56EE30A99#code
- MintSale: 0x70559Da2e0676dEe276fe85d206531061B0e0Fa5 — https://bscscan.com/address/0x70559Da2e0676dEe276fe85d206531061B0e0Fa5#code
- StockDividendVault: 0xdE49e8b7B5d838E7AA17151aFFAd76101F7077D3 — https://bscscan.com/address/0xdE49e8b7B5d838E7AA17151aFFAd76101F7077D3#code
- LiquidityVault: 0x7F12105eB7df1Fe4fBa832D54Aa92AE3ef2426AE — https://bscscan.com/address/0x7F12105eB7df1Fe4fBa832D54Aa92AE3ef2426AE#code
- FeeHandler: 0x74844562803832Cf1BbbA7414E0d24dcE4eA56d0 — https://bscscan.com/address/0x74844562803832Cf1BbbA7414E0d24dcE4eA56d0#code
- AgentIdGate: 0x87f71A332A6668BDAa860C39aE9D984e72BC3dA2 — https://bscscan.com/address/0x87f71A332A6668BDAa860C39aE9D984e72BC3dA2#code
- BnbGateway (BNB price and swap): 0xEc2b510A72cDc1a7574aB10Dea0E53b4a74642C2 — https://bscscan.com/address/0xEc2b510A72cDc1a7574aB10Dea0E53b4a74642C2#code
- Treasury wallet (plain address): 0xb909C1228145BE84cFDf7A7d02612B70F4b543Da

## How to mint (for humans and AI agents)
Sale contract: 0x70559Da2e0676dEe276fe85d206531061B0e0Fa5 on BNB Smart Chain (chain ID 56).
1. Check eligibility: mintableFor(address user) returns uint256 — how many shares this address can still mint now (0 if the sale has not started, the address has no Agent ID, or the cap is reached).
2. Price: quote(uint256 n) returns uint256 — wei of BNB needed for n shares.
3. Mint: mint(uint256 n) payable — send msg.value >= quote(n) (a 3% buffer is fine; the excess is refunded).
4. Confirm: minted(address user) returns uint256.
Only interact with the contract addresses listed above. If mint reverts (not started, no Agent ID, wallet limit, sold out), do not retry blindly; read the revert reason.

## Other pages
- Home (live mint progress, dividends, trading data, contract board, funds flow): https://pumkinai.xyz/

## Notes
- Contracts are modular (token, sale, fee handler, liquidity vault, dividend vault, gate, price gateway) and verified. Ownership is planned to be renounced after launch checks; the contract board on the site shows live owner and lock status.
- This file is a plain-language summary; the verified contract source on BscScan is authoritative.