开发文档

自动填充字段

此篇内容尚无原站英文对应版本;切换语言后可浏览英文资料库。
如果您忽略它们,服务器将自动尝试自动填写tx_json(交易对象)中的某些字段。服务器在签名之前提供以下字段,除非请求指定offline为true:
  • Sequence - 服务器自动使用发件人帐户信息中的下一个序列号。
  • 警告:在应用此事务之前,帐户的下一个序号不会递增。如果您在未提交并等待每个交易的响应的情况下签署多个交易,则必须在第一个交易之后手动为每笔交易提供正确的序列号。
  • Fee- 如果您省略Fee参数,则服务器会自动尝试填写适当的交易成本。在生产Stream分类帐中,rpcHIGH_FEE除非您提供适当的fee_mult_max值,否则将失败。
  • 根据应用于参考交易成本的负荷定标乘数,参数fee_mult_max和fee_div_max参数限制了自动提供的交易成本可以达到多高。如果自动提供的值使用大于10倍的乘数,则默认设置会返回错误。但是,生产Stream分类帐通常具有1000倍的负荷乘数。
  • 命令行语法不支持fee_mult_max和fee_div_max。对于生产Stream分类帐,您必须提供一个Fee值。
  • 注意:恶意服务器可以指定过高的交易成本,忽略了价值观fee_mult_max和fee_div_max。
  • Paths- 对于付款类型的交易(不包括STM到STM的转账),路径字段可以自动填充。只有build_path提供时才填写。
一个成功回应的例子:
{
  "id": 2,
  "result": {
    "tx_blob": "1200002280000000240000013961D4838D7EA4C6800000000000000000000000000055534400000000008B17262A312E4FF5BE1138A85301428C74628BB868400000000000000A73210338B02E376397CE1600D338500584CC79E54094C8544DE2400E01E7CE4447F2C67446304402200167648A76219C3E1C6BE70B932468156F20377FC5559E4295490DFEAC1F6A1B022023BB17B6A0F2198C074839204462FA97C8B93173F8780DF5229A351BDAACD2EA81148B17262A312E4FF5BE1138A85301428C74628BB883148B17262A312E4FF5BE1138A85301428C74628BB8",
    "tx_json": {
      "Account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
      "Amount": {
        "currency": "USD",
        "issuer": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
        "value": "1"
      },
      "Destination": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
      "Fee": "10",
      "Flags": 2147483648,
      "Sequence": 313,
      "SigningPubKey": "0338B02E376397CE1600D338500584CC79E54094C8544DE2400E01E7CE4447F2C6",
      "TransactionType": "Payment",
      "TxnSignature": "304402200167648A76219C3E1C6BE70B932468156F20377FC5559E4295490DFEAC1F6A1B022023BB17B6A0F2198C074839204462FA97C8B93173F8780DF5229A351BDAACD2EA",
      "hash": "BD8CD7F28FA90A1336CBB6AA364009096A5222EC639F7D912C04E32D8ED10DBD"
    }
  },
  "status": "success",
  "type": "response"
}
200 OK
{
  "result": {
    "tx_blob": "1200002280000000240000013961D4838D7EA4C6800000000000000000000000000055534400000000008B17262A312E4FF5BE1138A85301428C74628BB868400000000000000A73210338B02E376397CE1600D338500584CC79E54094C8544DE2400E01E7CE4447F2C67446304402200167648A76219C3E1C6BE70B932468156F20377FC5559E4295490DFEAC1F6A1B022023BB17B6A0F2198C074839204462FA97C8B93173F8780DF5229A351BDAACD2EA81148B17262A312E4FF5BE1138A85301428C74628BB883148B17262A312E4FF5BE1138A85301428C74628BB8",
    "tx_json": {
      "Account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
      "Amount": {
        "currency": "USD",
        "issuer": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
        "value": "1"
      },
      "Destination": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
      "Fee": "10",
      "Flags": 2147483648,
      "Sequence": 313,
      "SigningPubKey": "0338B02E376397CE1600D338500584CC79E54094C8544DE2400E01E7CE4447F2C6",
      "TransactionType": "Payment",
      "TxnSignature": "304402200167648A76219C3E1C6BE70B932468156F20377FC5559E4295490DFEAC1F6A1B022023BB17B6A0F2198C074839204462FA97C8B93173F8780DF5229A351BDAACD2EA",
      "hash": "BD8CD7F28FA90A1336CBB6AA364009096A5222EC639F7D912C04E32D8ED10DBD"
    }
  },
  "status": "success"
}
Loading: "/etc/rippled.cfg"
Connecting to 127.0.0.1:5005
{
  "result": {
    "tx_blob": "1200002280000000240000013961D4838D7EA4C6800000000000000000000000000055534400000000008B17262A312E4FF5BE1138A85301428C74628BB868400000000000000A73210338B02E376397CE1600D338500584CC79E54094C8544DE2400E01E7CE4447F2C67446304402200167648A76219C3E1C6BE70B932468156F20377FC5559E4295490DFEAC1F6A1B022023BB17B6A0F2198C074839204462FA97C8B93173F8780DF5229A351BDAACD2EA81148B17262A312E4FF5BE1138A85301428C74628BB883148B17262A312E4FF5BE1138A85301428C74628BB8",
    "tx_json": {
      "Account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
      "Amount": {
        "currency": "USD",
        "issuer": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
        "value": "1"
      },
      "Destination": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
      "Fee": "10",
      "Flags": 2147483648,
      "Sequence": 313,
      "SigningPubKey": "0338B02E376397CE1600D338500584CC79E54094C8544DE2400E01E7CE4447F2C6",
      "TransactionType": "Payment",
      "TxnSignature": "304402200167648A76219C3E1C6BE70B932468156F20377FC5559E4295490DFEAC1F6A1B022023BB17B6A0F2198C074839204462FA97C8B93173F8780DF5229A351BDAACD2EA",
      "hash": "BD8CD7F28FA90A1336CBB6AA364009096A5222EC639F7D912C04E32D8ED10DBD"
    }
  }
}
响应遵循标准格式,成功结果包含以下字段:
Field Type Description
tx_blob String 完全合格的签名交易的二进制表示,如十六进制
tx_json Object 完整交易的 JSON规范为已签名的,包括自动填入的所有字段
 
警告:如果此命令导致错误消息,则消息可以包含请求中的密钥。确保这些错误对其他人不可见。
  • 不要将此错误写入可供多人查看的日志文件。
  • 不要将此错误粘贴到公共场所进行调试。
  • 不要在网站上显示错误信息,即使意外。
可能的错误:
  • 任何通用错误类型。
  • invalidParams - 一个或多个字段指定不正确,或缺少一个或多个必填字段。
  • highFee - 当前基于负荷的交易成本乘数超过了自动提供交易成本的限制。要么fee_mult_max在请求中指定更高的值(至少1000),要么在该Fee字段中手动提供值tx_json。
  • tooBusy - 交易不包括路径,但服务器太忙而无法现在进行寻路。如果您作为管理员连接,则不会发生。
  • noPath - 交易不包括路径,并且服务器无法找到可以发生此付款的路径。
THE NEXT CONNECTION

下一次连接,从这里开始。

加入 Stream 社区,一起探索价值互联。

联系我们