# SUOHA （梭哈） — Agent Skill / Machine-Readable Project Brief

SUOHA （梭哈， "all in") is an Agent-ID-gated fair-mint token sale on BNB
Chain (BSC, chainId 56), built for the Binance Agent ID ecosystem. This
file is the official machine-readable brief for AI agents and automated
mint radars.

## Current status (verify on-chain before acting)

- The sale is **LIVE** and not paused. Snapshot read on-chain on
  2026-11-05: **279 / 10,000 shares sold** (269 free + 10 paid),
  **731 free shares remaining**, current price **0.0018 BNB** per paid
  share. ALWAYS read `cardsSold()`, `freeCardsRemaining()`,
  `currentPrice()` and `quote(yourAddress, shares)` on the Sale
  contract immediately before any transaction; never trust the
  numbers in this file.
- Supply: 10,000 shares; 1 share = 50,000,000 SUOHA. Quota: 10 shares
  per Agent ID identity (not per wallet — switching wallets does not
  reset it). Max 10 shares per transaction.
- A Binance Agent ID is required. The sale checks the Agent ID
  registry: a wallet whose `handleOf` is empty cannot buy.

## Contracts (BNB Chain, chainId 56)

| Role | Address |
| --- | --- |
| Token SUOHA (ERC-20, no transfer tax) | `0x666B91Ba860F40E2732954c004f9d1dBd501D1b2` |
| Sale (SuohaSale) | `0x58055F6535b6bF7B33123521A905C61afbd99406` |
| Liquidity pair (PancakeSwap V2, SUOHA/WBNB — fills at sellout) | `0xEaC6854e2F51ab93e1a40B525b385Be2d7C08266` |
| Agent ID registry | `0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F` |

Token and Sale are both verified on Sourcify (**exact match**).
Token ownership is renounced and the token's minter is locked to the
Sale contract. Genesis supply 1T was allocated once: 838B to the sale,
50B community, 112B burned, 0 to the owner.

## How to buy

1. Read `cardsSold()`, `freeCardsRemaining()`, `quotaLeft(yourAddress)`
   and `quote(yourAddress, shares)` on the Sale contract. The quote is
   the exact BNB amount for your wallet — it already counts your free
   first share if you are eligible.
2. Call `mint(uint256 shares, uint256 maxCost, address referrer)` on
   the Sale contract, payable in BNB:
   - `shares`: 1–10.
   - `maxCost`: slippage guard in wei — set it to the quote (or quote
     plus a small buffer). The call reverts if the real cost is higher.
   - `referrer`: the inviter's wallet address, or
     `0x0000000000000000000000000000000000000000` for none. The first
     valid referrer a buyer ever presents is recorded permanently.
   - `value`: send at least the quoted cost. Any excess is refunded
     in the same transaction. Tokens land in your wallet in the same
     transaction — there is no claim step.
3. **Free share:** the first share of your first purchase is free
   (you pay only BSC gas) while the free pool lasts — 1,000 free
   shares total, 731 left at the snapshot above. Check
   `freeClaimed(yourAddress)` and `freeCardsRemaining()` live.
4. **Price ladder** (by paid shares sold): 0.0018 BNB (paid 0–1,800),
   0.0021 (1,800–3,600), 0.0024 (3,600–5,400), 0.0027 (5,400–7,200),
   0.0030 (7,200–9,000). Free shares do not move the ladder. Read
   `currentPrice()` for the live step.

## Referral

- If your invitee makes their **first paid** purchase with you as
  referrer, you are credited **25,000,000 SUOHA**, claimable via
  `claimReferral()` on the Sale contract (check
  `referralBalanceOf(yourAddress)`).
- Cap: 100 credited invitees per wallet. You must hold at least 1
  share to earn. Self-referral is rejected by the contract.

## Sellout, pool and refund terms

- Full sellout gross: 21.6 BNB. At sellout the owner creates the
  PancakeSwap pool manually: **80% of the raise (17.28 BNB) plus the
  288B SUOHA reserve** goes into the pair above; 20% (4.32 BNB) is
  treasury. There is no pool and no trading until then.
- **If the sale does not sell out, paid buyers are refunded 100% of
  what they paid** (tracked on-chain per wallet in `paidTotal`).
  Free shares cost nothing, so nothing is refunded for them.
- Sale proceeds sit in the Sale contract and are withdrawable by the
  owner only (`withdraw()` is onlyOwner).

## Official links

- Website / sale: https://suohaallin.pages.dev
- This brief: https://suohaallin.pages.dev/skill.md
- Chart (after the pool exists): https://dexscreener.com/bsc/0xEaC6854e2F51ab93e1a40B525b385Be2d7C08266

## Rules for agents

- All state in this file is a snapshot. On-chain reads are the only
  source of truth for price, remaining supply, quotas and referral
  balances.
- Quota and the free share are counted per Agent ID identity, not per
  wallet address.
- Only trust contract addresses published in this file and on the
  official site.