SuperAPI AI 工具集

dojo-token

部署与运维

查看项目

更新于 10-15 21:11

技能介绍

用途:在 Dojo 项目中用 Cairo 实现 ERC20 同质化代币与 ERC721 NFT,将其作为外部合约随 Dojo world 一起部署,并配置 Torii 索引代币余额、转账和元数据。

主要能力:可用标准 Dojo 模型实现代币逻辑(如 Gold 模型实现 mint/transfer/balance_of,Weapon 模型实现 mint/transfer/owner_of),也可通过 Origami 库复用符合标准接口的代币组件。支持发出事件(如 TokenTransferred)供 Torii 与客户端追踪。

使用方式:在 Scarb.toml 中通过 build-external-contracts 声明代币合约;在 dojo_dev.toml 的 [[external_contracts]] 中配置合约名、实例名、salt 与构造参数,用 sozo build && sozo migrate 部署。Torii 需显式指定要监听的合约,在 torii.toml 的 [indexing] 中用 ERC20: 或 ERC721: 前缀列出地址,或通过 CLI 传入。索引后可用 SQL 查询 tokens、balances、erc_transfers 三张表,也可用 JavaScript SDK 的 useTokens 读取余额。

适用场景:游戏内货币、NFT 道具、代币余额与转账查询、索引网络已知代币(如 ETH、STRK)。

限制:Torii 从转账事件而非存储读取来索引代币,余额为 0 时需先 mint 或 transfer 产生事件;新增合约后需重启 Torii;地址与前缀须与部署一致。Origami 最新 API 请参考其官方文档。