本页面使用机器翻译自英语，可能包含错误或不清楚的语言。如需最准确的信息，请参阅英文原文。由于更新频繁，部分内容可能与英文原文有出入。请加入我们在 Crowdin 上的努力，帮助我们改进本页面的翻译。 (Crowdin translation page, Contributing guide)

如何使用 Pyth 在 Kaia 上获取实时价格

介绍

Pyth 是一个去中心化的神谕网络，它在主要由推式神谕驱动的生态系统中采用了一种独特的方法。 Pyth 不需要以固定的时间间隔向合同推送数据，而是允许你按需提取真实世界的数据。这种模式为开发人员提供了更多控制权，有助于避免不必要的链上更新。通过这种集成，开发人员可以获取实时数据，并使用按使用付费的模式，即只有在请求更新时才收费。

在本指南中，您将学习如何使用 Pyth 的实时价格馈送来读取法定货币 IDR 的价值。您的 Solidity 智能合约将使用 pyth-sdk-solidity 从 Pyth 获取美元/印尼盾价格，您将使用 hermes-client 更新并获取最新价格。

为了快速入门，您可以在 GitHub 上找到本教程的完整代码。这为您提供了随时可用的参考资料，帮助您更快地设置项目和安装。

要求

在开始之前，请确保具备以下条件：

Node.js 和 npm

需要安装依赖项和运行开发工具。
由 KAIA 测试网络代币出资的钱包。

