【SERO TECH】 Service Interface (SSI) 接口说明
文章目录
Gero上开放了SSI服务,使得第三方可以通过rpc/web3连接gero,获得无状态的公链服务。
SSI的使用方式是不维护第三方创建的公私钥,因此,第三方需要自己创建存储公私钥,并在需要的时候提供给SSI。
[](https://wiki.sero.cash/zh/ind...
创建公私钥对
- Request
{"id":0,"jsonrpc":"2.0","method":"ssi_createKr","params":null}
- Successful Response
{
"SKr":"0x5bf7d....a0016", //私钥
"PKr":"0x904bb....09baa" //公钥
}
- szkCreateKr 生成SuperZK2.0协议账户
[](https://wiki.sero.cash/zh/ind...
用来主动同步区块数据
- Request
{
"id":0,
"jsonrpc":"2.0",
"method":"ssi_getBlocksInfo",
"params":[
"0x0", //起始块
"0x5" //最多获取多少个块
]
}
- Successful Response
[
{
"Num":"0x0", //块号
"Hash":"0x2472...2003" //Block Hash
"Outs":[
{
"Hash":"0x..." //Tx Hash
"Root":"0xfa2e8....5a717", //该Out的Merkle Root
"PKr": "0xaf630....7ca29" //该Out的暂存公钥
}
],
"Nils":["0x...",...] //作废码
},
...
]
[](https://wiki.sero.cash/zh/ind...
获取对应Out的明文信息
- Request
{
"id":1,
"jsonrpc":"2.0",
"method":"ssi_detail",
"params":[
["0x...","0x..."], //需要解出明文的out的root列表,需要有相同的PKr。
"0x..." //该Out的PKr对应的SKr
]
}
- Successful Response
{
"id":1,
"jsonrpc":"2.0",
"result":[
{
"Asset" :{ //Out的资产
"Tkn" :{ //Token资产
"Currency":"0x...", //Token的币名
"Value":10000000 //Token的金额(bigint)
},
Tkt:{ //Ticket资产
"Category":"0x...", //Ticket类型
"Value":"0x..." //Ticket的值
}
},
Memo:"...", //本Out的备注
Nil:"0x..." //本Out的作废码
},
...
]
}
[](https://wiki.sero.cash/zh/ind...
创建交易,需要发送方自己配平Out和In,注意In和Out的个数越多,交易生成的时间越长。
- Request
{
"id":1,
"jsonrpc":"2.0",
"method":"ssi_genTx",
"params":[{
Gas: 10000, //本次交易的GasLimit
GasPrice: 1000000000, //本次交易的GasPrice
From: { //代表发送者的Kr
SKr:"0x...",
PKr:"0x..."
},
Ins: [
{
SKr: "0x...", //输入的UTXO对应的SKr
Root: "0x..." //输入的UTXO对应的Root
},
...
],
Outs: [
{
PKr: "0x...", //输出的PKr
Asset: {...}, //输出的资产,参考Detail
Memo: "0x....." //本次输出的备注
},
...
]
}]
}
- Successful Response
{
"id":1,
"jsonrpc":"2.0",
"result":"0x..." //该交易的hash
}
注意
* gero会根据当前机器的性能决定并行计算的数量,交易生成时间与引用的UTXO的数量成正比。
* 一个解决方案是对充值的UTXO进行merge,另外一个是延长接口调用的超时时间。
* --rpcwritetimeout [SECOND] 启动gero的时候加上这个参数,可以设置gero回写的超时时间,单位是秒。
[](https://wiki.sero.cash/zh/ind...
提交已经创建的交易
- Request
{
"id":1,
"jsonrpc":"2.0",
"method":"ssi_commitTx",
"params":[
"0x..." //之前genTx创建的交易的hash
]
}
- Successful Response
{
"id":1,
"jsonrpc":"2.0",
"result":null
}
[](https://wiki.sero.cash/zh/ind...
-
用户创建
- 为每个用户创建不同的Kr并存储在数据库中
-
充值:
- 不断的调用GetBlocksInfo获取最新的区块信息
- 查找区块的Out中的PKr是否为自己创建,如果是,就调用Detail解出Out的明文信息以及对应的作废码Nil。
- 查找区块中的Nil是否在Detail的时候解出过,如果找到,说明对应的UTXO已经被用掉了。
-
提现
- 获取已经存在的UTXO作为In,并构造出Out,配平后调用GenTx签名生成Tx。
- 调用CommitTx提交该Tx。
开发者帮助文档:SERO remixIDE /SERO WiKi/SERO Github
评论
登录后参与技术讨论,分享你的经验与见解。
登录 / 注册暂无评论