SEER 交易所及第三方平台充提网关接入指南

2018-10-14 21:09:49 +08:00
 seerxiaozhushou

SEER 交易所及第三方平台充提网关接入指南

本指南主要目的是帮助交易所和其它第三方平台(包括但不限于非 SEER DAPPs 应用、中心化应用等)搭建充提网关接入 SEER 主网,上线 SEER 主资产及基于 SEER 区块链发行的 token,例如 PFC、OPC 等。

使用 SEER 主网进行充提等操作,手续费远远低于 SEER 的 ERC-20token 和 BTS 资产,且不受以太坊拥堵等事件的影响。

基本原理

大部分交易所及第三方平台使用的网关(充值提现)是一个中心化的应用服务。

以交易所充提为例,交易所为每位用户提供有一个平台 id,任何用户向交易所的 SEER 主网账户转账,并在 MEMO 中填写该 id,当交易所的 SEER 主网账户收到一笔转账时,可以根据 MEMO 中填写的信息确定是来自哪位用户的充值,从而在交易所平台内为用户上账。

举例:

1、小明从自己的 SEER 主网账户xiaoming充值1000SEER到交易所账户seerdex,MEMO 中填写10010,交易所检测到主网账户seerdex收到一笔1000SEER的转账,MEMO 为10010,则在小明的交易所账户10010中上账1000SEER

2、小明请朋友小花帮自己充值,小花从自己的 SEER 主网账户xiaohua充值1000SEER到交易所账户seerdex,MEMO 中填写10010,交易所检测到主网账户seerdex收到一笔1000SEER的转账,MEMO 为10010,则在小明的交易所账户10010中上账1000SEER

3、小明将自己玩大富翁游戏中赢得的 SEER 充值交易所,小明在大富翁游戏的提现页面中填写提现1000SEER到交易所账户seerdex,并填写 MEMO10010,大富翁游戏在平台内扣除小明账户余额1000SEER,同时通过大富翁的 SEER 主网账户dafuweng向交易所账户seerdex转账1000SEER,MEMO 为10010,交易所检测到主网账户seerdex收到一笔1000SEER的转账,MEMO 为10010,则在小明的交易所账户10010中上账1000SEER

例子 3中,我们举例了用户从第三方平台提现到交易所的流程,从交易所提现到另一家交易所也是如此,这就需要交易所及第三方平台在设计提现功能时提供MEMO 功能。为了资金安全,您可以部署两个或多个账号,其中一个账号负责用户充值,其它账号负责提现。

准备工作

运行环境

推荐服务器配置为:2vCPUs 4G 内存 20G 以上硬盘,Ubuntu 16.04.4 x64 系统。

获得账号及私钥

注册账号

您可以通过 SEER 网页钱包 https://wallet.seer.best 注册账号,其中账号中带有横杠或数字的账号为普通账号名,可以直接免费注册(点击了解方法) ,例如seer-exchangeseerdex01 ,而由纯英文字母构成的账号名为高级用户名,例如seerdex,则需通过一个终身会员账户缴纳注册手续费来注册。

获得私钥

在充提网关等功能中,我们需要账户的至少两对密钥,即当前资金密钥( Active key )和当前备注密钥( memo key ),资金密钥让您拥有资金的转账及其他链上操作权限,备注密钥让您能生成和读取和该账号相关的 MEMO 信息。点击这里了解获取私钥的方法

配置一个 SEER 全节点

1、在服务器新建一个名叫 seer 的窗口;

screen -S seer

