文档

概览

Flaggies 是一套 5,555 个像素角色的收藏品：同一个大家庭，画给全部 195 个国家。每个角色都穿着本国的颜色，站在家乡的地标前。

每个 Flaggie 的属性里都写着它的 Base（男性、女性、机器人的涂装，或动物的物种；传奇则是金色版本）和它的 Tier。 95 个传奇是各自国家唯一的金色 Flaggie，所以标为 Tier 1/1。

合约是 BNB Chain 上标准的 ERC-721，支持 ERC-2981 版税和 ERC-4906 元数据更新。每张图片都是 32 × 32 像素，以 1024 × 1024 存放在 IPFS 上。

准备什么

• 一个 Binance Agentic Wallet。铸造是你的 AI 代理通过这个钱包发起的一次合约调用。
• 钱包里有 .ai Agent ID。合约会检查调用的钱包是否持有 SPACE ID 系列的 Agent ID。Agent ID 是灵魂绑定的，不能借来铸造。
• 在币安 App 里开启开发者模式（Developer Mode）。钱包进行任何合约调用都需要它。
• 少量 BNB 作为 gas，第一个之后每个 Flaggie 另付 0.00095 BNB。

安装

最简单的方法是把 skill 文件交给你的代理。它会告诉代理该运行哪些命令，以及什么时候要先问你。

打开 skill.md

如果想自己安装工具：

npm i -g @binance/agentic-wallet
npm i -g https://flaggies.world/flaggies-cli.tgz

每个版本的 SHA-256 发布在 flaggies-cli.tgz.sha256，安装前可以先核对文件。

Flaggies CLI 从不保管私钥。它只读取链上数据、准备调用，每一次签名都通过你的 Agentic Wallet 完成。

命令

每个命令都输出 JSON，好的代理会把它翻成你看得懂的话。

铸造和揭晓永远是三步：预览、你确认、再执行。预览大约五分钟后过期。

铸造规则

• 你的第一个 Flaggie 免费。之后每个 0.00095 BNB。价格写死在合约里，无法更改。
• 每个钱包最多 5 个，按铸造次数计算。卖掉一个并不会让钱包多出额度。
• 代币按顺序铸造：1、2、3……代币 ID 和它将显示的作品没有任何关系。
• 多付的钱会在同一笔交易里退回。不过 CLI 本来就只发送准确金额。
• 在铸造关闭之前，所有者可以暂停和重新开放铸造。一旦关闭，就永久关闭。

揭晓

揭晓之前，每个代币都显示同一个剪影。作品会一次性分配给所有代币。

1. 铸造关闭。要么最后一个 Flaggie 被铸造，要么所有者调用 endMint。从那以后谁都不能再铸造，包括所有者。
2. 揭晓区块定在五个区块之后。铸造关闭时这个区块的哈希还不存在，所以没人能知道它。
3. 那个区块过去之后，任何人都可以调用 reveal()。区块哈希会确定一个随机偏移量，代币 t 显示原始作品 (t − 1 + offset) mod 5555 + 1。

这个哈希在 8,191 个区块内可读，在 BNB Chain 上大约一小时。如果这段时间内没人调用 reveal()，下一次调用会重新设定一个新的揭晓区块，而不是去猜。 合约里没有备用种子，因为任何事先可知的数值，都可能被关闭铸造的人利用。

揭晓之后，调用合约的 originalIdOf(tokenId) 就能知道你的代币显示的是哪一张图片。

市场

Flaggies 有自己的市场合约，专为代理设计。每个操作都是一次合约调用，所以和铸造一样，都走预览、确认、执行的流程。

• 每笔成交都支付版税（Flaggies 设定的 5%），其余归卖家。市场本身不收任何费用。
• 出价的 BNB 存放在市场合约里，直到被接受或被撤回。设了期限的出价过期后，任何人都可以把 BNB 退还给出价人。
• 每个挂单都会过期，最长 90 天。想提前停止出售，请撤下挂单。不要靠转走代币或取消授权来“取消”：只要它们在到期前恢复，挂单也会跟着恢复。
• 挂单只在卖家还持有代币时有效。代币一旦转走，挂单就无法成交，任何人都可以清除它。
• 买家必须按挂单价准确付款。如果在购买确认前价格变了，交易会失败，而不是按另一个价格付款。
• 市场没有所有者。没人能暂停它、修改规则，或动用它为出价保管的 BNB。

Flaggies 是标准的 ERC-721 代币，所以 BNB Chain 上的其他市场也可以上架它们。

验证作品

合约部署时就带着全部 5,555 张图片按原始顺序计算出的 provenance 哈希。图片都在 IPFS 上，你随时可以重新计算：

curl -o images.car "https://ipfs.filebase.io/ipfs/bafybeidbscyk55glpqq73xjqzgw5l2z6w7ckdtlhlpat76cv2gbul2ikqq?format=car"
npx ipfs-car unpack images.car --output images
cd images
for i in $(seq 1 5555); do sha256sum "$i.png" | cut -c1-64; done | tr -d '\n' | sha256sum

结果必须等于合约上 provenance() 的值：

3830c2b685170b48a3d22ac15cbc0dd37c31da3901417b2f4b5559f13166abf9

上面的网关可以换成任何 IPFS 网关或节点，因为这个文件夹是按内容寻址的。

所有者权限

合约有一个所有者。下面列出所有者能做的全部事情，以及合约对它的限制。

所有者不能修改价格、总量或 provenance 哈希，不能免费铸造，不能选择揭晓偏移量，也不能转走任何人的代币。

揭晓后的元数据放在 IPFS 上，地址由所有者设置。任何人都可以用链上的偏移量和经过 provenance 验证的图片，重建出应有的元数据，并在冻结之前进行比对。

错误

地址

Flaggies 合约

0x85Eb23DcA63F1573f81e4A07617a03a7066Be108

Agent ID（SPACE ID）

0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F

图片

ipfs://bafybeidbscyk55glpqq73xjqzgw5l2z6w7ckdtlhlpat76cv2gbul2ikqq

占位元数据

ipfs://bafybeie322w5igdhpbctpijoii6k5yktr467gjnehmx2f5ue2cvf2j5g7a/unrevealed.json

Provenance

0x3830c2b685170b48a3d22ac15cbc0dd37c31da3901417b2f4b5559f13166abf9

链

BNB Chain，ID 56