您需要 KAIA 来支付 Kairos 测试网络的部署和交易气体费用。您可以从 [Kaia 水龙头] (https://faucet.kaia.io/) 申请免费测试网络 KAIA。

设置开发环境

在本节中，您将设置开发环境，编译 Oracle 合同，并准备使用 Hardhat 进行部署。

1. 创建硬头巾项目

为项目创建一个新目录并初始化 Hardhat：


mkdir pyth-kaia-hardhat-example && cd pyth-kaia-hardhat-example
npm init -y
npx hardhat@next --init

根据提示接受默认回复。在本指南中，我们将使用摩卡和以太模板。

通过检查 Hardhat 版本来验证您的安装：


npx hardhat --version

2. 设置加密机密

现在，您将使用 Hardhat 的加密密钥库存储 RPC URL 和私人密钥。

运行以下命令


npx hardhat keystore set KAIROS_RPC_URL
npx hardhat keystore set PRIVATE_KEY

确保为每个变量输入密码和值，以保持加密。

3. 配置文件中的参考秘诀

打开 hardhat.config.ts，更新网络部分以引用加密机密。如果使用了不同的密钥名称，请相应更新密钥。


import { configVariable } from "hardhat/config";
module.exports = {
  networks: {
    kairos: {
      url: configVariable("KAIROS_RPC_URL"),
      accounts: [configVariable("PRIVATE_KEY")],
    },
  },
};

创建合约并从 Pyth Oracles 获取价格

在本节中，您将安装 Pyth Solidity SDK，创建一个 PriceConsumer 合约，并使用 Hardhat 进行部署。该合约将读取 Pyth 价格源，稍后你将使用从 Hermes 获取的价格数据对其进行更新。

安装 Pyth SDK

Pyth 提供了一个 Solidity SDK，可让您与链上 Pyth 价格反馈合约进行交互。 SDK 公开了 IPyth 接口和相关结构。

使用 npm 安装 SDK：


npm install --save-dev @pythnetwork/pyth-sdk-solidity

创建 PriceConsumer 合同

在 contracts/PriceConsumer.sol 中创建一个新文件，并添加以下代码：


// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
import "@pythnetwork/pyth-sdk-solidity/IPyth.sol";
import "@pythnetwork/pyth-sdk-solidity/PythStructs.sol";
contract PriceConsumer {
    IPyth public pyth;
    constructor(address pythContract) {
        pyth = IPyth(pythContract);
    }
    function updatePrice(bytes[] calldata priceUpdateData)
        external
        payable
    {
        // Pay the Pyth fee for receiving price updates
        uint fee = pyth.getUpdateFee(priceUpdateData);
        require(msg.value >= fee, "Not enough fee sent");
        // Update the Pyth price state
        pyth.updatePriceFeeds{value: fee}(priceUpdateData);
        // Can fetch the price and use it as well
        //PythStructs.Price memory currentBasePrice = pyth.getPriceNoOlderThan(priceFeedId, 60);
    }
    function getLatestPrice(bytes32 priceFeedId) public view returns (int64, int32) {
        // Read the current price from a price feed if it is less than 60 seconds old.
        // Each price feed (e.g., USD/IDR) is identified by a price feed ID.
        // The complete list of feed IDs is available at https://docs.pyth.network/price-feeds/price-feeds
        PythStructs.Price memory currentBasePrice = pyth.getPriceNoOlderThan(priceFeedId, 60);
        
        // uint256 basePrice = PythUtils.convertToUint(
        //   currentBasePrice.price,
        //   currentBasePrice.expo,
        //   18
        // );
        
        return (currentBasePrice.price, currentBasePrice.expo);
    }
}

走过

价格消费者合同：

从 @pythnetwork/pyth-sdk-solidity 导入 Pyth 接口和结构体。
商店
- Pyth 合约实例 (pyth)。
- 美元/印度卢比的价格输入 ID (usdIdrPriceId)。
Exposes updateAndGetUsdIdrPrice, which：
- 使用 IPyth.getUpdateFee 计算更新费用。
- 调用 IPyth.updatePriceFeeds，输入所需费用。
- 调用 IPyth.getPriceNoOlderThan 读取新的美元/印度卢比价格。
- 返回原始价格、指数和发布时间。

稍后，您的离链爱马仕客户端将建立 priceUpdate 字节数组，并在需要新价格时将其传入此函数。

编制合同

运行以下命令编译合同


npx hardhat compile

部署合同

要部署 PriceConsumer 合同，需要创建一个 Ignition 模块，然后运行部署命令。

创建点火模块

在 ignition/modules/PriceConsumer.ts 创建一个新文件：


import { buildModule } from "@nomicfoundation/hardhat-ignition/modules";
const pythContractAddress = "0x2880ab155794e7179c9ee2e38200202908c17b43"; 
export default buildModule("PriceConsumerModule", (m) => {
  const priceConsumer = m.contract("PriceConsumer", [pythContractAddress]);
  return { priceConsumer };
});

部署合同

使用 Ignition 模块将 PriceConsumer 合同部署到 Kairos 测试网络：


npx hardhat ignition deploy --network kairos ignition/modules/PriceConsumer.ts

出现提示时，输入先前为加密机密配置的密钥库密码。

完成上述操作后，您的 "PriceConsumer.sol "合约就会部署到 Kairos 测试网上，并准备好从 Pyth 消费实时美元/印尼盾价格。

从 TypeScript 互动

在最后一步，您将使用 TypeScript 与已部署的 PriceConsumer 合约交互。该脚本将通过 Hermes 客户端请求 Pyth 价格更新数据，并在链上发送，从而获取最新的美元/印尼盾价格。

安装依赖项

安装所需的软件包：


npm install --save-dev tsx @pythnetwork/hermes-client @dotenv

** 设置 .env**

在项目根目录下创建 .env 文件，并添加私人密钥：


PRIVATE_KEY="0xDEAD....." // REPLACE WITH YOUR PRIVATE KEY

创建交互脚本

在 scripts/interact.ts创建一个新文件，并添加以下内容：


import { HermesClient } from "@pythnetwork/hermes-client";
import { ethers } from "ethers";
import 'dotenv/config'
// 1. Setup
const hermes = new HermesClient("https://hermes.pyth.network");
const provider = new ethers.JsonRpcProvider(
  "https://public-en-kairos.node.kaia.io"
);
const PK = process.env.PRIVATE_KEY; 
const wallet = new ethers.Wallet(PK, provider);
// 2. Your deployed contract
const priceConsumerAddress = "0x91e89aa32224dEd5dA483a83a4de45bF4bE57caA"; // REPLACE WITH DEPLOYED PRICE CONSUMER CONTRACT
const priceConsumerAbi = [
  "function updatePrice(bytes[] priceUpdateData) external payable",
  "function getLatestPrice(bytes32 priceId) public view returns(int64, int32)",
];
const priceConsumer = new ethers.Contract(
  priceConsumerAddress,
  priceConsumerAbi,
  wallet
);
// 3. Price feed IDs
const priceId =
  "0x6693afcd49878bbd622e46bd805e7177932cf6ab0b1c91b135d71151b9207433"; // FX.USD/IDR Beta Price Feed ID
async function run() {
  // Fetch Hermes price update binary
  const update = await hermes.getLatestPriceUpdates([priceId], {
    encoding: "hex",
  });
  console.log(update);
  const priceUpdateData = ["0x" + update.binary.data]; // must be array of bytes
  console.log(priceUpdateData);
  // Estimate fee required by Pyth contract
  // EVM Network Price Feed Contract Addresses: https://docs.pyth.network/price-feeds/core/contract-addresses/evm
  const pythContractAddress = "0x2880ab155794e7179c9ee2e38200202908c17b43";
  const pythAbi = [
    "function getUpdateFee(bytes[] calldata data) external view returns(uint)",
  ];
  console.log("Pyth contract address:", pythContractAddress);
  const pyth = new ethers.Contract(pythContractAddress, pythAbi, wallet);
  const fee = await pyth.getUpdateFee(priceUpdateData);
  console.log("Pyth fee:", fee.toString());
  // Call your contract
  const tx = await priceConsumer.updatePrice(priceUpdateData, {
    value: fee, // pay the pyth update fee
    gasLimit: 500000,
  });
  console.log("Tx sent:", tx.hash);
  const receipt = await tx.wait();
  console.log("Tx confirmed");
  console.log(receipt);
  // 4. Get latest price from contract
  try {
    console.log("=== Latest Price from Contract ===");
    const [price, expo] = await priceConsumer.getLatestPrice(priceId);
    console.log("Price Value : " + price.toString());
    console.log("Exponent Value : " + expo.toString());
  } catch (error) {
    console.log(error);
    // @ts-ignore
    console.error("\nError calling getLatestPrice:", error.message);
    console.log(
      "This usually means the price is older than 60 seconds or hasn't been updated yet."
    );
    console.log("Make sure updatePrice() was called successfully first.");
  }
}
run();

剧本

用以下命令执行脚本


npx tsx scripts/interact.ts

输出示例


Tx sent: 0x79c5dcb7abd9605b070bf9062ba2e2382272d23d58f7b50446c3107b7784fc8e
Tx confirmed
=== Latest Price from Contract ===
Price Value : 1669784988
Exponent Value : -5
======== —— =========

在搜索栏中粘贴交易哈希值，即可在 Kairos 浏览器上验证您的交易。这证明更新和读取操作均已成功。

结论

在本教程中，你创建了一个从 Pyth 读取实时价格的 Solidity 合约，将其部署到 Kairos 测试网络，并使用 Hermes 客户端与之交互。您还了解到 Pyth 基于拉动的设计如何让您控制价格更新的时间和方式。

欲了解更多信息，请浏览

Pyth API 的 EVM 合同参考
Pyth Oracle AMM 示例用于完整的端到端实施

介绍​

要求​

设置开发环境​

创建合约并从 Pyth Oracles 获取价格​

安装 Pyth SDK​

创建 PriceConsumer 合同​

编制合同​

部署合同​

从 TypeScript 互动​

结论​

介绍

要求