2、在 root 目录下新建一个名叫 seer 的目录,下载v0.0.5 版本的程序包到此目录,并更名为seer.tar.gz。(请到 SEER 软件发布页 https://github.com/seer-project/seer-core-package/releases 复制最新的 ubuntu 版本程序包链接替换掉此下载链接。)

mkdir seer
curl -Lo seer/seer.tar.gz https://github.com/seer-project/seer-core-package/releases/download/v0.05/seer-ubuntu-0.0.5.tar.gz 

3、进入 seer 目录,解压此软件包。

cd seer
tar xzvf seer.tar.gz

4、带 websocket 参数启动 witness_node:

witness_node --rpc-endpoint=127.0.0.1:9090 partial-operations=true --track-account="\"seerdex-withdraw\"" --track-account="\"seerdex-deposit\"" max-ops-per-account=1000 

其中的--rpc-endpoint参数为节点监听的 websocket RPC IP 地址和端口号,需要您替换,此处127.0.0.1为本机,9090是为节点指定的 WS 端口。

对于处理充提业务的节点,我们并不需要保存全部数据,仅需要保存和交易所账户相关的账户数据以节省内存开支,因此我们需要设置partial-operations参数和--track-account参数,此处partial-operations=true表示只需要部分的数据,"\"seerdex-withdraw\"""\"seerdex-deposit\""表示要追踪的一个或多个账户 id,需要您替换。

--max-ops-per-account参数设定内存中保留账户的多少条操作记录,此处1000表示保留追踪账户的1000条操作记录,需要您按需求填写。

5、观察节点运行正常后,ctrl+A d 隐藏 screen,断开服务器。之后要再打开运行有节点的 Sreeen,则使用 screen -R ,或 screen -r seer

节点正常启动后,会显示像下面一样的 3 秒一个的出块信息。

如果要关闭节点,则使用control + C

配置一个 SEER 命令行钱包

1、在服务器新建一个名叫 cli 的窗口,运行 seer 目录中的命令行钱包程序;

screen -S cli
cd~
seer/cli_wallet -s ws://127.0.0.1:9090 -r 127.0.0.1:9191 -H 127.0.0.1:9192

-s参数可以设置要连接的节点 api 地址及端口,此处ws://127.0.0.1:9090为上一步中运行的本地节点的 websocket RPC 地址和端口,您也可以在此处使用局域网或公网中的其他公共 api 地址,不过有因外部 api 无法提供服务而导致命令行钱包异常退出的风险;

-r参数可以设置命令行钱包要监听的 websocket RPC 地址和端口,此处设为127.0.0.1:9191,负责充提业务的程序可以使用此端口调用命令行钱包进行操作;

-H参数可以设置命令行钱包要监听的 Http-RPC 地址和端口,此处设为127.0.0.1:9192,负责充提业务的程序也可以使用此端口调用命令行钱包进行操作。

2、钱包启动成功后,会显示:

Please use the set_password method to initialize a new wallet before continuing
3564395ms th_a       main.cpp:227                  main                 ] Listening for incoming RPC requests on 127.0.0.1:9191
3564396ms th_a       main.cpp:252                  main                 ] Listening for incoming HTTP RPC requests on 127.0.0.1:9192
new >>> 

先设置钱包解锁密码,123 替换为你想设置的密码

set_password 123

解锁钱包

unlock 123

导入账号资金私钥和备注私钥

import_key seerdex-withdraw 5JkbV8aTaYRVaarTUJQ9Y56cr4QajxNFfCoQj6Q9JFL8XvUZ5CQ
import_key seerdex-withdraw 5KiSC6rRAEkTj72fg3G3zF8RHmCEgZw7aSXBjKqDfvY2XN1qvyd

显示如下:

new >>> set_password 123
set_password 123
null
locked >>> unlock 123
unlock 123
null
unlocked >>> import_key seerdex-withdraw  5JkbV8aTaYRVaarTUJQ9Y56cr4QajxNFfCoQj6Q9JFL8XvUZ5CQ
import_key okok 5JkbV8aTaYRVaarTUJQ9Y56cr4QajxNFfCoQj6Q9JFL8XvUZ5CQ
3572083ms th_a       wallet.cpp:793                save_wallet_file     ] saving wallet to file wallet.json
3572084ms th_a       wallet.cpp:467                copy_wallet_file     ] backing up wallet wallet.json to after-import-key-1cd0784e.wallet
true
unlocked >>> import_key seerdex-withdraw  5KiSC6rRAEkTj72fg3G3zF8RHmCEgZw7aSXBjKqDfvY2XN1qvyd
import_key else 5KiSC6rRAEkTj72fg3G3zF8RHmCEgZw7aSXBjKqDfvY2XN1qvyd
3572941ms th_a       wallet.cpp:467                copy_wallet_file     ] backing up wallet wallet.json to before-import-key-1bece5d8.wallet
3573189ms th_a       wallet.cpp:793                save_wallet_file     ] saving wallet to file wallet.json
3573191ms th_a       wallet.cpp:467                copy_wallet_file     ] backing up wallet wallet.json to after-import-key-1bece5d8.wallet
true
unlocked >>> 

