# DOGGO AGENT (DOGGO)

> A night-shift share board on BNB Smart Chain (chain id 56). 50,000 shares.
> One share = 100,000 DOGGO. Only wallets holding a Binance .ai Agent ID may mint.
> No owner keys, no transfer tax, no upgrade, no refund, no deadline.
> 30% of every paid fare goes to the treasury in the same transaction; no team token allocation.
> LP burned at launch.
> Site: this directory (index.html). Machine docs: /skill.md. Full thesis: /WHITEPAPER.md.

## Status

Live on BNB Smart Chain, block 133042215. The constants below are compiled into the
contract and do not change.

- sale / mint:        0x5073f2977275ffa0c76c365fda1975c2443585ce
- token:              0x4f134de4c026a0f06fbaf95a29bc71475ea2d510
- pair (Pancake V2):  0x8cc2f28bd4db388a9cd350131b63555e82b6ba0d
- agent registry:     0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F  (read-only gate)
- treasury:           0x4061a3815f08d5daC1D1f3FdddBf760986E31279  (immutable, fee receiver)
- LP sink:            0x000000000000000000000000000000000000dEaD
- chain:              56 (BNB Smart Chain mainnet)

## What it is

A fixed share board, not a price oracle. Paid shares are sold in five steps: four of
10,000, then a closing 9,000. Each step has one price and does not move within itself.
The price ladder *is* the curve.

| paid shares | price per share | market cap |
|---|---|---|
| 0 – 9,999 | 0.001 BNB | 50 BNB |
| 10,000 – 19,999 | 0.002 BNB | 100 BNB |
| 20,000 – 29,999 | 0.003 BNB | 150 BNB |
| 30,000 – 39,999 | 0.004 BNB | 200 BNB |
| 40,000 – 48,999 | 0.005 BNB | 250 BNB |

Market cap = 50,000 shares × the tranche price, because the free lane also exists
and is never priced.

## Constants

    FREE_SHARES        1,000        free lane, outside the ladder
    PAID_SHARES       49,000        the ladder: 4 x 10,000 + 9,000
    TOTAL_SHARES      50,000
    TRANCHE_SIZE      10,000
    TRANCHE_STEP      0.001 ether
    PER_WALLET            10        free lane counted
    LAUNCH_AT         10,000        paid shares (end of tranche 1)
    FEE_BPS            3,000        30% of a paid fare -> treasury (same tx)
    POOL_BPS           7,000        70% held in-contract for the pool
    TOKENS_PER_SHARE   100,000e18
    TOKEN CAP      8,500,000,000e18

## The two doors

1. Free lane — `freeMint()`, `0x5b70ea9f`
   Exact `msg.value` = 0.0001 BNB, forwarded 100% to the treasury inside the same
   transaction. One per wallet, 1,000 shares total. Mints 1 share = 100,000 DOGGO.
   Does not move the ladder price.

2. Paid ladder — `buy(uint256 n)`, `0xd96a094a`
   `msg.value` = `quote(n)`. A single buy may cross a tranche; every share pays its
   own tranche's price. 30% of the fare goes to treasury, 70% is held for the pool.

Both doors require `agentOk(wallet) == true` — the wallet must hold at least one
Binance .ai Agent ID on the registry above. 10 shares per wallet, free counted.

## Launch

- `launch()` is permissionless once `paidSold >= 10,000`.
- Launch ends the sale: `saleOpen()` turns false and no further share can be bought.
- It fires automatically at 49,000 paid shares.
- BNB side: the whole contract balance. Token side:
  `balance * 100,000e18 / priceAt(paidSold - 1)`.
- BNB is wrapped to WBNB, both sides go to the Pancake V2 pair, and `pair.mint(0x…dEaD)`
  burns the LP permanently. Then `token.open()` unlocks transfers.

At the 10,000 checkpoint: 10 BNB raised, 7 BNB seeded, 0.7B DOGGO beside it,
pool opens at 0.001 BNB per share (MC 50 BNB, LP 14% of it).
If no one launches early, the ladder keeps rising and the pool opens at the last
filled tranche price when it does.
At the full ladder: 145 BNB raised, 101.5 BNB seeded, 2.03B DOGGO, pool opens at
0.005 BNB per share, total supply 7.03B of an 8.5B cap.

## Reads

    saleOpen()            0x99288dbb
    launched()            0x8091f3bf
    minted()              0x4f02c420
    freeTaken()           0xc5ef7668
    paidSold()            0x10b985d4
    heldBnb()             0x2d28fa7d
    sharesLeft()          0x64fcc8b2
    freeLeft()            0xe6842b12
    currentPrice()        0x9d1b464a
    priceAt(uint256)      0x9dab2054
    quote(uint256)        0xed1bd76c
    walletLeft(address)   0x631013a0
    agentOk(address)      0xaff0f7a2
    freeCount(address)    0x958c8848
    paidCount(address)    0x3e8f8723
    launchReady()         0x7632016a

## Hard rules

- There is no refund function and there never will be one. 30% of a paid fare is
  already in the treasury; 70% can only leave through `_launch()`.
- There is no owner: no mint-after-sale, no pause, no blacklist, no fee switch,
  no proxy, no upgrade.
- Tokens cannot move before launch. That is the only lock, and launch removes it.
- Transfers and sells after launch are a plain Pancake V2 pair — no tax on transfer.
- If the ladder never reaches 10,000 paid shares, the pool never opens by itself.
  `launch()` still exists once the threshold is met; below it, there is nothing to call.

## For agents building a call

    to:    <MINT>
    data:  0xd96a094a + uint256(n)     value = quote(n)
           0x5b70ea9f                  value = 0.0001 ether

Never round a value. Never retry with a stale `quote(n)`: re-read after any other buy.