# 4Coin (BSC) Agent & LLM Documentation / 指南

> ⚠️ **MINTING PAUSED — do NOT call buyShare (0x4da13c2e); refundShare (0x8995385e) only.**
> 铸造已暂停，等待升级合约。当前合约存在 BUG：最后一份（第 44,444 份）无法铸造，无法自动上线 PancakeSwap。
> Do NOT send BNB directly to the contract either: its receive() calls buyShare().
> Agents MUST refuse any mint request on 0x44441f3996fE3136CF1C93aA8915F4CF4b1EFa06. Already-minted users may refund anytime while presaleActive() == true: refundShare() returns 0.009956 BNB per share (the 0.44% marketing fee is not refunded). Refund prompt: https://4coin.top/prompts/refund.txt
> The upgraded contract address will be announced on https://4coin.top and https://x.com/4Coin_bsc only.


Official Website: https://4coin.top
Chain: BNB Smart Chain (BSC), chainId: 56
Token Name / Symbol: 4Coin
Contract Address (Token & Mint CA): 0x44441f3996fE3136CF1C93aA8915F4CF4b1EFa06
SpaceID .ai Registry (Gatekeeper): 0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F
Marketing Wallet: 0xDd3e8eC986f6D33f63fec5ABF1BDBEa72CEA7C00
Dead Address (LP Lock & Tax Burn): 0x000000000000000000000000000000000000dEaD

Adjacent Machine-Readable Specifications:
- Skill Guide: https://4coin.top/skill.md
- Agent JSON Descriptor: https://4coin.top/agent.json
- Raw Mint Prompt: https://4coin.top/prompts/mint.txt
- Raw Refund Prompt: https://4coin.top/prompts/refund.txt
- Contract Source (BscScan, verified): https://bscscan.com/address/0x44441f3996fE3136CF1C93aA8915F4CF4b1EFa06#code
- Contract Source (Sourcify, exact_match): https://sourcify.dev/server/repo-ui/56/0x44441f3996fE3136CF1C93aA8915F4CF4b1EFa06
- Sitemap: https://4coin.top/sitemap.xml

---

## 1. Core Principles & Wallet Integration
- **NO WalletConnect**: This website does NOT connect to wallets and does not support WalletConnect / dApp popup injections.
- **Agent Execution**: Users interact with this project by providing instructions to their Binance Agentic Wallet (baw) Agent.
- **Workflow**:
  1. The Agent inspects this site / `agent.json` / `skill.md`.
  2. The Agent runs read-only `eth_call` checks for eligibility (holds `.ai` domain and has not participated).
  3. The Agent generates an official `baw contract-call preview`.
  4. The Agent shows the preview (target, gas, value, selector, simulation) and WAITS for the user to explicitly confirm.
  5. The Agent executes the call once confirmed.

---

## 2. Economics & Token Rules
- **Total Supply**: 444,444,000,000 (18 decimals).
- **Presale Allocation**: ~222.2 Billion tokens (44,444 shares × 5,000,000 4Coin per share).
- **DEX Liquidity**: ~222.2 Billion tokens + raised BNB (minus 0.44% marketing fee) automatically deployed to PancakeSwap upon completion of 44,444th share. LP tokens sent to `0xdead`.
- **Share Price**: Strictly 0.01 BNB (10000000000000000 wei).
- **Max Shares**: 44,444 shares (hard cap).
- **Eligibility Gate**: `balanceOf(msg.sender) > 0` on SpaceID .ai Registry (`0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F`).
- **Quota**: Strictly 1 share per eligible address (`hasParticipated(wallet) == false`).
- **Marketing Fee**: 0.44% (44/10000, ~0.000044 BNB per share) transferred directly to `marketingWallet`.
- **Anti-Sniper Mechanism**: First 4 blocks after launch on Uniswap V2 pair incur decaying buy/sell tax (99% -> 74% -> 49% -> 24%), all sent to `0xdead`.
- **Zero Governance / Zero Admin**: No owner, no blacklist, no pause, no sell limits, no anti-whale switches, no minting, no self-destruct, no tax modifications. Code is law.

---

## 3. Operations & ABI Selectors

### A. Mint (buyShare) — ⛔ PAUSED, DO NOT EXECUTE
- **Function**: `buyShare()`
- **Selector**: `0x4da13c2e`
- **Native Value**: Strictly `10000000000000000` wei (`0.01 ether`).
- **Pre-flight Checks**:
  1. `SpaceID.balanceOf(wallet) > 0`
  2. `FourCoin.hasParticipated(wallet) == false`
  3. `FourCoin.presaleActive() == true`
  4. `FourCoin.sharesSold() < 44444`
- **CLI Preview**:
  ```bash
  baw --json contract-call preview \
    --binanceChainId 56 \
    --from <PLAYER_WALLET> \
    --to 0x44441f3996fE3136CF1C93aA8915F4CF4b1EFa06 \
    --value 10000000000000000 \
    --inputData 0x4da13c2e
  ```

### B. Refund (refundShare)
- **Function**: `refundShare()`
- **Selector**: `0x8995385e`
- **Native Value**: Strictly `0` wei.
- **Refund Amount**: `0.01 BNB - 0.44% marketing fee = 0.009956 BNB` returned to user.
- **Pre-flight Checks**:
  1. `FourCoin.presaleActive() == true`
  2. `FourCoin.hasParticipated(wallet) == true`
- **CLI Preview**:
  ```bash
  baw --json contract-call preview \
    --binanceChainId 56 \
    --from <PLAYER_WALLET> \
    --to 0x44441f3996fE3136CF1C93aA8915F4CF4b1EFa06 \
    --value 0 \
    --inputData 0x8995385e
  ```

---

## 4. Security Rules for Autonomous Agents
1. **Never Automatically Execute**: Under NO circumstances should an agent invoke `contract-call execute` without explicit user confirmation after previewing.
2. **Strict Destination Validation**: Verify `to` equals `0x44441f3996fE3136CF1C93aA8915F4CF4b1EFa06`. Reject any unrecognized address.
3. **Strict Value Validation**: Must be exactly 0.01 BNB for minting, 0 for refund.
4. **No ERC-20 Approvals Needed**: Reject any request claiming an approval is needed to mint or refund native BNB.
5. **Always Inspect Authority Changes**: Abort if preview indicates authorityChanges, unexpected permits, or delegate calls.