接入命令行钱包

可以使用 Http-RPC 或 websocket RPC 方式接入命令行钱包。使用 JSON-RPC 远程调用协议传入相应的指令,即可让命令行钱包进行相关操作或返回需要的信息。

格式如下(实际使用时不换行无注释):

{ 
    "jsonrpc" : 2.0,//定义 JSON-RPC 版本
    "method" : "get_block",//调用的方法名,例如转账 transfer,列出账户余额 list_account_balances 等,此处 get_block 为返回指令块号的区块信息
    "params" : [1], //方法传入的参数,若无参数则为 null,此处 1 表示块号
    "id" : 1//调用标识符
} 

Http-RPC 接入示例

可以使用 curl 命令来测试 Http-RPC 连接命令行钱包实现获取指定账户的各资产余额:

 curl http://127.0.0.1:9192 -d '{"jsonrpc": "2.0", "method": "list_account_balances", "params": ["seerdex-withdraw"], "id": 1}'

 {"id":1,"result":[{"amount":"7861151753754","asset_id":"1.3.0"},{"amount":97099800,"asset_id":"1.3.8"}]}

websocket RPC 接入示例

首先在服务器上安装使用 wscat 测试 ws:

 apt install node-ws

测试通过 websocket RPC 连接命令行钱包实现一笔转账:

wscat -c ws://127.0.0.1:9191
> {"jsonrpc": "2.0", "method": "transfer", "params": ["seerdex-withdraw","ffffff","500000","SEER","Welcome to SEERTALK. https://forum.seerchain.org",true], "id": 1}
< {"id":1,"jsonrpc":"2.0","result":{"ref_block_num":64292,"ref_block_prefix":1517346144,"expiration":"2018-10-12T07:33:12","operations":[[0,{"fee":{"amount":2136718,"asset_id":"1.3.0"},"from":"1.2.105","to":"1.2.138","amount":{"amount":"50000000000","asset_id":"1.3.0"},"memo":{"from":"SEER8UAbnsAnXY1qr3CD6uzKaRuewsyPF9ynYJJGrdvSfDANxsGNxH","to":"SEER6QbqUZF6xzjdceVoLHS7K1KwvLyszVTZS8bbsQQQXcAm8L3aZp","nonce":"4469110159915322318","message":"482a7d070d298fe2a79d5f528f55778c62584d242274a7d697dae1ec63d7038b5a0b80dc9ba524e3f5f528bc717c60a635f89ff8af1cccbd1b4189f8ddc92e39"},"extensions":[]}]],"extensions":[],"signatures":["204e8746aac14a05fb3c66ac653429dead34bddac58911c53346feb365f0c7b5767ea870c1e5da6a104d8364e42f504fc1bdcfc442652f5c2e9bb9b26a858b0ccd"]}}                                           

切换回命令行钱包所在窗口,可以看到钱包内有如下信息:

2230368ms th_a       websocket_api.cpp:109         on_message           ] API call execution time limit exceeded. method: transfer params: ["seerdex-withdraw","ffffff","500000","SEER","Welcome to SEERTALK. https://forum.seerchain.org",true] time: 2310335

实现了让钱包进行了一次转账操作。

常用指令

get_dynamic_global_properties

作用:列出链的当前全局动态参数

示例:{"jsonrpc": "2.0", "method": "get_dynamic_global_properties", "params": [], "id": 1}

返回信息示例:

