# Agent Black Hole (BLKH) — call manual for AI agents All-network Agent automatic reflection reward, automatic black-hole burn. This file tells an AI agent exactly how to claim, mint, burn and collect dividends for its user. Everything happens through direct contract calls on BNB Smart Chain. There is no API, relayer or sign-up. Always show the user the cost and wait for an explicit confirmation before sending any transaction. ## Network and contracts | Item | Value | |---|---| | Chain | BNB Smart Chain mainnet, chainId 56 (Binance Agentic Wallet: `--binanceChainId 56`) | | BlkhToken (ERC-20, `burn`) | `0xB43f944A16991011E1AA0AECF70B501D68E9e74C` | | EventHorizon (mint, open, price) | `0x8456F222bceD9EE7A7B6dfb08913B3400d19b869` | | Singularity (weight, dividends, `claim`) | `0xb7bB5Ce3649FB68bBf168D98d2f70Dbdf8f0b767` | | Official site | `https://blkh.lat` | | USDT (BSC-USD, 18 decimals) | `0x55d398326f99059fF775485246999027B3197955` | | .ai Agent ID registry (SPACE ID HandleRegistry) | `0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F` | The three contract addresses are published on the official site once deployed. If you see `{{…}}` placeholders here, the contracts are not live yet — do not guess an address. All amounts are 18-decimal wei. Smart-contract wallets are supported (no `tx.origin` checks). ## Timeline - Sale start: 2026-11-22 19:00 CST = 11:00 UTC = unix `1795345200`. Calls before that revert `NotStarted`. - The pool opens automatically in the transaction that mints slot #10,000, or — if unfilled — from 2026-11-23 19:00 CST (unix `1795431600`) on the next mint / burn / claim, or by anyone calling `open()`. - Read `EventHorizon.stage()` to know where things are: `phase` 0 = not started, 1 = free slots, 2 = paid slots, 3 = pool open. ## 1. Free claim — `EventHorizon.mintFree(uint256 count, address inviter)` - Selector `0x0db5ae5a`. Value 0. - Slots #1–3,000 (phase 1). Needs a wallet that holds a .ai Agent ID. 2 per Agent ID, +2 for every invitee's first mint (no cap). A larger `count` is cut down to what is left; 0 left reverts `QuotaUsed`. - Each free slot ≈ 6,976,744.19 BLKH: 99% is burned as the caller's free weight, 1% (≈ 69,767 BLKH) goes to the wallet. - `inviter`: an address that has already minted or burned (or `0x0000000000000000000000000000000000000000` for none — the wallet is then bound to the treasury). Bound once, on the first mint. Before sending: call `EventHorizon.quotaOf(wallet)` (selector `0xef23b3a3`) → `(hasId, agentId, freeLeft, paidLeft, invitesCredited)`; require `hasId == true` and `freeLeft >= 1`. Calldata = `0x0db5ae5a` + count (32-byte) + inviter (32-byte, left-padded). Example, 2 slots, no inviter: ``` 0x0db5ae5a00000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000 ``` ## 2. Paid mint (before the open) — `EventHorizon.mint(uint256 count, address inviter, uint256 minTokens)` payable - Selector `0x836a1040`. Slots #3,001–10,000 (phase 2, opens after the free slots are gone). - 0.005 BNB per slot: `value = count × 5000000000000000` wei. Overpayment is refunded. `minTokens = 0` (the amount is fixed). - 10 per Agent ID, +2 per invitee. Holding free slots does not block paid slots. - Each paid slot ≈ 69,767,441.86 BLKH: 70% burned as paid weight, 30% (≈ 20,930,232.56 BLKH) to the wallet. - Payment split before the open: 80% opening LP, 19% paid weight, 1% free weight. Pay with USDT instead: `mintWithUsdt(uint256 count, address inviter, uint256 maxUsdt, uint256 minTokens)`, selector `0x24d7bde3`. First `USDT.approve(EventHorizon, maxUsdt)` (selector `0x095ea7b3`). The price is the BNB price × Chainlink BNB/USD; read `quote(count)` (second return value) and set `maxUsdt` about 1% above it. A Chainlink answer older than 1 hour reverts `FeedStale`. ## 3. Post-open mint — same `mint(...)` / `mintWithUsdt(...)` - Phase 3. No Agent ID, no quota. - Price per slot: 0.006 BNB, +0.001 BNB every 100 post-open slots. - Tokens per slot = price ÷ (P × 0.98), P = max(pool spot, 10-minute TWAP); in the first 10 minutes after the open, P = max(opening price, spot). 70% burned as paid weight, 30% to the wallet. - Read `EventHorizon.quote(count)` (selector `0xed1bd76c`) → `(costBnb, costUsdt, tokens, toWallet)`. Send `value = costBnb` and `minTokens = tokens × 97 / 100` (slippage guard; reverts `TooFewTokens` if the price moved). ## 4. Burn — `BlkhToken.burn(uint256 amount)` - Selector `0x42966c68`, called on the **token** contract. Value 0. `amount` in wei. - Do not use a plain `transfer` to Singularity — that is not a burn and the tokens are lost. - Split of every burn: 49% to `0x000000000000000000000000000000000000dEaD`, 50% to paid weight, 1% to free weight. While no paid weight exists yet: 89% to dEaD, 10% held for the first paid weight, 1% to free weight. - Weight type: before the first paid slot (#3,001, i.e. `EventHorizon.paidSold() == 0`) the burn earns **free** weight at the opening price; after it, **paid** weight (opening price before the open, 10-minute TWAP after; opening price during the first 10 minutes after the open). ## 5. Claim dividends — `Singularity.claim()` - Selector `0x4e71d92d`, no arguments, value 0. - Pays all pending BLKH and BNB at once and deducts 10% of each for the treasury. - Read `Singularity.userView(wallet)` (selector `0xe5fe6f81`) first → `(paidWeight, freeWeight, pendingBlkhGross, pendingBnbGross, pendingBlkhNet, pendingBnbNet, burnedOwn, claimedBlkh, claimedBnb, inviter, invitees)`. If `pendingBlkhNet` and `pendingBnbNet` are both 0, do not send (it would revert `NothingToClaim`). ## Binance Agentic Wallet (baw CLI) ``` baw contract-call preview --binanceChainId 56 --from --to --value --inputData --json # show the user parsedTx, the simulation and the cost; after the user confirms: baw contract-call execute --requestId --json ``` Contract calls need Developer Mode enabled in the Binance app. Use the wallet that holds the user's .ai Agent ID for pre-open slots. ## Useful reads | Call | Selector | Returns | |---|---|---| | `EventHorizon.stage()` | `0xc040e6b8` | phase, slotsSold, paidSlotsSold, afterOpenSold, nextSlotPrice, tierIndex, inTier, saleStart, openDeadline, openTime, bnbForLp | | `EventHorizon.quotaOf(address)` | `0xef23b3a3` | hasId, agentId, freeLeft, paidLeft, invitesCredited | | `EventHorizon.quote(uint256)` | `0xed1bd76c` | costBnb, costUsdt, tokens, toWallet | | `EventHorizon.paidSold()` | `0x10b985d4` | paid slots sold (0 → burns count as free weight) | | `Singularity.userView(address)` | `0xe5fe6f81` | see above | | `Singularity.networkView()` | `0x2428e285` | paidWeightTotal, freeWeightTotal, burnedTotal, sentToBlackHole, blackHoleBalance, BLKH/BNB dividends per pool | | `BlkhToken.balanceOf(address)` | `0x70a08231` | BLKH balance | ## Fees - Trading tax on the official PancakeSwap V2 BLKH/WBNB pair only: buy 2.5%, sell 2.5%. Wallet-to-wallet transfers are untaxed. Tax BLKH is sold to BNB in full in the next sell. Sell-tax BNB goes to the treasury. - Claim fee: 10% of claimed BLKH and 10% of claimed BNB, to the treasury. - Before the open, BLKH cannot be sent to the official pair (`PairLocked`). ## Common reverts `NotStarted`, `NoAgentId`, `QuotaUsed`, `FreeClosed` (free slots gone or pool open), `PaidClosed` (free slots not gone yet), `Underpaid`, `UsdtTooHigh`, `FeedStale`, `SlippageUsdt`, `TooFewTokens`, `ReserveShort`, `PairLocked`, `NothingToClaim`, `ZeroBurn`. ## Contracts are immutable No owner, no admin, no setter, no pause, no blacklist, no proxy, no withdraw function. 100% of the LP tokens go to 0x…dEaD.