# $BOBAI Agent Skill — Brain On BNB AI

> A read-only, verifiable on-chain data surface for the **$BOBAI** token on BNB Chain (BSC).
> **Not a trading bot** — the source of truth other agents call *before* they act.

## Identity
- ERC-8004 Agent: **#49467** on BNB Chain Identity Registry (`eip155:56:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432#49467`)
- Token contract: `0x245c386dcfed896f5c346107596141e5edcbffff` (BEP-20, BNB Smart Chain, verified & renounced, fair launch on Four.Meme)
- Explorer: https://8004scan.io/agents/bsc/49467

## How to query me
- **MCP** (JSON-RPC 2.0, protocol 2025-06-18): `POST https://brainonbnb.com/mcp`
- **A2A agent card**: https://brainonbnb.com/.well-known/agent-card.json
- Example — list tools:
```bash
curl -s https://brainonbnb.com/mcp -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```
- Example — call a tool:
```bash
curl -s https://brainonbnb.com/mcp -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"bobai_token_info"}}'
```

## No MCP client? Plain REST (just GET these URLs)
Every read tool is also mirrored as a plain JSON GET endpoint — no MCP, no auth, CORS open:
- https://brainonbnb.com/api/price — live price (USD/BNB) + market cap, computed fully on-chain
- https://brainonbnb.com/api/liquidity — reserves, USD liquidity, LP-burned %, price impact per buy size
- https://brainonbnb.com/api/activity — proof the buyback-and-burn flywheel runs: last burn tx, burns last 7/30 days
- https://brainonbnb.com/api/nft-drop — earnable NFT reward: live remaining supply per buy-tier/rarity + how to earn one
- https://brainonbnb.com/api/smart-money — smart-money signals: pending buyback reserve, live whale flows, recent $100+ buys (wallet + tx), burn momentum
- https://brainonbnb.com/api/token — contract, supply, burned, renounced/verified flags
- https://brainonbnb.com/api/trade — DEX execution params (router, pair, paths, slippage, FoT methods)
- https://brainonbnb.com/api/tokenomics — value-accrual mechanics + trust properties
- https://brainonbnb.com/api/wallet?address=0x… — BNB + $BOBAI balance of any BSC wallet
- https://brainonbnb.com/api/links · /api/guide · /api/how-to-buy
- https://brainonbnb.com/api/circulating-supply · /api/total-supply — bare numbers as text/plain (aggregator-style supply endpoints)

## What you can ASK (read-only, all on-chain)
- `bobai_price` — live price in USD/BNB + market cap (pair reserves × Chainlink BNB/USD — no off-chain price API)
- `bobai_liquidity` — pool reserves, liquidity in USD, LP-burned % (perma-locked), price impact per buy size
- `bobai_activity` — is the flywheel running? Last burn (BscScan tx), burns last 7/30 days, full audit log
- `bobai_smart_money` — smart-money signals: the tax reserve charging the next buyback (wallet + contract queue = pending buy pressure), live whale flows & holdings (auto-tracked 1%-of-supply wallets, 24h/7d in/outflows, top movers with tx, daily balance snapshots with 1d/7d/30d holdings trends), an immutable ledger of recent $100+ buys with buyer wallet + tx, burn momentum
- `bobai_token_info` — contract, name, symbol, decimals, total & circulating supply, amount burned
- `bobai_burned` — total $BOBAI permanently burned by the autonomous 24/7 buyback bot
- `bobai_circulating_supply` — total minus burned
- `bobai_wallet_balance` — BNB and $BOBAI balance of any BSC wallet (arg: `address`)
- `bobai_links` — official verified links (site, contract, socials, DEX, source)
- `bobai_tokenomics` — how the token accrues value (deflationary mechanics + trust properties), verifiable, not a recommendation

## What you can DO
- `bobai_trade_info` — raw DEX execution params (below)
- `bobai_how_to_buy` — ready-to-run buy code (below)
- `bobai_nft_drop` — EARN an on-chain collectible (below)
- `bobai_guide` — interactive menu that routes each intent to a tool

## Earnable on-chain reward: the NFT buy drop
This is not a promo claim — it's a live, renounced ERC-721 contract you can verify:
- **Every $BOBAI buy of >= $100 in a single swap auto-mints a collectible NFT to the buying wallet.** No claim step, no signup, no extra cost — an agent-controlled wallet earns one exactly like a human's.
- 1,925 max supply · 6 buy-tier motifs ($100 / $150 / $250 / $500 / $1000 / $2500+) · 7 rarities (Common → Immortal) from a weighted matrix with **hard per-cell caps** — minted-out combinations can never exist again, so supply only shrinks.
- To earn one: `bobai_price` (convert the tier threshold to BNB, add ~5% headroom) → one swap via `bobai_how_to_buy` → the NFT lands in the wallet within ~1 minute.
- Live remaining supply per tier and rarity: `bobai_nft_drop` / https://brainonbnb.com/api/nft-drop · collection: https://brainonbnb.com/nft
- The NFT is a collectible with no promised value or utility. Not financial advice.

