gamegold

<!DOCTYPE html> <html> <head> <meta charset='utf-8' /> <meta http-equiv='X-UA-Compatible' content='IE=11' /> <title>Docbox</title> <meta name='viewport' content='initial-scale=1,maximum-scale=1,user-scalable=no' /> <link href='css/base.css' rel='stylesheet' /> <link href='css/style.css' rel='stylesheet' /> <link href='css/railscasts.css' rel='stylesheet' /> </head> <body> <div id='app'><div class="container unlimiter" data-reactroot="" data-reactid="1" data-react-checksum="849942503"><div class="fixed-top fixed-right space-left16" data-reactid="2"><div class="fill-light col6 pin-right" data-reactid="3"></div></div><div class="space-top5 scroll-styled overflow-auto pad1 width16 sidebar fixed-left fill-dark dark" data-reactid="4"><div class="pad0x small" data-reactid="5"><div class="small pad0x quiet space-top1" data-reactid="6">简介</div><a href="#游戏金api文档" class="line-height15 pad0x pad00y quiet block " data-reactid="7">游戏金API文档</a><div class="small pad0x quiet space-top1" data-reactid="8">连接器</div><a href="#连接器列表" class="line-height15 pad0x pad00y quiet block " data-reactid="9">连接器列表</a><div class="small pad0x quiet space-top1" data-reactid="10">认证和授权</div><a href="#gip0005-认证和授权" class="line-height15 pad0x pad00y quiet block " data-reactid="11">GIP0005 认证和授权</a><div class="small pad0x quiet space-top1" data-reactid="12">支付协议</div><a href="#gip0006-支付协议" class="line-height15 pad0x pad00y quiet block " data-reactid="13">GIP0006 支付协议</a><div class="small pad0x quiet space-top1" data-reactid="14">道具空投协议</div><a href="#gip0009-游戏道具的空投" class="line-height15 pad0x pad00y quiet block " data-reactid="15">GIP0009 游戏道具的空投</a><div class="small pad0x quiet space-top1" data-reactid="16">道具上链</div><a href="#gip0001-虚拟物品的发行和交易" class="line-height15 pad0x pad00y quiet block " data-reactid="17">GIP0001 虚拟物品的发行和交易</a><div class="small pad0x quiet space-top1" data-reactid="18">游戏商部署指南</div><a href="#部署特约全节点" class="line-height15 pad0x pad00y quiet block " data-reactid="19">部署特约全节点</a><a href="#游戏和特约全节点的交互" class="line-height15 pad0x pad00y quiet block " data-reactid="20">游戏和特约全节点的交互</a><a href="#rpc通讯指令列表" class="line-height15 pad0x pad00y quiet block " data-reactid="21">RPC通讯指令列表</a><div class="small pad0x quiet space-top1" data-reactid="22">小程序多帐号体系</div><a href="#gamegold-多账户体系整改方案" class="line-height15 pad0x pad00y quiet block " data-reactid="23">Gamegold 多账户体系整改方案</a><div class="small pad0x quiet space-top1" data-reactid="24">RPC - 钱包</div><a href="#钱包相关的api" class="line-height15 pad0x pad00y quiet block " data-reactid="25">钱包相关的API</a><div class="small pad0x quiet space-top1" data-reactid="26">区块链浏览器 - 区块</div><a href="#和区块数据相关的接口" class="line-height15 pad0x pad00y quiet block " data-reactid="27">和区块数据相关的接口</a><div class="small pad0x quiet space-top1" data-reactid="28">区块链浏览器 - 地址</div><a href="#和地址相关的接口" class="line-height15 pad0x pad00y quiet block " data-reactid="29">和地址相关的接口</a><div class="small pad0x quiet space-top1" data-reactid="30">区块链浏览器 - 交易</div><a href="#和交易相关的接口" class="line-height15 pad0x pad00y quiet block " data-reactid="31">和交易相关的接口</a><div class="small pad0x quiet space-top1" data-reactid="32">区块链浏览器 - 域名</div><a href="#域名查询类接口" class="line-height15 pad0x pad00y quiet block " data-reactid="33">域名查询类接口</a><div class="small pad0x quiet space-top1" data-reactid="34">区块链浏览器 - 辅助</div><a href="#系统状态查询类接口" class="line-height15 pad0x pad00y quiet block " data-reactid="35">系统状态查询类接口</a></div></div><div class="space-left16" data-reactid="36"><div class="" data-reactid="37"><div class="clearfix" data-reactid="38"><div data-title="游戏金API文档" class="keyline-top section contain clearfix " data-reactid="39"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="40"><h2 id="游戏金api文档">游戏金API文档</h2> <p>欢迎来到游戏金公链API文档站！</p> <p>本站文档采用Markdown格式书写，并通过<a href="https://github.com/tmcw/docbox">docbox</a>转化而来支持 <strong>bold</strong>, <em>emphasis</em>, <del>strikethrough</del> <code>code</code> 等Markdown格式.</p> </div></div><div data-title="连接器列表" class="keyline-top section contain clearfix " data-reactid="41"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="42"><h2 id="连接器列表">连接器列表</h2> <p>连接器是指协助业务点执行连接公链、发起业务请求并获取应答的流程的辅助类，目前有如下不同类型的连接器</p> <ul> <li>开放式连接器</li> <li>授权式连接器</li> <li>控制台连接器</li> </ul> </div></div><div data-title="开放式连接器" class="keyline-top section contain clearfix " data-reactid="43"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="44"><h3 id="开放式连接器">开放式连接器</h3> <p>用于基于浏览器的应用，在未经全节点授权的情况下，访问部分脱敏API 开放式连接器采用 Restful 语法，通过 GET 或 POST 访问API并获得JSON格式的应答开放式连接器受流量控制影响，每分钟最多100次访问</p> <p>可以使用 curl 或者 Postman 等工具进行API调用测试。GET API可直接用浏览器调用， POST API可以通过浏览器插件调用</p> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="45"><h4 id="example-request">Example request</h4> <div class='endpoint dark fill-dark round '> <div class='round-left pad0y pad1x fill-lighten0 code small endpoint-method'>GET</div> <div class='pad0 code small endpoint-url'>http://localhost:17332/public/block/height/:height</div> </div> <pre class='hljs'>curl http://localhost:17332/public/block/height/:height</pre> <div class='endpoint dark fill-dark round '> <div class='round-left pad0y pad1x fill-lighten0 code small endpoint-method'>POST</div> <div class='pad0 code small endpoint-url'>http://localhost:17332/public/block/height/:height</div> </div> <pre class='hljs'>curl -X POST http://localhost:17332/public/block/height/{height}</pre> <h4 id="example-response">Example response</h4> <pre class='hljs'>{ <span class="hljs-attr">"hash"</span>: <span class="hljs-string">"14f73dfc67b3dc7939de6514b6ce230934a5b42cbeadf44038ed276c6390cdab"</span>, <span class="hljs-attr">"confirmations"</span>: <span class="hljs-number">3213</span>, <span class="hljs-attr">"strippedsize"</span>: <span class="hljs-number">651</span>, <span class="hljs-attr">"size"</span>: <span class="hljs-number">687</span>, <span class="hljs-attr">"weight"</span>: <span class="hljs-number">2640</span>, <span class="hljs-attr">"height"</span>: <span class="hljs-number">100</span>, <span class="hljs-attr">"version"</span>: <span class="hljs-number">536870912</span>, <span class="hljs-attr">"versionHex"</span>: <span class="hljs-string">"20000000"</span>, <span class="hljs-attr">"merkleroot"</span>: <span class="hljs-string">"059729c129799cf09ec07f2cf596149d59a5986251cb1143768f54de5ee30579"</span>, <span class="hljs-attr">"coinbase"</span>: <span class="hljs-string">"0164116d696e65642062792067616d65676f6c6404c2a3b0f5080000000000000000"</span>, <span class="hljs-attr">"tx"</span>: [ <span class="hljs-string">"059729c129799cf09ec07f2cf596149d59a5986251cb1143768f54de5ee30579"</span> ], <span class="hljs-attr">"time"</span>: <span class="hljs-number">1532999312</span>, <span class="hljs-attr">"mediantime"</span>: <span class="hljs-number">1532996312</span>, <span class="hljs-attr">"bits"</span>: <span class="hljs-number">545259519</span>, <span class="hljs-attr">"difficulty"</span>: <span class="hljs-number">4.6565423739069247e-10</span>, <span class="hljs-attr">"chainwork"</span>: <span class="hljs-string">"00000000000000000000000000000000000000000000000000000000000000ca"</span>, <span class="hljs-attr">"previousblockhash"</span>: <span class="hljs-string">"35f512ff035b788976714b2cbc925d990968fe1621fb40c917544dfd1b9bf33c"</span>, <span class="hljs-attr">"nextblockhash"</span>: <span class="hljs-string">"47b85cea3ba29563171cb3d6a0e4f5c24d4e76d84e8fb2d9b4417258ffbb9744"</span> }</pre> </div></div><div data-title="授权式连接器" class="keyline-top section contain clearfix " data-reactid="46"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="47"><h3 id="授权式连接器">授权式连接器</h3> <p>用于基于浏览器的游戏客户端，或没有集成核心库的游戏服务端，向SPV节点/全节点发起API调用授权式连接器受流量控制影响，每分钟最多1000次访问详细案例请查阅 gamegoldmanager 项目中的 remoting 对象封装</p> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="48"><h4 id="example-request-1">Example request</h4> </div></div><div data-title="控制台连接器" class="keyline-top section contain clearfix " data-reactid="49"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="50"><h3 id="控制台连接器">控制台连接器</h3> <p>用于集成了核心库（GameGold Core）的控制台或游戏服务端，向SPV节点/全节点发起API调用本连接器使用了核心库提供的 accessWallet 类</p> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="51"><h4 id="example-request-2">Example request</h4> </div></div><div data-title="GIP0005 认证和授权" class="keyline-top section contain clearfix " data-reactid="52"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="53"><h2 id="gip0005-认证和授权">GIP0005 认证和授权</h2> <p>GIP0005 定义了玩家如何利用自己的钱包，向游戏传递互信的协议和流程，包括： 1、认证：玩家钱包向游戏签发证书，游戏可以离线验证该证书，并获得玩家的可信信息 2、授权：游戏根据证书信息，将链上资产和游戏内资产进行同步，之后玩家就可以在游戏内支配已确权的资产</p> </div></div><div data-title="token.user" class="keyline-top section contain clearfix " data-reactid="54"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="55"><h3 id="tokenuser">token.user</h3> <p>游戏客户端向钱包申领指定用户的登录令牌: 输入游戏编号和玩家编号，输出令牌对象。</p> <table> <thead> <tr> <th>Property</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>game_id</code></td> <td>游戏编号</td> </tr> <tr> <td><code>user_id</code></td> <td>游戏内玩家编号</td> </tr> <tr> <td><code>acct_id</code></td> <td>游戏内玩家归属账户</td> </tr> </tbody> </table> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="56"><h4 id="example-request-3">Example request</h4> <h4 id="example-request-body">Example request body</h4> <pre class='hljs'>[ <span class="hljs-string">"{game_id}"</span>, <span class="hljs-string">"{user_id}"</span>, <span class="hljs-string">"{acct_id}"</span> ]</pre> <h4 id="example-response-1">Example response</h4> <pre class='hljs'>{ "data": { "cid": "{game_id}", //CP编号，也就是游戏编号 "uid": "{user_id}", //玩家编号 "time": "{timestamp}", //时间戳 "addr": "{user_address}", //玩家绑定的收款地址 "pubkey": "{user_pubkey}" //玩家收款地址对应的公钥，验签时使用 }, "sig": "{token_sig}" //数据签名，验签时使用 }</pre> </div></div><div data-title="balance.all" class="keyline-top section contain clearfix " data-reactid="57"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="58"><h3 id="balanceall">balance.all</h3> <p>查询账户余额。</p> <p>入口参数</p> <table> <thead> <tr> <th>Property</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>acct_id</code></td> <td>游戏内玩家归属账户</td> </tr> </tbody> </table> <p>@note 对微信小程序而言，acct_id一般取值于openid，也就是说，同一个微信用户的不同游戏地址，会归类存储于同一个acct_id下</p> <ul> <li>balance.confirmed [$acct_id] 只包括确认交易的余额</li> </ul> <ul> <li>balance.unconfirmed [$acct_id] 包括未确认交易在内的余额</li> </ul> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="59"><h4 id="example-request-4">Example request</h4> <h4 id="example-response-2">Example response</h4> <pre class='hljs'>{ "unconfirmed": 5000, //单位尘 "confirmed": 5000 //单位尘 }</pre> <h4 id="衍生指令">衍生指令</h4> <pre class='hljs'>0.00005 //单位石</pre> <pre class='hljs'>0.00005 //单位石</pre> </div></div><div data-title="queryProps" class="keyline-top section contain clearfix " data-reactid="60"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="61"><h3 id="queryprops">queryProps</h3> <p>游戏向核心网发送游戏编码、玩家地址，向对等网络查询该玩家持有的道具列表。</p> <ul> <li>开放式连接器 Y - 授权式连接器 Y - 控制台连接器 Y -</li> </ul> <table> <thead> <tr> <th>Property</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>game_id</code></td> <td>游戏编号</td> </tr> <tr> <td><code>user_addr</code></td> <td>游戏内玩家的有效地址</td> </tr> </tbody> </table> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="62"><div class='endpoint dark fill-dark round '> <div class='round-left pad0y pad1x fill-lighten0 code small endpoint-method'>POST</div> <div class='pad0 code small endpoint-url'>http://localhost:17332/public/prop/query/{game_id,</div> </div> <h4 id="可访问性">可访问性</h4> <h4 id="example-request-5">Example request</h4> <h4 id="example-request-body-1">Example request body</h4> <pre class='hljs'>[ <span class="hljs-string">"{game_id}"</span>, <span class="hljs-string">"{user_addr}"</span> ]</pre> <h4 id="example-response-3">Example response</h4> <pre class='hljs'>[ { <span class="hljs-attr">"pid"</span>: <span class="hljs-string">"{道具编号}"</span>, <span class="hljs-attr">"cid"</span>: <span class="hljs-string">"{游戏编号}"</span>, <span class="hljs-attr">"oid"</span>: <span class="hljs-string">"{道具原始编号}"</span>, <span class="hljs-attr">"oper"</span>: <span class="hljs-string">"exchange"</span>, <span class="hljs-attr">"prev"</span>: { <span class="hljs-attr">"hash"</span>: <span class="hljs-string">"{转入交易的哈希}"</span>, <span class="hljs-attr">"index"</span>: <span class="hljs-string">"{关联的输出索引}"</span> }, <span class="hljs-attr">"current"</span>: { <span class="hljs-attr">"hash"</span>: <span class="hljs-string">"{道具所在交易的哈希}"</span>, <span class="hljs-attr">"index"</span>: <span class="hljs-string">"{关联的输出索引}"</span> }, <span class="hljs-attr">"gold"</span>: <span class="hljs-string">"{含金量}"</span>, <span class="hljs-attr">"confirm"</span>: <span class="hljs-string">"{确认数}"</span>, <span class="hljs-attr">"root"</span>: { <span class="hljs-attr">"hash"</span>: <span class="hljs-string">"{道具首发交易的哈希}"</span>, <span class="hljs-attr">"index"</span>: <span class="hljs-string">"{关联的输出索引}"</span> } } ]</pre> </div></div><div data-title="GIP0006 支付协议" class="keyline-top section contain clearfix " data-reactid="63"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="64"><h2 id="gip0006-支付协议">GIP0006 支付协议</h2> </div></div><div data-title="协议说明" class="keyline-top section contain clearfix " data-reactid="65"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="66"><h3 id="协议说明">协议说明</h3> <p>Layer: Consensus</p> <p>Title: Payment Protocol</p> <p>Status: Draft V0.1</p> <p>Author：bookman</p> <p>Type: Standards Track</p> <p>Created: 2018-06-19</p> <p>Summary：为游戏玩家提供安全便捷的支付结算通道</p> <p><strong>业务主体描述</strong></p> <p>1、玩家玩家在游戏提供的交互页面上选取商品并生成订单，使用自己的钱包支付订单，在订单在线兑付后确认订单流程完成</p> <p>2、钱包玩家从钱包跳转到游戏，在这个跳转过程中，送去了登录令牌，如果通过了验证，就可以顺利登录游戏玩家登录后，可以浏览到自己已有的道具（登录地址上的所有该游戏的道具）玩家在游戏商城里点选商品后，将形成一个订单，点击"支付"，跳回钱包玩家在钱包内签署该订单的支付交易，订单被网络确认后开始广播，玩家的钱包将会收到交易确认消息玩家可以在钱包中，通过检索相关订单记录，来查看相关订单支付详情玩家回到游戏中，再次点击"查看订单列表"，可以看到订单状态发生了变化，同时订单也执行了兑付</p> <p>3、游戏游戏负责提供商品列表、购物车以帮助玩家生成订单，并提供最终的订单在线兑付功能开放订单确认回调接口，以接收特约全节点发送的订单状态通告对已受理订单，定期向特约全节点查询其确认数，当达到预设阀值（例如6个）时触发兑付流程</p> <p>4、特约全节点因为特约全节点是游戏自行建立的全节点，所以游戏得以获得充分的授权。特约全节点为游戏提供订单在线兑付功能（链上道具的制备和转移），注意订单中的普通商品的兑付由游戏自行完成特约全节点还为游戏提供交易确认通知、订单存档和历史查询等功能特约全节点可以提供对等网络的一般性功能，也能面向游戏提供特约服务功能</p> <p>5、对等网络对等网络为各类合法交易提供中继广播、打包功能。</p> <p><strong>时序图</strong></p> <pre><code> 玩家钱包游戏特约全节点对等网络 | | | | | | make order | | | | |———————————————+———————————————>| | | | | send order | | | | |<———————————————| | | | | pay order | | | | |————————————————+—————————————————+—————————————————>| | | | | confirm tx | | | | |<—————————————————| | | | confirm order | | | | |<————————————————| | | | | implement order | | | | |————————————————>| | | | | | send prop | | | | |—————————————————>| | | | | confirm tx | | | | |<—————————————————| | | | confirm prop | | | | |<————————————————| | | | provide prop | | | |<——————————————+————————————————| | | | | | query order | | | | |<———————————————>| | | | | | | | | | | | </code></pre> <ul> <li>√ make order ：玩家在商城选购商品形成订单</li> <li>√ send order ：游戏将订单转发给钱包</li> <li>√ pay order ：钱包收到游戏转入的订单（或玩家手动输入的订单），签发订单支付交易并广播至对等网络</li> <li>√ confirm tx ：特约全节点收到对等网络交易确认通知池传导通知：调用游戏的订单确认回调接口，通告订单已收到链传导通知： 1、将交易信息记录到 layout.o 条目下 2、调用游戏的订单确认回调接口，通告订单已确认，附加确认次数</li> <li>√ confirm order ：特约全节点通知游戏订单已确认</li> <li>√ implement order ：游戏收到订单确认回调请求，分情况刷新订单状态，例如"已收到，处理中。。。"、"已确认，确认数N"等等 1、如果是内部商品，直接兑付 2、如果是上链商品，必须向特约全节点申请订单兑付，以完成道具制备（ prop.send ）和转移（ prop.send ）等操作</li> <li>√ send prop ：特约全节点接受了游戏的订单兑付请求，签发道具制备转移交易并广播至对等网络</li> <li>√ confirm tx ：特约全节点收到对等网络交易确认通知</li> <li>√ confirm prop ：特约全节点通知游戏道具已确认</li> <li>√ provide prop ：游戏向玩家核发道具（去重处理）</li> <li>√ query order ：游戏向特约全节点核查待处理订单实时状态：指定游戏编号、订单流水号集合，查询对应订单详情</li> </ul> <p><strong>订单状态图</strong></p> <pre><code> _____支付_____确认________履行____ | ↓ ↓ ↓ 订单生成已支付已确认已履行已过期 | ↓ ↓ ↓ ↑ | 进入内存池上链兑付订单内容 | |_____________________________________________| </code></pre> <p><strong>认证和通讯安全</strong></p> <ul> <li>游戏APP和服务端通讯安全自行负责</li> <li>玩家钱包和对等网络间依托现有的P2P通讯方式</li> <li>玩家钱包登录游戏APP：送去登录令牌，令牌中包含用户私钥签署过的数据</li> <li>游戏服务端访问对等网络：对于脱敏操作，可以直接明文通讯，如果出于对DDOS的担心，可以考虑一些流量控制方案</li> <li>游戏服务端和特约全节点（远程钱包）之间采用 HMAC 签名算法，确保两者相互认证和通讯数据不可篡改一、游戏服务端访问特约全节点（远程钱包） 1、远程钱包必须为游戏服务端分配令牌编号和令牌固定量，可以通过本地制备指令 token.auth 屏显制备内容 2、每个游戏服务端配置被分配的令牌编号和令牌固定量，并以离线手动更新方式，和远程钱包的配置保持一致 3、游戏服务端使用远程钱包RPC接口前，必须先发起命令获取自己的令牌随机量，来实现该随机量在服务端/远程钱包两端的同步 4、游戏服务端将获取的令牌随机量、本地令牌固定量合成为访问令牌，将令牌编号、访问令牌附着在业务指令中一起上传 5、远程钱包收到上传的令牌编号、访问令牌，和本地HMAC计算结果比对，一致则允许执行业务指令，否则拒绝 6、对于WebSocket模式，可以在连接认证时缓存认证结果，连接期间无需再次上传访问令牌二、特约全节点访问游戏服务端 1、特约全节点在访问游戏服务端接口时，在参数上附加相应的令牌编号、令牌随机量，以及据此计算的访问令牌 2、游戏服务端通过本地的令牌固定量、接口上收到的令牌随机量以及参与计算的数据（事先约定）计算访问令牌，和收到的访问令牌比对，实现认证</li> <li>全节点RPC接口。全节点RPC接口上实现的操作指令分为三类： 1、任何连接者都可以执行的指令 2、本地连接才可以执行的指令 3、限定执行指令，例如限定钱包、限定来访者令牌等</li> <li> <p><strong>线上版本使用HTTPS协议替换所有HTTP协议</strong></p> <ul> <li>可靠的证书生成工具例如 Openssl</li> <li>ssl开启设定全局统一</li> </ul> </li> </ul> </div></div><div data-title="order.pay" class="keyline-top section contain clearfix " data-reactid="67"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="68"><h3 id="orderpay">order.pay</h3> <p>钱包接收订单、签发支付交易并广播至对等网络。 @note 采用 OP_RETURN 将订单流水和支付交易捆绑在一起，用以作为兑付凭证 @note 游戏APP可以采用 URL Schema / 二维码图像等方式，将订单内容 [{game_id} {user_id} {order_sn} {order_sum}] 传递给钱包。</p> <ul> <li>开放式连接器 N - 授权式连接器 Y - 控制台连接器 Y -</li> </ul> <table> <thead> <tr> <th>Property</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>game_id</code></td> <td>游戏编号</td> </tr> <tr> <td><code>user_id</code></td> <td>玩家编号</td> </tr> <tr> <td><code>order_sn</code></td> <td>订单编号</td> </tr> <tr> <td><code>order_sum</code></td> <td>订单金额</td> </tr> <tr> <td><code>account</code></td> <td>指定结算的钱包账户，一般为微信用户的openid</td> </tr> </tbody> </table> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="69"><h4 id="可访问性-1">可访问性</h4> <h4 id="example-request-6">Example request</h4> <h4 id="example-request-body-2">Example request body</h4> <pre class='hljs'>[ <span class="hljs-string">"{game_id}"</span>, <span class="hljs-string">"{user_id}"</span>, <span class="hljs-string">"{order_sn}"</span>, <span class="hljs-string">"{order_sum}"</span>, <span class="hljs-string">"{account}"</span> ]</pre> <h4 id="example-response-4">Example Response</h4> </div></div><div data-title="order.query" class="keyline-top section contain clearfix " data-reactid="70"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="71"><h3 id="orderquery">order.query</h3> <p>查询订单支付状态。一般从游戏服务端发起请求。</p> <ul> <li>开放式连接器 N - 授权式连接器 Y - 控制台连接器 Y -</li> </ul> <table> <thead> <tr> <th>Property</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>game_id</code></td> <td>游戏编号</td> </tr> <tr> <td><code>order_group</code></td> <td>订单流水号数组</td> </tr> </tbody> </table> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="72"><h4 id="可访问性-2">可访问性</h4> <h4 id="example-request-7">Example request</h4> <h4 id="example-request-body-3">Example request body</h4> <pre class='hljs'>[ <span class="hljs-string">"{game_id}"</span>, <span class="hljs-string">"{order_group}"</span> ]</pre> <h4 id="example-response-5">Example response</h4> <pre class='hljs'>[ { <span class="hljs-attr">"oper"</span>: <span class="hljs-string">"pay"</span>, <span class="hljs-attr">"cid"</span>: <span class="hljs-string">"{游戏编号}"</span>, <span class="hljs-attr">"uid"</span>: <span class="hljs-string">"{玩家编号}"</span>, <span class="hljs-attr">"sn"</span>: <span class="hljs-string">"{订单号}"</span> } ]</pre> </div></div><div data-title="prop.order" class="keyline-top section contain clearfix " data-reactid="73"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="74"><h3 id="proporder">prop.order</h3> <p>游戏服务端制备并送出道具。</p> <ul> <li>开放式连接器 N - 授权式连接器 Y - 控制台连接器 Y -</li> </ul> <table> <thead> <tr> <th>Property</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>game_id</code></td> <td>游戏编号</td> </tr> <tr> <td><code>prop_ori_id</code></td> <td>道具原始</td> </tr> <tr> <td><code>prop_value</code></td> <td>道具含金量</td> </tr> <tr> <td><code>user_addr</code></td> <td>游戏内玩家的有效地址</td> </tr> </tbody> </table> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="75"><h4 id="可访问性-3">可访问性</h4> <h4 id="example-request-8">Example request</h4> <h4 id="example-request-body-4">Example request body</h4> <pre class='hljs'>[ <span class="hljs-string">"{game_id}"</span>, <span class="hljs-string">"{prop_ori_id}"</span>, <span class="hljs-string">"{prop_value}"</span>, <span class="hljs-string">"{user_addr}"</span> ]</pre> <h4 id="example-response-6">Example response</h4> <pre class='hljs'>{ <span class="hljs-attr">"hash"</span>: <span class="hljs-string">"{当前道具所在交易哈希}"</span>, <span class="hljs-attr">"cid"</span>: <span class="hljs-string">"{游戏编码}"</span>, <span class="hljs-attr">"pid"</span>: <span class="hljs-string">"{道具编码}"</span>, <span class="hljs-attr">"oid"</span>: <span class="hljs-string">"{道具原始编码}"</span>, <span class="hljs-attr">"gold"</span>: <span class="hljs-string">"{道具含金量}"</span>, <span class="hljs-attr">"addr"</span>: <span class="hljs-string">"{目标地址}"</span>, }</pre> </div></div><div data-title="GIP0009 游戏道具的空投" class="keyline-top section contain clearfix " data-reactid="76"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="77"><h2 id="gip0009-游戏道具的空投">GIP0009 游戏道具的空投</h2> <p>Layer: Consensus</p> <p>Title: Bonus for Potential Game Player</p> <p>Status: Draft</p> <p>Author：bookman</p> <p>Type: Standards Track</p> <p>Created: 2018-08-15</p> <p>Summary：向潜在游戏玩家分发游戏道具的解决方案</p> </div></div><div data-title="游戏道具空投流程" class="keyline-top section contain clearfix " data-reactid="78"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="79"><h3 id="游戏道具空投流程">游戏道具空投流程</h3> <p>1、游戏厂商批量生成若干道具 2、游戏厂商查询潜在游戏玩家，向其地址投放道具 3、游戏玩家根据地址中包含的游戏信息，申领游戏专用地址 4、钱包系统将先前收到的道具转入该专用地址，以便在游戏中顺利确权 5、玩家登录游戏，使用先前获取的道具</p> <p>@note 关于游戏地址钱包按照游戏ID + 玩家游戏内ID 的组合，为玩家分配游戏专用地址。玩家在游戏中获取的道具将会发往该地址。空投道具的行为一般发生于玩家进入游戏前，因此游戏只能将其投放至玩家玩过的其它游戏的专用地址。这些错位的道具无法在该专用地址对应的游戏中确权，因此当玩家真正进入目标游戏时，钱包必须主动提示用户进行道具的迁移。当迁移完成后，用户再次登录目标游戏时，就可以对这些道具进行确权，从而在游戏中合法使用它们。</p> </div></div><div data-title="GIP0001 虚拟物品的发行和交易" class="keyline-top section contain clearfix " data-reactid="80"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="81"><h2 id="gip0001-虚拟物品的发行和交易">GIP0001 虚拟物品的发行和交易</h2> <p>Layer: Consensus</p> <p>Title: Virtual Props' Publish and Trade</p> <p>Status: Draft V0.1</p> <p>Author：bookman</p> <p>Type: Standards Track</p> <p>Created: 2018-04-24</p> <p>Summary：提出了涵盖虚拟物品的发行、转移、竞价销售、熔铸功能的完整解决方案，将于主链发布之日默认激活。</p> </div></div><div data-title="概述" class="keyline-top section contain clearfix " data-reactid="82"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="83"><h3 id="概述">概述</h3> <p>1、CP Register：生产者注册信息 2、CP Change：生产者修改信息/转移注册信息所有权 3、VP Create：生产者发行虚拟物品，VP被制造出来，处于Produce状态，可以进入Exchange状态，也可以进入Found状态 4、VP Exchange：VP在生产者和用户、用户和用户间转移，可以在Exchange状态上自循环，也可以进入Sale或Found状态 5、VP Sale：VP被出售，进入Sale状态（竞价环节），可以自循环（通过Buy操作多轮竞价）。无论成功与否，最终都将回到Exchange状态 6、VP Found：VP被熔铸为Coin，进入零钱包，这是终极状态，VP除币值外的所有属性被不可逆转的抹除</p> <p>虚拟物品状态机如下所示：</p> <pre><code>_________________________________ </code></pre> <p> / | / ↓ Produce --> Exchange --> Sale Found ↑ | | ↑ ↑ || ↑ | | | | |_|| | |<strong>| | |<strong>__</strong></strong>| | |<strong><strong><strong><strong>__</strong></strong></strong></strong>|</p> </div></div><div data-title="cp.list" class="keyline-top section contain clearfix " data-reactid="84"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="85"><h3 id="cplist">cp.list</h3> <p>查询系统中现有的所有CP列表：cp.list</p> <ul> <li>开放式连接器 N - 授权式连接器 Y - 控制台连接器 Y -</li> </ul> <table> <thead> <tr> <th>Property</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>cid</td> <td>CP唯一编号，由系统内部分配</td> </tr> <tr> <td>name</td> <td>CP的名称，由注册者设定，全局唯一</td> </tr> <tr> <td>url</td> <td>CP的URL地址</td> </tr> <tr> <td>ip</td> <td>CP的IP地址，可以为空</td> </tr> <tr> <td>current.hash</td> <td>注册信息所在交易的哈希</td> </tr> <tr> <td>current.index</td> <td>注册信息在交易中的序列号</td> </tr> <tr> <td>current.address</td> <td>注册信息关联的地址</td> </tr> <tr> <td>owned</td> <td>是否归属于当前钱包（仅对钱包客户端有效）</td> </tr> <tr> <td>status</td> <td>保留字段</td> </tr> </tbody> </table> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="86"><h4 id="可访问性-4">可访问性</h4> <h4 id="example-request-9">Example Request</h4> <h4 id="example-response-7">Example Response</h4> <pre class='hljs'>[ { <span class="hljs-attr">"cid"</span>: <span class="hljs-string">"237da570-b725-11e8-a7ca-3f8b903ba033"</span>, <span class="hljs-attr">"name"</span>: <span class="hljs-string">"hello"</span>, <span class="hljs-attr">"url"</span>: <span class="hljs-string">"127.0.0.1"</span>, <span class="hljs-attr">"ip"</span>: <span class="hljs-string">""</span>, <span class="hljs-attr">"current"</span>: { <span class="hljs-attr">"hash"</span>: <span class="hljs-string">"bd3a3656b94fd9d61ca7a3721c385e29e4b12176b9efa8fe0702ee5b95ff25c4"</span>, <span class="hljs-attr">"index"</span>: <span class="hljs-number">0</span>, <span class="hljs-attr">"address"</span>: <span class="hljs-string">"tb1qr790zz32jyyje8letxkavdv93qf7dmp0wjx3s0"</span> }, <span class="hljs-attr">"owned"</span>: <span class="hljs-literal">true</span>, <span class="hljs-attr">"status"</span>: <span class="hljs-number">1</span> } ]</pre> </div></div><div data-title="token.auth" class="keyline-top section contain clearfix " data-reactid="87"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="88"><h3 id="tokenauth">token.auth</h3> <p>终端令牌制备指令： token.auth cpids @note： cpids 为逗分字符串，可携带一条或多条CPID信息</p> <ul> <li>开放式连接器 N - 授权式连接器 Y - 控制台连接器 Y -</li> </ul> <p>null</p> <p>@note 控制台屏显内容： 1111: 038253ce66d5615a6efe9f262c2e96a305f9fab5e9ebb39688c55919b784fb8f88 2222: 024cc9367ef61ab6f5842f50c50717434255a6427e2a3e3486f39000f8d4fce2ac 3333: 03e434d1b87c191d31535a82adfb33c81fb2d1a56a3a5f9182673e92631382698b</p> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="89"><h4 id="可访问性-5">可访问性</h4> <h4 id="example-request-10">Example Request</h4> <h4 id="example-response-8">Example Response</h4> </div></div><div data-title="cp.create" class="keyline-top section contain clearfix " data-reactid="90"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="91"><h3 id="cpcreate">cp.create</h3> <p>CP注册指令：cp.create "name" "url" ["ip"]</p> <p>@note: 注册成功后，生产者由系统生成的全局唯一编码 cid 所标识，称为CP编码 name 由汉字、大小写字母、数字、下划线和点组成的标识字符串，长度4~20，必须是全局唯一的，不可重复 ip是可选项，但是结合ip注册，可以得到类似域名寻址的效果，或者说，可以作为 .gamegold 的DNS替代服务使用共识变量 registerFee 决定了注册费用，这笔费用被系统冻结无人可以花费 *该指令一般在主节点管理后台/控制台执行</p> <ul> <li>开放式连接器 N - 授权式连接器 Y - 控制台连接器 Y -</li> </ul> <p>入口参数</p> <table> <thead> <tr> <th>Property</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>name</td> <td>CP名称</td> </tr> <tr> <td>url</td> <td>CP的URL地址</td> </tr> <tr> <td>[ip]</td> <td>CP的IP地址</td> </tr> </tbody> </table> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="92"><h4 id="可访问性-6">可访问性</h4> <h4 id="example-request-11">Example Request</h4> <h4 id="example-response-9">Example Response</h4> <pre class='hljs'>{ "name": "testfellow3", //CP名称 "url": "http://920.cc", //URL地址 "ip": "", //IP地址 "cid": "0a021c00-bb23-11e8-8848-233ceb544c5d", //CP编码 "oper": "cpRegister", //操作类型 "txid": "412408ea931b6b8942c8fd865c1a6da46899b0ef30522884ba0b05d5b704dcdc" //CP记录所在交易的哈希，小端格式 }</pre> </div></div><div data-title="cp.change" class="keyline-top section contain clearfix " data-reactid="93"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="94"><h3 id="cpchange">cp.change</h3> <p>CP修改/转让指令： cp.change "name" ["url" "ip" "addr"]</p> <p>@note: 可以只修改名称，但修改后的名称必须全局唯一，而被修改掉的名字将可以被他人再次利用如果输入了 addr ，则表示向该地址转让注册信息修改、转让没有额外的手续费用 *该指令一般在主节点管理后台/控制台执行，而非在钱包上执行</p> <p>入口参数</p> <table> <thead> <tr> <th>Property</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>name</td> <td>CP名称</td> </tr> <tr> <td>newname</td> <td>CP的新名称，如不想改名称则复制原名称</td> </tr> <tr> <td>[url]</td> <td>CP的URL地址，可以填写空串，如忽略则后续不可再有参数</td> </tr> <tr> <td>[ip]</td> <td>CP的IP地址，可以填写空串，如忽略则后续不可再有参数</td> </tr> <tr> <td>[addr]</td> <td>新的接收地址，！！！若填充此字段，相当于转让CP所有权</td> </tr> </tbody> </table> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="95"><h4 id="example-request-12">Example Request</h4> <h4 id="example-response-10">Example Response</h4> <pre class='hljs'>{ "name": "test1", //CP原有名称 "newName": "test2", //CP新的名称 "url": "http://gamegold.xin", //CP最新的URL "ip": "", //CP最新的IP "addr": "tb1qf0md5h9erhqwfwcrshdhkfpg93h0hz2jwk6rwm", //CP最新的地址 "cid": "9c998be0-bb26-11e8-948a-33c872827589", //CP编码 "oper": "cpChange", //操作类型 "txid": "92b1ec0a161f2554d0404cce7a10f70050616e304758e3de0338a10b2f172e41" //CP记录所在交易的哈希，小端格式 }</pre> </div></div><div data-title="cp.ById" class="keyline-top section contain clearfix " data-reactid="96"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="97"><h3 id="cpbyid">cp.ById</h3> <p>根据ID查询CP注册信息</p> <p>入口参数</p> <table> <thead> <tr> <th>Property</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>cid</td> <td>CP编码</td> </tr> </tbody> </table> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="98"><h4 id="example-request-13">Example Request</h4> <h4 id="example-response-11">Example Response</h4> <pre class='hljs'>{ <span class="hljs-attr">"cid"</span>: <span class="hljs-string">"xxxxxxxx-vallnet-boss-xxxxxxxxxxxxxx"</span>, <span class="hljs-attr">"name"</span>: <span class="hljs-string">"BOSS"</span>, <span class="hljs-attr">"url"</span>: <span class="hljs-string">"920.cc"</span>, <span class="hljs-attr">"ip"</span>: <span class="hljs-string">"*"</span> }</pre> </div></div><div data-title="cp.ByName" class="keyline-top section contain clearfix " data-reactid="99"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="100"><h3 id="cpbyname">cp.ByName</h3> <p>根据名称查询CP注册信息</p> <p>入口参数</p> <table> <thead> <tr> <th>Property</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>name</td> <td>CP名称</td> </tr> </tbody> </table> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="101"><h4 id="example-response-12">Example Response</h4> <pre class='hljs'>{ <span class="hljs-attr">"cid"</span>: <span class="hljs-string">"xxxxxxxx-vallnet-boss-xxxxxxxxxxxxxx"</span>, <span class="hljs-attr">"name"</span>: <span class="hljs-string">"BOSS"</span>, <span class="hljs-attr">"url"</span>: <span class="hljs-string">"920.cc"</span>, <span class="hljs-attr">"ip"</span>: <span class="hljs-string">"*"</span>, <span class="hljs-attr">"current"</span>: { <span class="hljs-attr">"hash"</span>: <span class="hljs-string">"f1573c53d45441e7d38b1e06ff3687bc26f716b0af06bc6cd219fb3768406087"</span>, <span class="hljs-attr">"index"</span>: <span class="hljs-number">0</span>, <span class="hljs-attr">"address"</span>: <span class="hljs-string">"tb1qpmzc83qca4snn62ee0eul8rqtzrp5a5q0f96rs"</span> }, <span class="hljs-attr">"owned"</span>: <span class="hljs-literal">true</span>, <span class="hljs-attr">"status"</span>: <span class="hljs-number">1</span> }</pre> </div></div><div data-title="prop.create" class="keyline-top section contain clearfix " data-reactid="102"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="103"><h3 id="propcreate">prop.create</h3> <p>虚拟道具注册指令 </p> <p>入口参数</p> <table> <thead> <tr> <th>Property</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>cid</td> <td>发行道具的CP编码</td> </tr> <tr> <td>oid</td> <td>发行道具的原始编码</td> </tr> <tr> <td>gold</td> <td>道具包含的虚拟币值，单位是尘</td> </tr> </tbody> </table> <p>@note 注册时需要提供两个参数， cid 必须是有效的生产者编码， gold 表示该道具的含金量注册完毕后，还必须等待至少一个确认，才能正式发行成功进入道具序列的硬币，会从钱包硬币列表中消失，不可用于转账业务操作中 *该指令一般在主节点管理后台/控制台执行，而非在钱包上执行</p> <p>@note 现行游戏金的单位包括：</p> <ul> <li>d：尘(dust)，游戏金的最小计量单位</li> <li>g：氪(gram)，相当于1000尘</li> <li>K：金(kg)，相当于1000氪</li> <li>S：石(stone)，相当于100金</li> </ul> <p>输入参数中，统一使用尘作为单位输出参数中，视情况使用尘或者石 UI中，视情况使用尘、氪、金、石</p> <table> <thead> <tr> <th>Property</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>oper</td> <td>操作类型码</td> </tr> <tr> <td>cid</td> <td>CP编码</td> </tr> <tr> <td>oid</td> <td>道具原始编码</td> </tr> <tr> <td>gold</td> <td>道具包含的虚拟币值，单位是尘</td> </tr> <tr> <td>pid</td> <td>道具编码</td> </tr> <tr> <td>index</td> <td>交易内索引</td> </tr> <tr> <td>hash</td> <td>所在交易的哈希，大端格式</td> </tr> <tr> <td>txid</td> <td>所在交易的哈希，小端格式</td> </tr> </tbody> </table> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="104"><h4 id="example-request-14">Example Request</h4> <h4 id="example-response-13">Example Response</h4> <pre class='hljs'>{ <span class="hljs-attr">"oper"</span>: <span class="hljs-string">"new"</span>, <span class="hljs-attr">"cid"</span>: <span class="hljs-string">"b77a9b90-bbc4-11e8-9203-1ff8357db148"</span>, <span class="hljs-attr">"oid"</span>: <span class="hljs-string">"gamemonkey0003"</span>, <span class="hljs-attr">"gold"</span>: <span class="hljs-number">10000</span>, <span class="hljs-attr">"pid"</span>: <span class="hljs-string">"15e1a160-bbc5-11e8-9203-1ff8357db148"</span>, <span class="hljs-attr">"index"</span>: <span class="hljs-number">0</span>, <span class="hljs-attr">"txid"</span>: <span class="hljs-string">"d88d0e9ed243fb767643ea1dea754af9aab53e3eab274c4c1f95067efc15135b"</span> }</pre> </div></div><div data-title="prop.createlist" class="keyline-top section contain clearfix " data-reactid="105"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="106"><h3 id="propcreatelist">prop.createlist</h3> <p>VP批量制备指令： prop.createlist "cid|oid|gold,cid|oid|gold"</p> <p>prop.create 返回数据的数组形式</p> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="107"><h4 id="example-request-15">Example Request</h4> <h4 id="example-response-14">Example Response</h4> </div></div><div data-title="prop.send" class="keyline-top section contain clearfix " data-reactid="108"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="109"><h3 id="propsend">prop.send</h3> <p>VP转移指令： prop.send addr txid [index]</p> <p>通过 prop.create 发行的VP，必须通过 prop.send 发送到某个有效地址上，之后才能成为一个全流通道具，参与拍卖、熔铸等操作</p> <p>@note 输入转移的目标地址，道具所在交易的哈希、输出索引值（可选，默认0），即可将道具转移给目标地址转移没有额外的手续费输入参数中，标记为 hash 的，按照大端格式解释，标记为 rhash 或 txid 的，按照小端格式解释</p> <p>入口参数</p> <table> <thead> <tr> <th>Property</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>addr</td> <td>发送道具的目标地址</td> </tr> <tr> <td>txid</td> <td>道具所在的交易的哈希，小端格式</td> </tr> <tr> <td>index</td> <td>道具在交易输出中的索引值，默认0</td> </tr> </tbody> </table> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="110"><h4 id="example-request-16">Example Request</h4> <h4 id="example-response-15">Example Response</h4> </div></div><div data-title="prop.sendlist" class="keyline-top section contain clearfix " data-reactid="111"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="112"><h3 id="propsendlist">prop.sendlist</h3> <p>VP批量转移指令： prop.sendList "addr|txid|index,addr|txid|index"</p> <p>prop.send 数据的数组形式</p> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="113"><h4 id="example-request-17">Example Request</h4> <h4 id="example-response-16">Example Response</h4> </div></div><div data-title="prop.order" class="keyline-top section contain clearfix " data-reactid="114"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="115"><h3 id="proporder-1">prop.order</h3> <p>订购：制备道具并发放给指定地址，相当于同时执行了 prop.creae 和 prop.send</p> <p>入口参数</p> <table> <thead> <tr> <th>Property</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>cid</td> <td>生产者编码</td> </tr> <tr> <td>oid</td> <td>道具原始编码</td> </tr> <tr> <td>gold</td> <td>道具含金量单位：尘</td> </tr> <tr> <td>addr</td> <td>目标地址</td> </tr> </tbody> </table> </div></div><div data-title="prop.found" class="keyline-top section contain clearfix " data-reactid="116"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="117"><h3 id="propfound">prop.found</h3> <p>VP 熔铸指令： prop.found hash @note 指定将要熔铸的道具所在的交易的哈希，执行指令后将永久抹除所有的道具属性，重新变为一枚普通的硬币不需要指定地址，熔铸后形成的硬币自动回到当前钱包的可用地址上</p> <p>入口参数</p> <table> <thead> <tr> <th>Property</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>txid</td> <td>生产者编码</td> </tr> </tbody> </table> <table> <thead> <tr> <th>Property</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>txid</td> <td>交易哈希，小端</td> </tr> <tr> <td>index</td> <td>交易输出索引</td> </tr> <tr> <td>cid</td> <td>生产者编码</td> </tr> <tr> <td>pid</td> <td>道具编码</td> </tr> <tr> <td>oid</td> <td>道具原始编码</td> </tr> <tr> <td>gold</td> <td>道具含金量单位：尘</td> </tr> </tbody> </table> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="118"><h4 id="example-request-18">Example Request</h4> <h4 id="example-response-17">Example Response</h4> <pre class='hljs'>{ <span class="hljs-attr">"txid"</span>: <span class="hljs-string">"120fe53b49f6db9d8160588774b63974413b881f0a27f0c7dbb2dea490f4babd"</span>, <span class="hljs-attr">"index"</span>: <span class="hljs-number">0</span>, <span class="hljs-attr">"cid"</span>: <span class="hljs-string">"b77a9b90-bbc4-11e8-9203-1ff8357db148"</span>, <span class="hljs-attr">"pid"</span>: <span class="hljs-string">"9e236880-bbdc-11e8-8f5c-0bef66529c12"</span>, <span class="hljs-attr">"oid"</span>: <span class="hljs-string">"gamemonkey0003"</span>, <span class="hljs-attr">"gold"</span>: <span class="hljs-number">10000</span> }</pre> </div></div><div data-title="prop.sale" class="keyline-top section contain clearfix " data-reactid="119"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="120"><h3 id="propsale">prop.sale</h3> <p>VP 拍卖指令： prop.sale txid fixedPrice @note 指定将要拍卖的道具所在的交易的哈希，并给出拍卖一口价，将生成一个拍卖交易进入拍卖序列的道具，会从钱包道具列表中消失，不可用于转移、熔铸等业务操作中</p> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="121"><h4 id="example-request-19">Example Request</h4> <h4 id="example-response-18">Example Response</h4> </div></div><div data-title="prop.buy" class="keyline-top section contain clearfix " data-reactid="122"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="123"><h3 id="propbuy">prop.buy</h3> <p>VP 竞拍指令： prop.buy pid price @note 指定要参与竞拍的道具的 pid ，以及自己的出价，就可以参与竞拍如果出价高于该拍卖交易的初始价格（自身含金量）以及所有历史报价，那么将形成一个新的拍卖交易，替代之前的拍卖交易如果出价高于该拍卖交易的一口价，那么将形成一个新的、已锁定的拍卖交易，替代之前的拍卖交易拍卖交易的有效期截止，或者提前进入锁定状态，就会被打包到区块中，打包结束后道具发生了转移，并进入买家钱包的道具列表中，而卖家将得到一笔拍卖金如果流拍，交易取消，道具回到原主人手中</p> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="124"><h4 id="example-request-20">Example Request</h4> <h4 id="example-response-19">Example Response</h4> </div></div><div data-title="address.list" class="keyline-top section contain clearfix " data-reactid="125"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="126"><h3 id="addresslist">address.list</h3> <p>查询指定账户下的有效地址。一般用来查询特定openid的微信用户名下的有效地址</p> <p>[receive list, change list, nested list]</p> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="127"><h4 id="example-request-21">Example Request</h4> <h4 id="example-response-20">Example Response</h4> <pre class='hljs'>[ [ <span class="hljs-string">"tb1qpcu7kpx6an8nycc9qzews4fwt3xm89xm8nkmyh"</span>, <span class="hljs-string">"tb1qrx3g2p4fvtp6dgearxlaveecyreclf2yrwvet2"</span>, <span class="hljs-string">"tb1qywwa32jk65kar6nz9adkdzzs63vc89k26ngjtp"</span>, <span class="hljs-string">"tb1q9fryja72mcma9cxjmm0vq5mfrg5ugq3kk3vauc"</span>, <span class="hljs-string">"tb1q8zqszrane28827msa080al8jj0zq2r6376fg20"</span>, <span class="hljs-string">"tb1qfgjqx8dmlnnqj6kc3vselqgl9kkryegc2ym4gc"</span>, <span class="hljs-string">"tb1q2vdpp7g34hr93cjpy24fkrrdds2wk5a38m8aa7"</span>, <span class="hljs-string">"tb1qth346ed5g76xupars0t4m72cs2lfh60mkrjp9f"</span>, <span class="hljs-string">"tb1qsm9zlyqvv47tasl0mn9h0krhl5hcfv7uz5jal5"</span>, <span class="hljs-string">"tb1q5njps8h97s8d09ypcuwvs4m57jsenmsactugxm"</span>, ], [ <span class="hljs-string">"tb1qqsj8dru4r46u29nhgnrgc0wn64d7py9rg8fkc2"</span>, <span class="hljs-string">"tb1qr24jr3excssn7nydrghzeca0zluj703ca79akk"</span>, <span class="hljs-string">"tb1qvmadcnkutxwahq40m6uatxnqlgk482r0t7es9y"</span>, <span class="hljs-string">"tb1qdcgcuv82rsl4epy0szkwfwpkhms59ad84333t9"</span>, <span class="hljs-string">"tb1qw7wefk0ypfuu450qa80nxzumy48alltq426r0x"</span>, <span class="hljs-string">"tb1qs84umpmrrxezpkhpv9qw7kz4pqft8r654x6xt2"</span>, <span class="hljs-string">"tb1q3ed9wenehayl30rzyc60s7nszr9y24nrw62g89"</span>, <span class="hljs-string">"tb1qhdghp7w8zezhcvljsyyslrp5hgnue4w4kuffk3"</span>, <span class="hljs-string">"tb1qcvrnh6jcumzv8rrq86w6g4lfrhqpmsaafh3ly6"</span>, <span class="hljs-string">"tb1qeq4yysu6h8x0kgafn3lxc8tde57s0ry0yleaay"</span>, ], [ <span class="hljs-string">"2N3cshjtvJUbQwr6boyTTEEtWJwZM187QSR"</span>, <span class="hljs-string">"2N5twuF5CGhrnMaYB3FAM7p2Y7epmETeBTJ"</span>, <span class="hljs-string">"2N6KeGtPxpZFDTqZ7d4E5mHbgrsSEdBXfnG"</span>, <span class="hljs-string">"2N7eUi5kv2JKkF4uyg6avnUQEwBgCB2vsLo"</span>, <span class="hljs-string">"2N8SPL5pa2n6LD5VwNXm9b4RQ5dCncn7VGn"</span>, <span class="hljs-string">"2N8dTqZbwdkRVfNjVPF8qRJBPYHhyEayNux"</span>, <span class="hljs-string">"2N9AxCDcvMRckjHTxDUTSfajaQYZxP2m1dK"</span>, <span class="hljs-string">"2NAg85xswqn5vwgooitw4mAuLrUvKubrsM9"</span>, <span class="hljs-string">"2NCKSKpqSmkXD3LRrqJtxhKSBKN9digxBFE"</span>, <span class="hljs-string">"2NG8Fvtvu4g6z7mPwx1EpD2tF3pffX9MgtD"</span>, ] ]</pre> </div></div><div data-title="prop.list" class="keyline-top section contain clearfix " data-reactid="128"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="129"><h3 id="proplist">prop.list</h3> <p>查询当前拥有的道具列表 @note prop.list 侧重于查询不同微信用户的道具列表，不区分游戏，而 queryProps 则侧重于查询用户指定的游戏专用地址中的道具列表</p> <p>入口参数</p> <table> <thead> <tr> <th>Property</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>page</td> <td>页码，默认1</td> </tr> <tr> <td>acct</td> <td>指定的钱包账户，一般为指定用户的openid</td> </tr> </tbody> </table> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="130"><h4 id="example-request-22">Example Request</h4> </div></div><div data-title="prop.list.created" class="keyline-top section contain clearfix " data-reactid="131"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="132"><h3 id="proplistcreated">prop.list.created</h3> <p>列表自己创建的道具</p> <p>入口参数</p> <table> <thead> <tr> <th>Property</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>acct</td> <td>指定的钱包账户，一般为指定用户的openid</td> </tr> </tbody> </table> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="133"><h4 id="example-request-23">Example Request</h4> </div></div><div data-title="prop.list.auction" class="keyline-top section contain clearfix " data-reactid="134"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="135"><h3 id="proplistauction">prop.list.auction</h3> <p>列表自己正在拍卖的道具</p> <p>入口参数</p> <table> <thead> <tr> <th>Property</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>acct</td> <td>指定的钱包账户，一般为指定用户的openid</td> </tr> </tbody> </table> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="136"><h4 id="example-request-24">Example Request</h4> </div></div><div data-title="prop.list.bid" class="keyline-top section contain clearfix " data-reactid="137"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="138"><h3 id="proplistbid">prop.list.bid</h3> <p>列表自己参与拍卖的道具</p> <p>入口参数</p> <table> <thead> <tr> <th>Property</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td>acct</td> <td>指定的钱包账户，一般为指定用户的openid</td> </tr> </tbody> </table> </div><div class="space-bottom4 col6 pad2 prose clip fill-light space-top5" data-reactid="139"><h4 id="example-request-25">Example Request</h4> </div></div><div data-title="部署特约全节点" class="keyline-top section contain clearfix " data-reactid="140"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="141"><h2 id="部署特约全节点">部署特约全节点</h2> <p>1、建立运行环境在安装了 node 8.0 及以上版本的基础上，运行如下指令：</p> <p>2、开启一个控制台窗口A，通过下述指令启动全节点，等待其同步数据完成</p> <p>3、新开一个控制台窗口B，运行如下命令查询CP列表，记录自己名下CP（owned字段为true）的CPID字段：</p> <p>如果自己尚未拥有CP记录，可以运行如下命令进行注册：</p> <p>其中： name是CP名称，全局唯一，不可重复，名称只能含有汉字、数字、字母、下划线和点，不能以下划线和点开头和结尾，长度限制为4~40</p> <pre><code>url是CP的回调服务地址，用于对外公开相关服务接口 ip是备用IP地址，支持IPV4和IPV6两种格式，在url无效的情况下，可直接使用ip进行访问。 </code></pre> <p>注册成功后，再次运行 cp.list 指令进行确认</p> <p>4、在窗口A键入 Ctrl-C 关闭全节点</p> <p>5、配置 gamegold.conf 文件</p> <ul> <li>采用包含全部CPID的逗分字符串，配置 hmac-connection 字段</li> <li>配置 api-key 字段</li> </ul> <p>@note gamegold.conf 位于 .gamegold\$networktype\ 目录下，对测试网而言 $networktype = testnet ，对主网而言 $networktype = main</p> <p>6、在A窗口通过如下指令再次启动全节点</p> <p>7、在B窗口运行 token.auth [CPID逗分列表]，A窗口会屏显授权令牌，记录并离线分发给各CP</p> </div></div><div data-title="游戏和特约全节点的交互" class="keyline-top section contain clearfix " data-reactid="142"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="143"><h2 id="游戏和特约全节点的交互">游戏和特约全节点的交互</h2> <p>注：详情请参考 GIP0005 - 认证和授权，以及 GIP0006 - 支付协议</p> <p>1、CP通过远程连接器，和特约全节点开展RPC通讯。CP需要将获取的授权令牌配置于它的远程连接器中，以控制台连接器为例：</p> <p>@note 当前版本下，所有授权节点都将共享整个钱包系统。未来版本中，将为不同CP划分独立钱包，以实现安全隔离</p> <p>2、特约全节点在特定事件（如支付确认等）发生时，会通过CP注册信息中的URL地址，向CP提交事件通知, 如下所示：</p> </div></div><div data-title="RPC通讯指令列表" class="keyline-top section contain clearfix " data-reactid="144"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="145"><h2 id="rpc通讯指令列表">RPC通讯指令列表</h2> </div></div><div data-title="客户端认证登录流程" class="keyline-top section contain clearfix " data-reactid="146"><div class="space-bottom8 col6 pad2x prose clip" data-reactid="147"><h3 id="客户端认证登录流程">客户端认证登录流程</h3> <p>主要涉及指令： token.user g