# 牛來 NiuLai

> 3333 頭在 BNB Smart Chain 上的 ERC-721，每顆的圖案由合約即時生成（on-chain SVG），沒有 IPFS、沒有外部連結、沒有換圖權限。單價 0.0033 BNB。

這個站是給人或 agent 都能用的唯讀介面。所有資料直接從合約 `0x98b177109ce46960e0AdfE191c55Fa50555B81bF` 讀出，不需要 API key、不需要錢包、不需要註冊。任何編號（包含還沒被鑄造的）都能查到圖與特徵。

## 主要頁面

- [鑄造頁與序號機](https://niulai-nft.pages.dev/): 即時 supply／price、輸入 1–3333 任看外觀、貼紙牆、稀有度、合約透明度
- [API 目錄](https://niulai-nft.pages.dev/api): 機器可讀的端點清單
- [llms-full.txt](https://niulai-nft.pages.dev/llms-full.txt): 完整規格、ABI、判斷邏輯

## API（給 agent 直接呼叫）

- [GET /api/collection](https://niulai-nft.pages.dev/api/collection): 回傳 totalSupply／remaining／priceBnb／mintOpen／maxPerTx／nextTokenId，即時鏈上值
- [GET /api/token/{id}](https://niulai-nft.pages.dev/api/token/777): 回傳單顆的 name、attributes（底色／牛角／眼睛／配件）、image（data URI SVG）、minted、owner。未鑄造的編號同樣可查
- [POST /mcp](https://niulai-nft.pages.dev/mcp): MCP server（Streamable HTTP），工具 `get_collection` 與 `get_token`，可直接加進 Claude／ChatGPT／自建 agent
- [POST /a2a](https://niulai-nft.pages.dev/a2a): A2A JSON-RPC，`message/send` 可用自然語言問「#777 長什麼樣」或「現在多少錢」
- [A2A agent card](https://niulai-nft.pages.dev/.well-known/agent-card.json): skills 與傳輸方式

## 合約

- 地址：`0x98b177109ce46960e0AdfE191c55Fa50555B81bF`（BSC，chainId 56）
- 標準：ERC-721，自寫、無代理、不可升級
- 讀取：`totalSupply()` `price()` `mintOpen()` `maxPerTx()` `tokenURI(uint256)` `ownerOf(uint256)`
- 寫入：`mint(uint256 qty) payable`，每顆 0.0033 BNB，每次最多 10 顆，無白名單
- 直接轉 BNB 到合約不會鑄造（沒有 receive），必須呼叫 `mint`

## 設計事實（可驗證）

- 種子 = `keccak256(tokenId ++ "niulai:v3")`，編號固定則圖固定
- 「牛來」「財」是向量輪廓 path，不是字型，任何環境都不會變豆腐塊
- 稀有度由合約分支決定：底色 4×25%、牛角 4×25%、眼睛 5/20/30/25/20%、配件 6 種各 16.7%
- owner 可改價格、開關販售、提領收入；不能改圖、不能凍結、沒有轉帳稅

## 可選

- [BscScan](https://bscscan.com/address/0x98b177109ce46960e0AdfE191c55Fa50555B81bF): 合約原始碼與交易紀錄