SEMA / agent 接入
SEMA agent 接入
使用持有官方 Agent ID 的钱包,在币安智能链 mint SEMA 解码钥匙。公开查询无需登录。
基本信息
- 总量一万份,每钱包累计最多 mint 十份。
- 前一千份单价为一个泰达币,此后每一千份上涨半个,最高五点五个。跨档订单以报价总额为准。
- 使用币安智能链主网,链编号为
56,准备该链的泰达币及支付网络费的原生币。 - 藏品合约:
0x5c7979CB7308cac5B8A279c3DF234a93ffD41147。 - 支付代币合约:
0x55d398326f99059fF775485246999027B3197955,十八位精度。mint 调用的原生币转入金额为零。
资格检查与 mint 使用同一钱包地址。官方 Agent ID 通过币安应用领取。
一、检查状态与资格
将地址变量替换为钱包的币安智能链地址。
ADDRESS='YOUR_BSC_WALLET_ADDRESS'
curl --fail-with-body https://semabnb.dev/api/mint-status
curl --fail-with-body --get https://semabnb.dev/api/agent --data-urlencode "address=$ADDRESS"
仅在 mintOpen 与 eligible 均为真时继续。
二、报价与 mint
选择一至十份,且不超过钱包剩余额度。
curl --fail-with-body --get https://semabnb.dev/api/mint/quote --data-urlencode "address=$ADDRESS" --data-urlencode 'quantity=1'
报价返回授权数组 approvals、交易 transaction、总额 total 与有效期 expiresAt。总额采用支付代币原始单位,有效期为毫秒时间戳。报价未签名,不锁定库存或价格。
授权数组非空时,只处理第一笔:通过钱包预览并发送,等待成功回执及二十次确认后重新报价。重复至授权数组为空,再预览并发送新报价的交易。
每笔授权及付款均需持有人确认。核对链编号、发送地址、合约与总额,保持返回的 to、data、value 不变,其中 value 应为 0x0。
使用币安 agent 钱包时,先在币安应用完成登录及开发者模式设置,再调用钱包预览:
baw contract-call preview --binanceChainId 56 --from <wallet> --to <descriptor.to> --value 0 --inputData <descriptor.data> --json
持有人确认预览后,执行对应请求:
baw contract-call execute --requestId <requestId-from-wallet-preview> --json
按需完成币安应用确认。付款仍在等待时,先核验原交易回执再决定是否重试。
三、查看钥匙
等待二十次确认后,查询 mint 钱包:
curl --fail-with-body --get https://semabnb.dev/api/nfts --data-urlencode "address=$ADDRESS" --data-urlencode 'cursor=0'
跟随 nextCursor 翻页直到空值。网页“我的藏品”也会显示到账记录。SEALED 表示待揭晓,REVEALED 表示已揭晓并包含等级;等待期间继续查询原藏品即可。
参考资料
- 接口规范:https://semabnb.dev/api/docs
- 合约调用定义:https://semabnb.dev/api/abi
- 白皮书:https://semabnb.dev/SEMA-whitepaper.html
- 币安钱包参考:https://github.com/binance/binance-skills-hub/blob/main/skills/binance-web3/binance-agentic-wallet/references/external-sign.md
状态查询间隔至少十五秒。参数错误时修正参数,资格不符或额度不足时停止,服务暂不可用或请求过多时降低频率。