亿链 API 文档

witness 1155


生产环境说明

<h3>  白名单</h3> <ul> <li> <p>亿链侧生产环境无需配置白名单</p> </li> <li>接收回调通知的服务需要填加亿链侧(出口ip:<code>123.60.244.178</code>)的白名单,面向公网则无需配置</li> </ul> <hr /> <h3>  公钥配置</h3> <p>&gt;RSA公私钥在线生成地址:<a href="https://www.bchrt.com/tools/rsa/">https://www.bchrt.com/tools/rsa/</a> 建议生成 <strong>1024</strong> 位及以上。</p> <ul> <li> <p>根据手册1、2章即可登录至亿链商户工作台:<a href="https://www.showdoc.com.cn/p/67e2fb88f2765964eae009f492f4fd9e">亿链商户工作台操作手册v1.0</a></p> </li> <li>登录至亿链商户工作台后,根据手册第10章配置RSA公钥即可</li> </ul> <hr /> <h3>项目部署</h3> <p>&gt;<strong>在部署项目前,务必先完成上述<code>公钥配置</code>,如未完成,则相关接口调用会失败</strong></p> <h4>docker检查</h4> <pre><code class="language-shell"># 安装docker,已安装忽略 yum -y install docker # 查看docker 是否启动了 systemctl status docker # 如果没有启动执行 systemctl start docker --now</code></pre> <h4>脚本下载、镜像拉取</h4> <pre><code class="language-shell">wget -O deploy.sh https://gitee.com/e-chain/shell/releases/download/witness-server/deploy.sh chmod a+x deploy.sh sh deploy.sh 请选择部署环境(prod/test): prod 请输入商户编号: 亿链入网商编 请输入商户私钥: 上述公钥配置中对应的rsa私钥 请选择部署合约(1155/721/ly): 选择对应的合约类型</code></pre> <h4>查看日志</h4> <pre><code class="language-shell"># 查看容器名称 docker ps -a # docker方式查看日志 docker logs -f 容器名称 # 日志文件查看 tail -f /data/app/witness-server/logs/witness-server_info.log </code></pre> <h4>执行命令测试项目是否成功启动</h4> <pre><code class="language-shell"># 生成链账户地址 curl --request GET \ --url http://localhost:8888/chain/account/generate_multi/1</code></pre> <h4>亿链配置相关信息查看</h4> <pre><code class="language-shell">路径:/data/app/witness-server/info 查看文件内容:cat chain_info</code></pre> <hr /> <h3>关键信息存储至数据库</h3> <p>&gt;链账户地址、私钥</p> <p>&gt;reqNo(与亿链团队排查异常)</p> <p>&gt;交易哈希(主动查询上链是否成功)</p> <p>&gt;NFTID/tokenId,必须为整数或者长度为64位的16进制字符串</p> <hr /> <h3>服务启动通过 API 发起上链</h3> <p>&gt;铸造、转移、销毁,已通过 <code>witness</code> 广播交易上链</p> <hr /> <h3>回调结果处理</h3> <p>&gt;首先应该通过回调来确认交易结果,如果超时未回调(回调会在第一次通知不成功后在一分钟内重试3次,3次不成功则不再进行通知),则需要主动查询来确认交易结果,两种确认交易结果的机制应配合使用。</p> <hr /> <h3>平台补偿策略</h3> <p>&gt;交易结果确认后,上链失败的需要根据失败原因重新组装签名上链</p> <hr /> <h3>链上资产归属</h3> <p>&gt; 能通过NFTID查询该NFT的拥有者,与预期的链账户地址匹配,参考API中接口示例 -- <code>721</code> &gt;通过拥有者地址可以查询到NFT剩余数量 -- <code>1155</code></p> <h3>区块浏览器信息验证</h3> <p>区块浏览器地址:<a href="https://explorer.e-chain.net.cn/">https://explorer.e-chain.net.cn/</a>#/</p> <p>&gt; 使用交易哈希在区块链浏览器查询,查到相关的交易信息即可,交易哈希即铸造、转移及销毁接口中返回值的<code>txHash</code>,或者通过<code>查询上链结果</code> 接口查询的交易回执中的<code>transactionHash</code>字段的值查询</p>

页面列表

ITEM_HTML