# Legacy Amino JSON REST

irishub v1.0.0（依赖Cosmos-SDK v0.41）和更早版本提供了 REST 端点来查询状态和广播交易。 这些端点在 irishub v1.0 中仍然保留，但已标记为已弃用，并计划在几个版本后删除。因此，我们将这些端点称为 Legacy REST 端点。

Legacy REST 端点相关的重要信息：

• 这些端点中的大多数都是向后兼容的。下一部分将介绍所有的不兼容更新。
• 值得注意的是，这些端点仍会输出 Amino JSON。 Cosmos-SDK v0.41 引入了 Protobuf 作为整个代码库的默认编码库，但是传统的 REST 端点是少数几个使用 Amino 编码的部分之一。

# API 端口、激活方式和配置

所有路由都在 ~/.iris/config/app.toml 中的以下字段中配置：

• api.enable = true|false 字段定义是否启用 REST 服务，默认为 true。
• api.address = {string} 字段定义服务器应绑定到的地址（实际为端口，因为主机应保持在 0.0.0.0）。 默认为 tcp://0.0.0.0:1317。
• 在 ~/.iris/config/app.toml 中定义了一些其他 API 配置选项并附有注释，请直接参考该文件。

# Legacy REST API 路由

irishub v0.16 和更早版本中存在的 REST 路由通过 HTTP 弃用标头标记为已弃用，它们仍然被维护以保持向后兼容，但是将在几个版本后删除。

对于应用程序开发人员而言，传统的 REST API 路由需要连接到 REST 服务器，这是通过在 ModuleManager 上调用 RegisterRESTRoutes 方法来完成的。

# Legacy REST 端点

# Legacy REST 端点的中不兼容更新 （对比 Cosmos-SDK v0.39 及更早的版本）

¹： 不支持 Amino 序列化的交易是那些包含一个或多个未在 Amino 编解码器中注册的 Msg 的交易。 当前在 IRIShub 中，只有 IBC Msgs 属于这种情况。

# 迁移到新的 REST 端点 （从 Cosmos-SDK v0.39）

IRIShub API 端点

Tendermint API 端点

# 高优先级查询端点的不兼容更新

高优先级查询端点

• Staking
  • Validators
  • Delegators
• Bank
  • Balances
• Gov
• Auth
• Distributions

# Bank

端点名称： QueryBalance

• 端点路径： /bank/balances/{address}
• 更新内容：
  • 无更改
  • 有关如何为非原生的 IBC 资产创建 Token，请参见跨链资产源路径。 这将包括每种 Token 源路径的哈希值。核心决定了哈希值替换 Denom 还是在 Denom 之前

# Validators

端点名称： QueryValidators

• 端点路径： /staking/validators

• 更新内容：

  • unbonding_height 和 jailed 字段不再支持。
  • 如果字段为空则将被忽略，而不是返回一个职位空字符串的字段。如果验证人不配置该字段则不返回该字段。例如，在启动时验证人没有填写安全联系人，只有在他们配置之后该字段才会出现

• JSON 示例：

  {
      "commission": {
          "commission_rates": {
              "max_change_rate": "0.000000000000000000",
              "max_rate": "0.000000000000000000",
              "rate": "0.000000000000000000"
          },
          "update_time": "1970-01-01T00:00:00Z"
      },
      "consensus_pubkey": "cosmosvalconspub1zcjduepqwuxd2yevzmsrmrjx2su8kdlk44eqfdzeqx27zejuen6m0nkcpzps0qavpw",
      "delegator_shares": "0.000000000000000000",
      "description": {
          "details": "security",
          "identity": "identity",
          "moniker": "moniker",
          "security_contact": "details",
          "website": "website"
      },
      "min_self_delegation": "1",
      "operator_address": "cosmosvaloper1pcpl7xhxq0wm72e9ljls2sxr5h3vqwytnq44sr",
      "status": 1,
      "tokens": "0",
      "unbonding_time": "1970-01-01T00:00:00Z"
  }
  

# Delegators

端点名称： QueryDelegatorDelegations

• 端点路径： /staking/delegators/delegations

• 更新内容：

  • balance 不再是数字类型，它包含两个子字段：amount 和 Denom
  • delegator_address 不再是字符串类型。更改为 delegation 并包含以下三个子字段：delegator_address"、"shares"和"validator_address
  • 旧字段 validator_address 不再使用。在 redelegation 中使用 validator_dst_address and validator_src_address 这两个新字段代替

