生产环境说明
<h3> 白名单</h3>
<ul>
<li>
<p>亿链侧生产环境无需配置白名单</p>
</li>
<li>接收回调通知的服务需要填加亿链侧(出口ip:<code>123.60.244.178</code>)的白名单,面向公网则无需配置</li>
</ul>
<hr />
<h3> 公钥配置</h3>
<p>>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>><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>>链账户地址、私钥</p>
<p>>reqNo(与亿链团队排查异常)</p>
<p>>交易哈希(主动查询上链是否成功)</p>
<p>>NFTID/tokenId,必须为整数或者长度为64位的16进制字符串</p>
<hr />
<h3>服务启动通过 API 发起上链</h3>
<p>>铸造、转移、销毁,已通过 <code>witness</code> 广播交易上链</p>
<hr />
<h3>回调结果处理</h3>
<p>>首先应该通过回调来确认交易结果,如果超时未回调(回调会在第一次通知不成功后在一分钟内重试3次,3次不成功则不再进行通知),则需要主动查询来确认交易结果,两种确认交易结果的机制应配合使用。</p>
<hr />
<h3>平台补偿策略</h3>
<p>>交易结果确认后,上链失败的需要根据失败原因重新组装签名上链</p>
<hr />
<h3>链上资产归属</h3>
<p>> 能通过NFTID查询该NFT的拥有者,与预期的链账户地址匹配,参考API中接口示例 -- <code>721</code>
>通过拥有者地址可以查询到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>> 使用交易哈希在区块链浏览器查询,查到相关的交易信息即可,交易哈希即铸造、转移及销毁接口中返回值的<code>txHash</code>,或者通过<code>查询上链结果</code> 接口查询的交易回执中的<code>transactionHash</code>字段的值查询</p>