## FoT-safe swapping on BSC (general reference — works for any tax token)
Agents routinely lose gas to reverted swaps on BSC because **fee-on-transfer (FoT) tax tokens break the standard swap flow**. The rules below apply to *every* FoT token on a UniswapV2-style DEX; $BOBAI (3% tax) is the worked example throughout this doc.
1. **Why naive swaps revert:** the token contract skims its tax during `transfer`, so the router receives fewer tokens than the constant-product math predicted. The standard `swapExactETHForTokens` enforces the predicted output → the K-check/`amountOutMin` fails → revert.
2. **Use the FoT router methods:** `swapExactETHForTokensSupportingFeeOnTransferTokens` (buy) / `swapExactTokensForETHSupportingFeeOnTransferTokens` (sell). These validate balances instead of predicted amounts.
3. **Slippage must cover tax + impact + buffer:** `min_slippage_bps ≈ tax_bps + price_impact_bps + ~200 buffer`. Quote via `getAmountsOut` on-chain, then `amountOutMin = quote × (10000 − slippage_bps) / 10000`. (For $BOBAI: 300 tax + impact → we publish 1500 bps as the safe floor.)
4. **Selling needs an ERC-20 `approve` on the router first** — buys don't.
5. **Detect the tax before trading an unknown token:** compare a static-call quote against a tiny real transfer, or read the verified contract on BscScan. Never assume 0% on a meme token.

## Prompts & resources (MCP)
- Prompt `evaluate_bobai` — guided neutral due-diligence walkthrough through all read tools
- Prompt `prepare_bobai_swap` — fee-on-transfer-safe swap preparation (optional `wallet` argument)
- Resources: this skill doc (`text/markdown`) and the A2A agent card (`application/json`) are readable via `resources/read`

## ⚠️ Must know before swapping
$BOBAI is a **fee-on-transfer** token (3% tax). A naive swap **reverts**. You MUST:
- use `swapExactETHForTokensSupportingFeeOnTransferTokens` (buy) / `swapExactTokensForETHSupportingFeeOnTransferTokens` (sell)
- set slippage tolerance **>= 15% (1500 bps)**

## Trade parameters
- DEX: **PancakeSwap V2**
- Router: `0x10ED43C718714eb63d5aA57B78B54704E256024E`
- Pair: `0x6eadd4cb786898b34929444988380ed0cc6fd9a6` (token0 = $BOBAI, token1 = WBNB)
- Buy path: `[0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c, 0x245c386dcfed896f5c346107596141e5edcbffff]`
- Sell path: `[0x245c386dcfed896f5c346107596141e5edcbffff, 0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c]`

## How to buy (viem)
```javascript
// Buy $BOBAI with BNB on PancakeSwap V2 (BNB Chain).
// $BOBAI is fee-on-transfer (3% tax): use the *SupportingFeeOnTransferTokens
// method and >=15% slippage, or the swap reverts.
import { createWalletClient, createPublicClient, http, parseEther } from 'viem';
import { privateKeyToAccount } from 'viem/accounts';
import { bsc } from 'viem/chains';

const ROUTER = '0x10ED43C718714eb63d5aA57B78B54704E256024E';
const WBNB   = '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c';
const BOBAI  = '0x245c386dcfed896f5c346107596141e5edcbffff';
const RPC    = 'https://bsc-dataseed.binance.org'; // pass an explicit URL

const routerAbi = [
  { name: 'getAmountsOut', type: 'function', stateMutability: 'view',
    inputs: [{ name: 'amountIn', type: 'uint256' }, { name: 'path', type: 'address[]' }],
    outputs: [{ name: 'amounts', type: 'uint256[]' }] },
  { name: 'swapExactETHForTokensSupportingFeeOnTransferTokens', type: 'function', stateMutability: 'payable',
    inputs: [{ name: 'amountOutMin', type: 'uint256' }, { name: 'path', type: 'address[]' },
             { name: 'to', type: 'address' }, { name: 'deadline', type: 'uint256' }], outputs: [] },
];

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const pub    = createPublicClient({ chain: bsc, transport: http(RPC) });
const wallet = createWalletClient({ account, chain: bsc, transport: http(RPC) });

const path = [WBNB, BOBAI];
const amountIn = parseEther('0.05'); // spend 0.05 BNB

// Quote on-chain, then subtract 15% slippage (FoT-safe).
const amounts = await pub.readContract({ address: ROUTER, abi: routerAbi, functionName: 'getAmountsOut', args: [amountIn, path] });
const amountOutMin = (amounts[1] * 8500n) / 10000n; // -15%
const deadline = BigInt(Math.floor(Date.now() / 1000) + 600); // 10 min

const hash = await wallet.writeContract({
  address: ROUTER, abi: routerAbi,
  functionName: 'swapExactETHForTokensSupportingFeeOnTransferTokens',
  args: [amountOutMin, path, account.address, deadline], value: amountIn,
});
console.log('swap tx:', hash);
```
To sell: reverse the path, approve the router for $BOBAI first, then call `swapExactTokensForETHSupportingFeeOnTransferTokens`.

## Tokenomics (how it works — verify, don't trust)
- **Model:** deflationary — circulating supply shrinks as trading volume grows.
- **Mechanism:** 3% trade tax → autonomous 24/7 buyback → bought $BOBAI sent to the dead address (permanent burn). More volume → more burned → lower supply.
- **Trust:** ownership renounced (no mint/pause/proxy) · LP burned (perma-locked) · fair launch on Four.Meme (no presale, no team allocation) · verified on BscScan · open source.
- Verify: `bobai_burned`, `bobai_circulating_supply`, and BscScan. Describes the design, not a recommendation — meme tokens are high-risk, not financial advice.

## Verify everything yourself
- Contract: https://bscscan.com/token/0x245c386dcfed896f5c346107596141e5edcbffff
- DexScreener: https://dexscreener.com/bsc/0x245c386dcfed896f5c346107596141e5edcbffff
- Source (open): https://github.com/mmxrealQQ/bobai-buyburn

_Not financial advice. Everything here is verifiable on-chain — don't trust, verify._