{
		"id": 1,
		"result": {
			"id": "2.1.0",
			"head_block_number": 3678309,//当前区块高度
			"head_block_id": "00382065d1057b13415518f913ce26e46fe45cac",//当前块号
			"time": "2018-10-12T16:37:30",//链上时间(格林尼治时间)
			"current_witness": "1.5.4",//当前出块的见证人
			"next_maintenance_time": "2018-10-13T00:00:00",//下次维护更新时间
			"last_budget_time": "2018-10-12T00:00:00",//上次维护时间
			"witness_budget": 3398400000,//本期见证人预算总额
			"accounts_registered_this_interval": 1,//账户注册间隔
			"recently_missed_count": 0,//最近缺失区块数
			"current_aslot": 4762199,//当前总块(丢掉的块加实际块高)
			"recent_slots_filled": "340240787892099949526793007880921399231",//用于计算见证人参与度的参数
			"dynamic_flags": 0,
			"last_irreversible_block_num": 3678305//最近一个不可逆块块号
		}
}

充提业务需关注 head_block_number 当前区块高度, last_irreversible_block_num 最近一个不可逆块块号。用于判断是否是可信充值操作以及提现是否已处理。

info

作用:显示当前 Seer 区块链的状态

示例:{"jsonrpc": "2.0", "method": "info", "params": [], "id": 1}

返回信息示例:

 {"id":1,
 	"result":
 	{
 		"head_block_num":3678258,//当前块高
 		"head_block_id":"00382032d0bfee243b0c5f6b37e3fd6f29682e6e",//当前块号
 		"head_block_age":"0 second old",//上一个区块生成时间
 		"next_maintenance_time":"7 hours in the future",//维护更新时间
 		"chain_id":"da68a9c5f2fd9ed48e626ea301db1c77505523884ba0dd409e779246c6ea26cf",//链号
 		"participation":"88.28125000000000000",//区块生产参与率
 		"active_witnesses"://活跃见证人 ID
 		["1.5.1","1.5.2","1.5.3","1.5.4","1.5.5","1.5.6","1.5.7","1.5.8"],
 		"active_committee_members"://活跃理事会成员 ID
 		["1.4.0","1.4.1","1.4.2","1.4.3","1.4.4","1.4.5","1.4.6","1.4.7"]
 	}
 }

充提业务需关注 head_block_age 上一个区块生成时间,participation 区块生产参与率。 提现操作前判断区块链是否正常运行。

list_account_balances

格式:list_account_balances name

参数:name 可以是账户名,也可以是账户的 id

作用:列出账号为 id 的账户的各资产余额

示例:{"jsonrpc": "2.0", "method": "list_account_balances", "params": ["abc"], "id": 1}

返回信息示例:

{
		"id": 1,
		"result": [{
			"amount": "7861177753754",//余额,精度 5,amount 没有小数点,其数值被乘以了 10000 此处即 78611777.53754
			"asset_id": "1.3.0"//资产类型 此处为 SEER
		}, {
			"amount": 97099800,//余额,精度 5,amount 没有小数点,其数值被乘以了 10000 
			"asset_id": "1.3.8"//资产类型 此处为测试链上的 ABC 资产
		}]
}

充提业务需关注asset_id为 1.3.0(即 SEER)的amount (余额)是否足够并支付网络手续费,若涉及 SEER 链上其他资产的充提业务,则还需要关注相应资产的余额是否足够。

transfer2

格式:transfer2 from to amount asset_symbol memo broadcast(true/false)

参数:from 为转出账户,to 为接收账户,amount 为转账数量, asset_symbol 为资产名,memo 为备注。from/to 可以是用户名或者 id,broadcast 设置是否广播。

作用:转账

示例:{"jsonrpc": "2.0", "method": "transfer2", "params": ["seerdex-withdraw","ffffff","500000","SEER","Welcome to SEERTALK. https://forum.seerchain.org",true], "id": 1}

返回信息示例:

