开发文档

novstream_check

此篇内容尚无原站英文对应版本;切换语言后可浏览英文资料库。
该novstream_check命令提供了一种快速检查帐户的DefaultStream字段以及其信任线的Novstream标志的状态,并与建议的设置进行比较。 请求格式的示例:
{
    "id": 0,
    "command": "novstream_check",
    "account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
    "role": "gateway",
    "ledger_index": "current",
    "limit": 2,
    "transactions": true
}
{
    "method": "novstream_check",
    "params": [
        {
            "account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
            "ledger_index": "current",
            "limit": 2,
            "role": "gateway",
            "transactions": true
        }
    ]
}
注意:此方法没有命令行语法。使用该json命令从命令行访问此命令。
该请求包含以下参数:
Field 类型 描述
account String 账户的唯一标识符,通常是账户的地址。
role String 地址是指a gateway还是user。建议取决于帐户的角色。发行人必须启用DefaultStream,并且必须在所有信任线上禁用NoStream。用户应该禁用DefaultStream,并且应该在所有信任线上启用Novstream。
transactions Boolean (可选)如果true将一组建议的事务包含为JSON对象,那么您可以签名并提交以解决问题。默认为false。
limit Unsigned Integer (可选)要包含在结果中的最大信任线问题数。默认为300。
ledger_hash String (可选)要使用的分类帐版本的20字节十六进制字符串。(请参阅指定分类帐)
ledger_index String or Unsigned Integer (可选)要使用的分类帐的序号或快捷字符串自动选择分类帐。(请参阅指定分类帐)
一个成功回应的例子:
{
  "id": 0,
  "result": {
    "ledger_current_index": 169518,
    "problems": ["You should immediately set your default vstream flag", "You should clear the no vstream flag on your CNY line to vJqt7ir44V6RyWwxxEgD87sEfStdwCahZz", "You should clear the no vstream flag on your BTC line to vJqt7ir44V6RyWwxxEgD87sEfStdwCahZz", "You should clear the no vstream flag on your BTC line to vp9Ykz8Af9bYV6zpjxRiza2oeim8xmiu7i"],
    "transactions": [{
      "Account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
      "Fee": 10,
      "Sequence": 335,
      "SetFlag": 8,
      "TransactionType": "AccountSet"
    }, {
      "Account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
      "Fee": 10,
      "Flags": 262144,
      "LimitAmount": {
        "currency": "BTC",
        "issuer": "vp9Ykz8Af9bYV6zpjxRiza2oeim8xmiu7i",
        "value": "1000000000000000e-4"
      },
      "Sequence": 338,
      "TransactionType": "TrustSet"
    }],
    "validated": false
  },
  "status": "success",
  "type": "response"
}
{
  "id": 0,
  "result": {
    "ledger_current_index": 169518,
    "problems": ["You should immediately set your default vstream flag", "You should clear the no vstream flag on your CNY line to vJqt7ir44V6RyWwxxEgD87sEfStdwCahZz", "You should clear the no vstream flag on your BTC line to vJqt7ir44V6RyWwxxEgD87sEfStdwCahZz", "You should clear the no vstream flag on your BTC line to vp9Ykz8Af9bYV6zpjxRiza2oeim8xmiu7i"],
    "transactions": [{
      "Account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
      "Fee": 10,
      "Sequence": 335,
      "SetFlag": 8,
      "TransactionType": "AccountSet"
    }, {
      "Account": "vDgSCaGS3iih9iKvfvRULrK7gurJjdDnUV",
      "Fee": 10,
      "Flags": 262144,
      "LimitAmount": {
        "currency": "BTC",
        "issuer": "vp9Ykz8Af9bYV6zpjxRiza2oeim8xmiu7i",
        "value": "1000000000000000e-4"
      },
      "Sequence": 338,
      "TransactionType": "TrustSet"
    }],
    "validated": false
  },
  "status": "success",
  "type": "response"
}
响应遵循标准格式,成功结果包含以下字段:
Field Type Description
ledger_current_index Number 用于计算这些结果的分类帐的序列号。
problems Array 具有人类可读性问题描述的字符串数组。如果帐户的DefaultStream设置不符合建议条件,则最多包含一个条目,并且最多包含一个条目,limit其信息行的NoStream设置不符合建议。
transactions Array (可以省略)如果请求指定transactions为true,则这是一个JSON对象数组,每个JSON对象都是JSON形式的事务,它应该修复所描述的问题之一。此数组的长度与数组相同problems,并且每个条目旨在解决在该数组的相同索引中描述的问题。
可能的错误:
  • 任何通用错误类型。
  • invalidParams - 一个或多个字段指定不正确,或缺少一个或多个必填字段。
  • actNotFound- 请求字段中指定的地址account不对应分类账中的账户。
  • lgrNotFound- 由ledger_hash或者ledger_index不存在的分类账,或者确实存在,但服务器没有。
THE NEXT CONNECTION

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

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

联系我们