从连接钱包，到你的第一张 NFT。
一份可以跟着操作的 SoulOG 指南。了解邀请注册、支付授权和铸造流程，也为管理员提供清晰的配置入口。
BSC 测试网 · Chain ID 9701 · 快速开始
准备一个支持 BSC 测试网的浏览器钱包，在应用中点击连接钱包，并确认切换至 BSC Testnet。
- 准备手续费：钱包需要少量测试 BNB（tBNB）支付链上交易手续费。
- 准备邀请地址：向邀请人获取当前合约认可的已激活邀请地址。
- 打开应用：连接钱包后查看注册状态、价格、剩余额度与铸造开关，再按页面提示操作。
02 · 注册与邀请
注册用于建立购买账户与邀请关系。首页点击注册，填写有效的邀请地址，在钱包中确认交易，并等待链上确认。
已激活的邀请人
由有权限的管理员激活，相关状态由 activationStatus 表示。激活状态与购买注册状态是两个不同的状态。
已注册的购买用户
通过 purchaseInvitationCode 注册，前端读取 purchaseActivationStatus 判断是否已注册。
请使用邀请人提供的有效地址，不要仅凭 L2、L3、L4 管理员身份判断地址可作为邀请码。切换新合约后，原合约的注册记录不会自动成为新合约的记录。
交易成功后页面会重新读取注册状态；如果仍显示注册，先核对当前钱包地址、网络和交易是否成功。
03 · 授权与铸造
- 完成注册：连接已注册的钱包，确认当前允许铸造。
- 准备支付代币：支付代币地址从 NFT 合约的
usdt()读取；不要仅按代币名称或主网地址转入资产。 - 选择数量：检查页面显示的单价、总额、余额和可铸造数量。
- Approve 授权：余额充足但授权额度不足时，先确认支付代币授权交易，等待完成。
- Mint 铸造：确认铸造交易，等待链上回执，再到 我的 NFT 查看结果。
04 · 管理员操作
总管理员使用 /NFTAdmin，下级管理员使用 /Admin。连接对应钱包后操作；页面入口本身不会授予链上权限。
总管理员
按页面提供的控制项管理价格、铸造开关、管理员、接收地址、比例和元数据基础地址。每次修改均需钱包确认及链上权限校验。
下级管理员
按当前角色管理下级与激活用户。应用包含 L2、L3、L4 层级；可执行的操作以合约授予的权限为准。
- 核对当前网络、钱包地址和合约地址。
- 先查看现有配置，再填写需要修改的参数。
- 确认钱包中的交易内容，等待交易成功后核对页面数据。
当前 ABI 没有支付代币地址的 setter，后台不能直接更换 usdt() 对应的地址。修改元数据基础地址只更新读取路径，不会自动上传 NFT 图片或 JSON 文件。
05 · 合约与网络
- 网络
- BSC Testnet · 97 / 0x61
- 手续费代币
- tBNB · 18 decimals
- NFT 合约
0x9F6794fEF00527c6B55E9D78ff7E7906F9440E8c↗- 支付代币
- 通过当前 NFT 合约的
usdt()查询。 - RPC
https://data-seed-prebsc-1-s1.bnbchain.org:8545- 元数据
- NFT 图片地址由元数据中的
image字段提供；当前读取位置取决于合约的 tokenURI 和基础地址配置。
本手册依据当前前端和 ABI 编写。价格、总量、推荐比例与管理关系可能变动，请在应用或区块浏览器核实最新状态。
06 · 常见问题
为什么提示邀请码无效或已经激活？
先核对当前合约与钱包，再检查邀请地址是否有效、购买账户是否已经注册。该错误可能对应多种链上校验失败，管理员身份也不等于购买注册资格。
为什么授权后还要确认一次？
Approve 允许 NFT 合约使用支付代币；Mint 才执行铸造。等待授权交易成功后，再确认铸造交易。
为什么提示支付代币没有合约代码？
核对钱包网络、NFT 合约地址以及合约 usdt() 的返回值。相同代币名称或地址在不同网络不一定都有部署。
注册成功了，但按钮没有更新？
确认交易成功而不是仅提交成功，核对钱包地址后刷新页面重新连接。如果 RPC 读取失败，稍后重试并在浏览器确认链上记录。
为什么 NFT 图片不显示？
先确认已经成功铸造，再检查对应 tokenURI、JSON 的 image 字段及图片地址是否可访问。网页部署成功不代表外部图片存储服务一定可用。
更换了新合约，旧角色和注册记录还在吗？
前端读取当前合约的数据。旧合约中的角色、邀请关系、授权与 NFT 不会因为替换网页地址自动迁移。