{
	"id": 1,
	"jsonrpc": "2.0",
	"result":[
		"7ab0e58b6391a770cb62f432e0f2aef93de4d18e",//交易 id
		{
		"ref_block_num": 64292,//引用的区块号
		"ref_block_prefix": 1517346144,//引用的区块头
		"expiration": "2018-10-12T07:33:12",//交易过期时间
		"operations": [
			[0, {//0 表示转账
				"fee": {//手续费
					"amount": 2136718,//金额 ,amount 没有小数点,其数值被乘以了 10000 
					"asset_id": "1.3.0"//资产 此处表示 SEER
				},
				"from": "1.2.105",//转出账户 id
				"to": "1.2.138",//转入账户 id
				"amount": {
					"amount": "50000000000",//金额 amount 没有小数点,其数值被乘以了 10000 
					"asset_id": "1.3.0"//资产 此处表示 SEER
				},
				"memo": {//memo 权限相关
					"from": "SEER8UAbnsAnXY1qr3CD6uzKaRuewsyPF9ynYJJGrdvSfDANxsGNxH",
					"to": "SEER6QbqUZF6xzjdceVoLHS7K1KwvLyszVTZS8bbsQQQXcAm8L3aZp",
					"nonce": "4469110159915322318",
					"message": "482a7d070d298fe2a79d5f528f55778c62584d242274a7d697dae1ec63d7038b5a0b80dc9ba524e3f5f528bc717c60a635f89ff8af1cccbd1b4189f8ddc92e39"
				},
				"extensions": []
			}]
		],
		"extensions": [],
		"signatures": ["204e8746aac14a05fb3c66ac653429dead34bddac58911c53346feb365f0c7b5767ea870c1e5da6a104d8364e42f504fc1bdcfc442652f5c2e9bb9b26a858b0ccd"]
		}
	]
}

充提业务需关注返回信息的第一个字符串,即交易 id,另expiration 交易过期时间。

get_account_id

格式:get_account_id name

参数:name 是账户名

作用:列出账户 name 的账户 id

示例:{"jsonrpc": "2.0", "method": "get_account_id", "params": ["seerdex-withdraw"], "id": 1}

返回信息示例:

{"id":1,"result":"1.2.105"}

get_relative_account_history

格式:get_relative_account_history name start limit end

参数:name 可以是账户名或 id,start 为返回结果的最小编号,limit 为返回结果的数量上限,end 为返回结果的最大编号;

返回数据排序方式为按时间顺序,越新的越靠前;

编号从 1 开始,若 end = 0,则返回最新的 limit 条操作信息;

若 end - start > limit,则返回满足条件的最新的 limit 条操作信息。

作用:列出账户 name 的操作历史记录

请避免一次性返回超过 100 条数据,以免节点或钱包报错。同时,在命令行钱包中使用此命令时只会返回 "description"中的数据,用 RPC 调用方能返回完整数据。

示例:{"jsonrpc": "2.0", "method": "get_relative_account_history", "params": ["seerdex-withdraw",15,1,30], "id": 1}

返回信息示例:

{
		"id": 1,
		"result": [
			{
			"memo": "give you 980 SEER",//解锁并有相应私钥的钱包方能显示 MEMO
			"description": "Transfer 980 SEER from alice to okok -- Memo: give you 980 SEER   (Fee: 21.05468 SEER)",//钱包一般只显示此内容
			"op": {
				"id": "1.9.703568",//该操作的对象 id,可通过 get_object 1.9.703568 查看此操作
				"op": [
					0, //操作类型,0 表示转账
					{
					"fee": {//手续费
						"amount": 2105468,//数额
						"asset_id": "1.3.0"//资产类型
					},
					"from": "1.2.109",//转出 id
					"to": "1.2.105",//接收 id
					"amount": {
						"amount": 98000000,//转账数额
						"asset_id": "1.3.0"//资产类型
					},
					"memo": {//MEMO 权限相关
						"from": "SEER6sJwPuSSayEzHXLbVgw9HJsDnGBk5Dup5bq3ns1YziZEDMKMgU",
						"to": "SEER8UAbnsAnXY1qr3CD6uzKaRuewsyPF9ynYJJGrdvSfDANxsGNxH",
						"nonce": "394073041834538",
						"message": "485e630438b9a38c94c12afd9b15007845484d7f0c8c2c29c135f4f9a155a1ee"
					},
					"extensions": []
				}],
				"result": [//操作返回结果
					0, 
					{

					}
				],
				"block_num": 3674099,//入块高度
				"trx_in_block": 0,//操作所属交易在区块内的位置
				"op_in_trx": 0,//操作在交易内的位置
				"virtual_op": 52924//虚拟操作编号
			}
		}]
}

