【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...

  1. 用户创建

    1. 为每个用户创建不同的Kr并存储在数据库中
  2. 充值:

    1. 不断的调用GetBlocksInfo获取最新的区块信息
    2. 查找区块的Out中的PKr是否为自己创建,如果是,就调用Detail解出Out的明文信息以及对应的作废码Nil。
    3. 查找区块中的Nil是否在Detail的时候解出过,如果找到,说明对应的UTXO已经被用掉了。
  3. 提现

    1. 获取已经存在的UTXO作为In,并构造出Out,配平后调用GenTx签名生成Tx。
    2. 调用CommitTx提交该Tx。

开发者帮助文档:SERO remixIDE /SERO WiKi/SERO Github

http://remix.web.sero.cash/

https://wiki.sero.cash/zh/index.html?file=home-Home

https://github.com/sero-cash/

评论

暂无评论