# 单身 DS

> 3333 只链上单身狗。每一枚的图案由 BNB Chain 上的合约即时生成（on-chain SVG），没有 IPFS、没有外部链接、没有换图权限。前 500 枚免费，之后每枚 1 USDT 等值 BNB。

这个站是给人和 agent 都能用的唯读介面。所有资料直接来自合约 `0xaa253a63229f6e2be13611e52f575d7b166716b3`，不需要 API key、不需要钱包、不需要注册。任何编号（包含还没被铸造的）都能查到图与特征。

## 主要页面

- [铸造页与序号机](https://danxin-3333.pages.dev/): 即时 supply／price／免费余额、输入 1–3333 任看外观、图鉴
- [API 目录](https://danxin-3333.pages.dev/api): 机器可读的端点清单
- [llms-full.txt](https://danxin-3333.pages.dev/llms-full.txt): 完整规格与 ABI

## API（给 agent 直接呼叫）

- [GET /api/collection](https://danxin-3333.pages.dev/api/collection): totalSupply／remaining／freeRemaining／priceBnb／mintOpen／maxPerTx
- [GET /api/token/{id}](https://danxin-3333.pages.dev/api/token/777): 单枚的 name、attributes（底色／眼睛／配件）、image（data URI SVG）、minted、owner。未铸造的编号同样可查
- [POST /mcp](https://danxin-3333.pages.dev/mcp): MCP server（Streamable HTTP），工具 `get_collection` 与 `get_token`
- [POST /a2a](https://danxin-3333.pages.dev/a2a): A2A JSON-RPC，自然语言询问

## 合约

- 地址：`0xaa253a63229f6e2be13611e52f575d7b166716b3`（BSC，chainId 56）
- 标准：ERC-721，自写、无代理、不可升级
- 总量：3333；前 500 枚免费（`FREE_SUPPLY = 500`）
- 读：`totalSupply()` `price()` `mintOpen()` `maxPerTx()` `freeRemaining()` `tokenURI(uint256)` `ownerOf(uint256)`
- 写：`mint(uint256 qty) payable` — 前 500 枚内 value 必须为 0；超过则 value ≥ price × qty
- 直接转 BNB 到合约不会铸造（没有 receive），必须呼叫 `mint`

## 设计事实（可验证）

- 种子 = `keccak256(tokenId ++ "nl5:v1")`，编号固定则图固定
- 中文用向量轮廓 path，不是字体，任何环境都不会变豆腐块
- 稀有度由合约分支决定：4 种 · 各 25%；大眼 40% / 雷射眼 30% / 瞇眼 30%；皇冠 / 金元宝 / 火箭 / 无 · 各 25%
- owner 可改价格、开关贩售、提领收入；不能改图、不能冻结、没有转账税、没有增发函数