• JSON 示例：

  {
      "balance": {
          "amount": "5",
          "denom": "stake"
      },
      "delegation": {
          "delegator_address": "cosmos1n2k9ygw2ws9sg86mrx84pdcre5geqd5ugt44h0",
          "shares": "5.000000000000000000",
          "validator_address": "cosmosvaloper155998a4hv5kqvuxr9jryjxrtnlydvqu8c0cy03"
      }
  }
  

端点名称： QueryRedelegations

• 端点路径： /staking/redelegations

• 更新内容： 以下旧字段更改为新字段 redelegation_entry 的子字段：

  • completion_time
  • initial_balance
  • shares_dst

• creation_height 字段不再支持

• 以下为新字段：

  • redelegation 包含以下子字段
    • delegator_address （新增）
    • entries （新增）
    • valdiator_dst_address
    • validator_src_address

• JSON 示例：

  {
      "entries": [
          {
              "balance": "5",
              "redelegation_entry": {
                  "completion_time": "1969-12-31T16:00:00-08:00",
                  "initial_balance": "5",
                  "shares_dst": "5.000000000000000000"
              }
          },
          {
              "balance": "5",
              "redelegation_entry": {
                  "completion_time": "1969-12-31T16:00:00-08:00",
                  "initial_balance": "5",
                  "shares_dst": "5.000000000000000000"
              }
          }
      ],
      "redelegation": {
          "delegator_address": "cosmos104yggz5x4ype50c59vu84ze2w36pc3swm2u698",
          "entries": null,
          "validator_dst_address": "cosmosvaloper1td8yl7g5662m0mpptaxjmcn9jtzvl0wgulvv23",
          "validator_src_address": "cosmosvaloper1gqv70e79a8q0yz5s5qhsjhdl2c79496faer0vz"
      }
  }
  

端点名称： QueryUnbondingDelegation

• 端点路径： /staking/unbondingDelegation
• 更新内容：
  • 字段 creation_height 不再支持

# Distributions

端点名称： getQueriedValidatorOutstandingRewards

• 端点路径： /distribution/validators/{validatorAddr}/outstanding_rewards

• 更新内容：

  • 新字段 rewards 是输出中的根字段

• JSON 示例：

  {
      "rewards": [
          {
              "denom": "mytoken",
              "amount": "3.000000000000000000"
          },
          {
              "denom": "myothertoken",
              "amount": "0.000000300000000000"
          }
      ]
  }
  

端点名称： getQueriedValidatorCommission

• 端点路径： /distribution/validators/{validatorAddr}

• 更新内容：

  • 新字段 commission 是输出中的根字段

• JSON 示例：

  {
      "commission": [
          {
              "denom": "token1",
              "amount": "4.000000000000000000"
          },
          {
              "denom": "token2",
              "amount": "2.000000000000000000"
          }
      ]
  }
  

端点名称： getQueriedValidatorSlashes

• 端点路径： /distribution/validators/{validatorAddr}

• 更新内容： 无更改

• 端点名称： getQueriedDelegationRewards

• 端点路径： /distribution/delegators/{delegatorAddr}/rewards

• 更新内容： 无更改

# 构造和签名交易（完全向后兼容）

与 IRIShub 主网集成的代码相同，交易结构如下：

{
    "type": "cosmos-sdk/StdTx",
    "value": {
        "msg": [
            {
                "type": "cosmos-sdk/MsgSend",
                "value": {
                    "from_address": "iaa1rkgdpj6fyyyu7pnhmc3v7gw9uls4mnajvzdwkt",
                    "to_address": "iaa1q6t5439f0rkvkzl38m0f43e0kpv3mx7x2shlq8",
                    "amount": [
                        {
                            "denom": "uiris",
                            "amount": "1000000"
                        }
                    ]
                }
            }
        ],
        "fee": {
            "amount": [
                {
                    "denom": "uiris",
                    "amount": "30000"
                }
            ],
            "gas": "200000"
        },
        "signatures": null,
        "memo": "Sent via irishub client"
    }
}

IRIShub 地址前缀使用 iaa 代替，这会影响以下字段：

• value.msg.value.from_adress
• value.msg.value.to_address

Denom 替换为 uiris （1iris = 10⁶uiris），这会影响到以下字段：

• value.msg.value.amount.denom
• value.fee.amount.denom

# 广播交易（完全向后兼容）

与 IRIShub 主网集成的代码相同，调用POST /txs 发送交易，示例如下：