get_relative_account_history会列出和此账户有关的所有操作,例如自己转账给别人(包括提现)、别人转账给自己(包括充值)、账号注册、参与预测等;

充提业务只需关注op.op.N(操作类型)为0,即转账的操作;

当然最重要的是memo(转账 MEMO )和op.op.amount.amount(转账数额)以及op.op.amount.asset_id(资产类型);

以及op.op.from(转出 id ),若同一个账号即负责充值又负责提现,则判断op.op.from是否和get_account_id获得的当前账户一样来区分该笔操作是否是本帐户发起的提现操作;

op.id为该操作的对象 id,也是该转账操作的唯一 id ;

另外,还需要关注op.block_num,即该操作的入块高度, op.trx_in_block 该操作所属交易在该区块内的位置, op.op_in_trx 该操作在该交易内的位置, 以及op.virtual_op 该操作的虚拟操作编号。

以上四个数据可以和其他指令配合获得该操作所属的 txid 及判断该操作的唯一性。

get_block

格式:get_block num

参数:块号

作用:显示第 num 个块的概况

示例:get_block 2090482

返回信息示例:

get_block 2090482
{
  "previous": "001fe5f1e1dd8d195af805484ee8038a09866b76",//上一个块的块号
  "timestamp": "2018-07-30T07:31:54",//时间戳
  "witness": "1.5.22",//见证人
  "transaction_merkle_root": "72756b0f1f1711622c8030eae65e6db055200320",
  "extensions": [],
  "witness_signature": "200d202d735de10f4f8213d71a8f946a2cc49bc02e930f682bea74321819b4bc7c4d436e366f1cad962f214eeaa42b5030fd716f692077f135b3cf33c688f68f1f",//见证人签名
  "transactions": [{
      "ref_block_num": 58864,//引用的区块号
      "ref_block_prefix": 2207768636,//引用的区块头
      "expiration": "2018-07-30T07:33:51",//交易过期时间
      "operations": [[
          0,{
            "fee": {
              "amount": 200000,//手续费 
              "asset_id": "1.3.0"//资产类型 1.3.0 指 SEER
            },
            "from": "1.2.1250",//发起用户 ID
            "to": "1.2.1292",//接收用户 ID
            "amount": {
              "amount": 2000000000,//金额 20000
              "asset_id": "1.3.0"//资产类型 1.3.0 指 SEER
            },
            "extensions": []
          }
        ]
      ],
      "extensions": [],
      "signatures": [
        "205c1f92cd9eebba507094c0fe4a05be47d301b6b2e989f4f0fdcfc8acef69ceec5356faf1667b5576629bfbc29ee5a257dbfac935c5a8fef588e32d7a7902c2b3"//交易签名集合
      ],
      "operation_results": [[
          0,{}
        ]
      ]
    }
  ],
  "block_id": "001fe5f26d0f3ee5b1569a1618fe903e4dc5aef0",//块号
  "signing_key": "SEER5oyAoCzw5GRD9unKK6vsLXkPVx1aKU7i3hX19E8BRU5u3FoAoA",//见证人签名公钥
  "transaction_ids": [
    "30e73f68d163398005557a21c58bd751db22eb53"//交易 id 集
  ]
}

充提业务需需配合get_relative_account_history中获取的op.block_num来关注get_block获取的transaction_ids数据,若同一个块里有多笔交易,则会有多个transaction_id,需配合get_relative_account_history中获取到的op.trx_in_block来得到该操作所对应的 txid。

处理充值业务

1、通过get_relative_account_history查询账户相关历史。

返回结果中并没有直接显示每条记录的序号,需要自行获取和记录。

建议:从 start = 1,limit = 1,end = 2 开始以一定时间间隔发送请求,每次 start 和 end 各自 +1,limit 恒等于 1,若返回信息不为空,则将该条信息编号并存储。若返回信息为空:{"id":1,"jsonrpc":"2.0","result":[]},则表示没有新的操作,等待有新的操作信息时继续记录存储。

2、判断是否为充值业务。

