Hedera应用及智能合约如何获取USD/HBAR汇率并使用0.0.112文件数据

基础属性 #

你查询的0.0.112是Hedera网络官方维护的系统文件，存储的是网络共识确认的USD/HBAR汇率，核心用途是计算链上交易手续费，所有节点都会同步该文件的内容。

数据实时性说明 #

• 该文件固定每15分钟更新一次，更新操作由共识节点集体执行，不存在单点篡改可能，更新后的汇率和当时的市场中间价偏差不超过±0.75%。
• 文件内容里自带当前汇率的生效时间戳、下一次更新的时间戳，解析后可以直接判断数据是否在有效期内，普通DApp的价格展示、资产估值、手续费估算场景完全够用。
• 注意这个汇率是网络结算用的中间价，和二级市场实时成交价有小幅偏差，不适合高频交易、高精度清算类场景。

智能合约内的调用方法 #

你现在用SDK在链下查询的方式没法直接给合约喂数，合约里拿这个汇率有两种成熟方案：

• 调用系统预编译合约
  Hedera预留了地址为0x169的汇率预编译合约，不需要你自己上传或同步数据，在合约内直接调用对应方法就能拿到当前生效的汇率，还支持直接做HBAR和USD的单位换算，示例代码如下：

  interface IExchangeRatePrecompile {
      function tinybarsToTinycents(uint256 tinybarsAmount) external returns (uint256);
      function tinycentsToTinybars(uint256 tinycentsAmount) external returns (uint256);
  }
  
  contract HbarRateReader {
      // 汇率预编译固定地址
      address private constant RATE_ADDR = 0x0000000000000000000000000000000000000169;
  
      // 返回1HBAR对应的美分数值，精度到小数点后2位
      function getHbarUsdPrice() external returns (uint256) {
          // 1 HBAR = 10^8 tinybar
          uint256 oneHbar = 1e8;
          return IExchangeRatePrecompile(RATE_ADDR).tinybarsToTinycents(oneHbar);
      }
  }
  

• 链下同步上链
  如果你的业务读取汇率的频率很高，可以复用你现在写的SDK查询逻辑，监听0.0.112文件的更新事件，每次文件更新就把最新汇率通过交易写入你自己业务合约的存储变量里，合约直接读本地存储即可，比每次调用预编译更省gas。

现有代码的注意点 #

你现在写的SDK查询逻辑本身没问题，但要注意0.0.112的内容是Protobuf序列化的二进制格式，直接调用toString()打印出来是乱码，需要用官方给出的ExchangeRate proto结构反序列化后，才能拿到正确的汇率值、时间参数。

不要尝试回溯该文件的历史版本做价格推算，网络只会保留当前生效、下一个待生效的两个版本内容，更早的历史数据不会永久存储。

内容的提问来源于stack exchange，提问作者FungalFury