curl -X POST "http://localhost:1317/txs" -H "accept: application/json" -H "Content-Type: application/json" -d "{ \"tx\": {\"msg\":[{\"type\":\"cosmos-sdk/MsgSend\",\"value\":{\"from_address\":\"iaa1rkgdpj6fyyyu7pnhmc3v7gw9uls4mnajvzdwkt\",\"to_address\":\"iaa1q6t5439f0rkvkzl38m0f43e0kpv3mx7x2shlq8\",\"amount\":[{\"denom\":\"uiris\",\"amount\":\"1000000\"}]}}],\"fee\":{\"amount\":[{\"denom\":\"uiris\",\"amount\":\"30000\"}],\"gas\":\"200000\"},\"signatures\":[{\"pub_key\":{\"type\":\"tendermint/PubKeySecp256k1\",\"value\":\"AxGagdsRTKni/h1+vCFzTpNltwoiU7SwIR2dg6Jl5a//\"},\"signature\":\"Pu8yiRVO8oB2YDDHyB047dXNArbVImasmKBrm8Kr+6B08y8QQ7YG1eVgHi5OIYYclccCf3Ju/BQ78qsMWMniNQ==\"}],\"memo\":\"Sent via irishub client\"}, \"mode\": \"block\"}"

# 查询交易的不兼容更新

# Tx

• 端点名称： QueryTx

• 端点路径： GET /txs&&GET /txs/{hash}

• 更新内容：

  • tags 字段不再使用，使用 event 字段代替
  • result 字段不再使用，result 中原有字段移到第一级
  • coin_flow 字段不再使用

• JSON 示例：

  {
      "height": "5",
      "txhash": "E663768B616B1ACD2912E47C36FEBC7DB0E0974D6DB3823D4C656E0EAB8C679D",
      "data": "0A060A0473656E64",
      "raw_log": "[{\"events\":[{\"type\":\"message\",\"attributes\":[{\"key\":\"action\",\"value\":\"send\"},{\"key\":\"sender\",\"value\":\"iaa18awn3k70u05tlcul8w2qnl64g002uj4kjn93rn\"},{\"key\":\"module\",\"value\":\"bank\"}]},{\"type\":\"transfer\",\"attributes\":[{\"key\":\"recipient\",\"value\":\"iaa1w976a5jrhsj06dqmrh2x9qxzel74qtcmapklxc\"},{\"key\":\"sender\",\"value\":\"iaa18awn3k70u05tlcul8w2qnl64g002uj4kjn93rn\"},{\"key\":\"amount\",\"value\":\"1000000uiris\"}]}]}]",
      "logs": [
          {
              "events": [
                  {
                      "type": "message",
                      "attributes": [
                          {
                              "key": "action",
                              "value": "send"
                          },
                          {
                              "key": "sender",
                              "value": "iaa18awn3k70u05tlcul8w2qnl64g002uj4kjn93rn"
                          },
                          {
                              "key": "module",
                              "value": "bank"
                          }
                      ]
                  },
                  {
                      "type": "transfer",
                      "attributes": [
                          {
                              "key": "recipient",
                              "value": "iaa1w976a5jrhsj06dqmrh2x9qxzel74qtcmapklxc"
                          },
                          {
                              "key": "sender",
                              "value": "iaa18awn3k70u05tlcul8w2qnl64g002uj4kjn93rn"
                          },
                          {
                              "key": "amount",
                              "value": "1000000uiris"
                          }
                      ]
                  }
              ]
          }
      ],
      "gas_wanted": "200000",
      "gas_used": "69256",
      "tx": {
          "type": "cosmos-sdk/StdTx",
          "value": {
              "msg": [
                  {
                      "type": "cosmos-sdk/MsgSend",
                      "value": {
                          "from_address": "iaa18awn3k70u05tlcul8w2qnl64g002uj4kjn93rn",
                          "to_address": "iaa1w976a5jrhsj06dqmrh2x9qxzel74qtcmapklxc",
                          "amount": [
                              {
                                  "denom": "uiris",
                                  "amount": "1000000"
                              }
                          ]
                      }
                  }
              ],
              "fee": {
                  "amount": [
                      {
                          "denom": "uiris",
                          "amount": "30000"
                      }
                  ],
                  "gas": "200000"
              },
              "signatures": [],
              "memo": "",
              "timeout_height": "0"
          }
      },
      "timestamp": "2021-01-18T07:29:21Z"
  }