get_relative_account_history会列出和此账户有关的所有操作,例如自己转账给别人(包括提现)、别人转账给自己(包括充值)、账号注册、参与预测等,充提业务只需要op.op.N(操作类型)为0(转账)的操作数据;

若同一个账号即负责充值又负责提现,则需要区分op.op.from是否和当前账户 id 一样,,若一样,则是本帐户发起的提现操作,需要排除掉;

剩下的便是待处理的充值操作。

3、获得相关充值数据。

通过 Http-RPC 或 websocket-RPC 连接的命令行钱包在 unlocked 状态时,在get_relative_account_history返回的信息中可以查看memo内容,用户填写的交易所 ID 等入账信息便从此处获取;

通过op.op.amount.amount(转账数额)加上小数点,便是充值数额;

通过op.op.amount.asset_id(资产类型)来判断是否是平台支持的正确资产类型。

4、判断是否为可信操作。

不同于比特币和以太坊采用确认数来从概率上降低交易被退回的可能性,像 SEER 这样的石墨烯项目中有不可逆块的概念,不可逆块及更早区块中的交易,可以保证不会发生回退。

get_relative_account_history会返回该笔操作所属的op.block_num(入块高度),但即使交易未入块,仍然可能出现在账户历史中,因此需要和通过get_dynamic_global_properties获取到的last_irreversible_block_num(最近一个不可逆块块号)比较,op.block_num必须小于或等于last_irreversible_block_num,才能被视为可信操作。

5、记录下该操作的相关信息。

get_relative_account_history中获取到的op.block_num+op.trx_in_block + op.op_in_trx + op.virtual_op 组合到一起,标识该操作的唯一性,可识别避免重复操作;

get_relative_account_history中获取到的op.id也是该转账操作的唯一 id ;

可以通过get_object op.block_num 获取该转账操作所在块的信息,再通过op.trx_in_block的数值来获取到块信息中transaction_ids数组里该转账操作对应的 txid,同一个 txid 可能对应多个操作。

6、如果有充值的 MEMO 或资产类型不正确,建议不要直接退回,而是等待用户主动联系确认退回路径,因为用户可能是通过交易所或第三方平台提现过来充值的,直接退回但没有对方 MEMO 可能会造成处理困难甚至资产损失。

处理提现业务

1、提现操作前检查区块链网络是否正常运行

提现业务需关注区块链网络是否正常运行状态,只在网络正常时处理提现。

通过info指令获取到head_block_age(上一个区块生成时间),须在 1 分钟以内,participation(区块生产参与率)须在 80 以上,表示 80%的区块生产者在正常工作。

同时get_dynamic_global_properties指令获取到的 head_block_number(当前区块高度)和 last_irreversible_block_num(最近一个不可逆块)相差不会太大,一般在 30 以内。

2、检查提现账户余额

通过list_account_balances列出账户各资产余额,检查asset_id为 1.3.0(即 SEER)的amount (余额)是否足够并支付网络手续费,若涉及 SEER 链上其他资产的充提业务,则还需要关注相应资产的余额是否足够。

3、转账并跟踪操作是否成功

通过transfer2向用户转账相应数额的指定资产。

需关注返回信息中的交易 id,向用户提供此信息可以让用户在区块浏览器查询自己的提现操作在区块链上的状态和信息,在转出目标未到账的情况下确定该笔操作是否已出账;

关注transfer2返回信息中的expiration(交易过期时间),转账操作发出后,一般很快可以从get_relative_account_history中获取到该笔转账操作的信息,并通过op.block_numlast_irreversible_block_num比较来确认入块;

( 1 )若确认入块,则返回信息中的交易 id应该已经存在于get_object op.block_num 获取该转账操作所在块信息的transaction_ids数组中。

( 2 )若发出的转账操作超过了expiration还未确认入块,则这笔交易可能由于您同时广播的操作太多等各种原因未被区块链打包并已经被丢弃,此时重新发起转账是安全的。

本文由 seer 爱好者提供,可能理解有误,欢迎到 github 指出: https://github.com/akirasen/seerdocs/tree/master/zh-Hans

1310 次点击
所在节点    区块链
0 条回复

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/497575

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX