# Pyth 网络开发指南 Pyth Network 是一个去中心化的预言机，为加密货币、股票、外汇和大宗商品提供实时价格信息。本指南涵盖将 Pyth 价格源集成到 Solana 应用程序中。 ## 概述 Pyth 网络提供： * **实时价格反馈** \- 400ms 更新频率，采用拉动预言机模型 * **置信区间** \- 每个价格的统计不确定性界限 * **EMA 价格** \- 指数移动平均价格（约 1 小时窗口） * **多资产支持** \- 加密货币、股票、外汇、商品、指数 * **链上集成** \- Solana 程序的 CPI * **链下集成** \- 通过 Hermes 的 HTTP 和 WebSocket API ## 程序 ID 节目|地址 |描述 ---|---|--- Solana 接收器 | `rec5EKMGg6MxZYaMdyBfgwp4d5rB9T1VQH5pJv5LtFJ` |向 Solana 发布价格更新价格反馈 | `pythWSnswVUd12oZpeFP8e9CVaEqJg25g1Vtc2biRsT` |存储喂价数据 **部署在**：Solana 主网、Devnet、Eclipse 主网/测试网、Sonic 网络 ## 流行的 Price Feed ID 资产|十六进制进给 ID ---|--- 比特币/美元 | `0xe62df6c8b4a85fe1a67db44dc12de5db330f7ac66b72dc658afedf0f4a415b43` 以太坊/美元 | `0xff61491a931112ddf1bd8147cd1b641375f79f5825126d665480874634fd0ace` 索尔/美元 | `0xef0d8b6fda2ceba41da15d4095d1da392a0d2f8ed0c6c7bc0f4cfac8c280b56d` USDC/美元 | `0xeaa020c61cc479712813461ce153894a96a6c00b21ed0cfc2798d1f9a9e9c94a` USDT/美元 | `0x2b89b9dc8fdf9f34709a5b106b472f0f39bb6ca9ce04b0fd7f2e971688e2e53b` 完整列表： ## 快速入门 ### 安装 # TypeScript/JavaScript npm install @pythnetwork/hermes-client @pythnetwork/pyth-solana-receiver # Rust（添加到 Cargo.toml） # pyth-solana-receiver-sdk = "0.3.0" ### 获取价格（链下）从“@pythnetwork/hermes-client”导入{ HermesClient }； const client = new HermesClient("https://hermes.pyth.network"); const 价格 ID = [ "0xe62df6c8b4a85fe1a67db44dc12de5db330f7ac66b72dc658afedf0f4a415b43", // BTC/USD ]; const PriceUpdates = 等待 client.getLatestPriceUpdates(priceIds); for (priceUpdates.parsed 的常量更新) { 常量价格 = update.price; const displayPrice = Number(价格.价格) * Math.pow(10, 价格.expo); console.log(`价格：$${displayPrice.toFixed(2)}`); console.log(`置信度：±${Number(price.conf) * Math.pow(10,price.expo)}`); } ### 使用链上价格（Rust/Anchor）使用anchor_lang::prelude::*；使用 pyth_solana_receiver_sdk::price_update::PriceUpdateV2; #[导出（账户）] pub struct UsePrice <'信息> { pub Price_update: 账户<'info, PriceUpdateV2>, } pub fn use_price(ctx: Context) -> Result<()> { 让price_update = &ctx.accounts.price_update; 让时钟 = Clock::get()?; // 获取不超过 60 秒的价格让价格=price_update.get_price_no_older_than( &时钟， 60, // 最大年龄（以秒为单位））？； msg!("价格：{}×10^{}",price.price,price.exponent); msg!("置信度：±{}",price.conf); 好的(()) } ** ** ## 核心概念 ### 价格结构每个 Pyth 价格包含：领域|类型 |描述 ---|---|--- `价格` | i64 |定点格式的价格值 `conf` | u64 | 64置信区间（标准差） `世博会` | i32 |缩放指数（例如，-8 表示除以 10^8） `发布时间` | i64 |价格的 Unix 时间戳 **转换为显示价格：** const displayPrice = 价格 * Math.pow(10, expo); // 示例：价格=19405100，博览会=-2 → $194,051.00 ### 置信区间置信区间代表报告价格的不确定性： // 价格为 $50,000 ± $50 意味着： // - 真实价格有 68% 的可能性在 $49,950 - $50,050 之间 // - 使用信心进行风险管理常量价格 = 50000；常量置信度 = 50； // 安全下界（保守） const safeLowerBound = 价格 - 置信度； // 安全上限（保守） const safeUpperBound = 价格 + 置信度； **最佳实践**：有信心拒绝价格 > 2% 的价格：常量最大置信比 = 0.02; // 2% constconfidenceRatio = 置信度 / Math.abs(价格); if (confidenceRatio > maxConfidenceRatio) { throw new Error("价格信心太宽"); } ### EMA 价格指数移动平均价格平滑短期波动： * ~1 小时平均窗口（5921 Solana 插槽） * 按逆置信度加权（置信度严格 = 权重更大） * 适合：清算、抵押品估值 * 可作为“ema_price”和“ema_conf”使用 // 将 EMA 用于波动性较小的应用程序 const emaPrice = 价格更新.emaPrice; const emaConf = PriceUpdate.emaConf; ** ** ## 链下集成 ### 爱马仕客户端 Hermes 是链下获取 Pyth 价格的推荐方式。 **公共端点**：`https://hermes.pyth.network` > 对于生产，从 Pyth 数据提供商获取专用端点。 ### 获取最新价格从“@pythnetwork/hermes-client”导入{ HermesClient }； const client = new HermesClient("https://hermes.pyth.network"); // 单价 const btcPrice = 等待 client.getLatestPriceUpdates([ “0xe62df6c8b4a85fe1a67db44dc12de5db330f7ac66b72dc658afedf0f4a415b43” ]); // 一个请求中有多个价格 const 价格 = 等待 client.getLatestPriceUpdates([ “0xe62df6c8b4a85fe1a67db44dc12de5db330f7ac66b72dc658afedf0f4a415b43”，//比特币 “0xff61491a931112ddf1bd8147cd1b641375f79f5825126d665480874634fd0ace”, // 以太坊 “0xef0d8b6fda2ceba41da15d4095d1da392a0d2f8ed0c6c7bc0f4cfac8c280b56d”，//SOL ]); ### 流式传输实时更新从“@pythnetwork/hermes-client”导入{ HermesClient }； const client = new HermesClient("https://hermes.pyth.network"); const 价格 ID = [ “0xe62df6c8b4a85fe1a67db44dc12de5db330f7ac66b72dc658afedf0f4a415b43” ]; // 通过SSE订阅实时更新 const eventSource = 等待 client.getPriceUpdatesStream(priceIds, { 解析：真实， }); eventSource.onmessage = (事件) => { const data = JSON.parse(event.data); console.log("价格更新：", data); }; eventSource.onerror = (错误) => { console.error("流错误：", error); eventSource.close(); }; // 完成后关闭 // eventSource.close(); ### 将价格发布到 Solana 从“@pythnetwork/pyth-solana-receiver”导入{PythSolanaReceiver}；从“@pythnetwork/hermes-client”导入{ HermesClient }；从“@solana/web3.js”导入{连接，密钥对}； const 连接 = new Connection("https://api.mainnet-beta.solana.com"); const wallet = Keypair.fromSecretKey(/* 你的密钥 */); const hermesClient = new HermesClient("https://hermes.pyth.network"); const pythReceiver = new PythSolanaReceiver({ 连接, 钱包 }); // 获取价格更新数据 const PriceUpdateData = 等待 hermesClient.getLatestPriceUpdates([ “0xe62df6c8b4a85fe1a67db44dc12de5db330f7ac66b72dc658afedf0f4a415b43” ]); // 构建交易以发布价格 const transactionBuilder = pythReceiver.newTransactionBuilder(); 等待 transactionBuilder.addPostPriceUpdates(priceUpdateData.binary.data); // 添加使用价格的程序指令 // transactionBuilder.addInstruction(yourInstruction); // 发送交易 const 事务 = 等待 transactionBuilder.buildVersionedTransactions({ 计算单位价格MicroLamports：50000， }); for (const tx of transactions) { const sig = 等待连接.sendTransaction(tx); console.log("交易：", sig); } ** ** ## 链上集成（Rust） ### 设置添加到“Cargo.toml”： [依赖项] pyth-solana-receiver-sdk =“0.3.0” 锚-lang =“0.30.1” ### 主播节目阅读价格使用anchor_lang::prelude::*；使用 pyth_solana_receiver_sdk::price_update::{PriceUpdateV2, get_feed_id_from_hex}； declare_id!("你的程序Id..."); // BTC/USD 喂价 ID const BTC_USD_FEED_ID: &str = "0xe62df6c8b4a85fe1a67db44dc12de5db330f7ac66b72dc658afedf0f4a415b43"; #[节目] 酒吧模组我的程序{ 使用超级::*; pub fn check_price(ctx: Context) -> 结果<()> { 让price_update = &ctx.accounts.price_update; 让时钟 = Clock::get()?; // 验证这是正确的 feed 让 feed_id = get_feed_id_from_hex(BTC_USD_FEED_ID)?; // 获取不超过 60 秒的价格让价格=price_update.get_price_no_older_than_with_custom_verification（ &时钟， 60、 &feed_id, ctx.accounts.price_update.to_account_info().owner, ）？； msg!("BTC/USD价格：{} × 10^{}",price.price,price.exponent); msg!("置信度：±{}",price.conf); 好的(()) } } #[导出（账户）] pub struct CheckPrice <'信息> { #[账户( 约束 = Price_update.to_account_info().owner == &pyth_solana_receiver_sdk::ID )] pub Price_update: 账户<'info, PriceUpdateV2>, } ### 使用价格进行计算 pub fn swap_with_oracle( ctx: 上下文, 金额：u64， ) -> 结果 <()> { 让price_update = &ctx.accounts.price_update; 让时钟 = Clock::get()?; // 通过陈旧性检查获取价格让价格 = Price_update.get_price_no_older_than(&clock, 30)?; // 验证置信度（最大价格的 1%）让conf_ratio = (price.conf as u128 * 10000) / (price.price.unsigned_abs() as u128); require!(conf_ratio <= 100, ErrorCode::ConfidenceTooWide); // 将价格转换为可用格式 //price.price与price.exponent是定点的让price_scaled = 如果price.exponent >= 0 { (价格.价格为u128) * 10_u128.pow(价格.指数为u32) } 否则{ (价格.价格为u128) / 10_u128.pow((-价格.指数)为u32) }; // 使用预言机价格计算输出金额让 amount_out = (amount_in as u128) .checked_mul(price_scaled) .ok_or(ErrorCode::MathOverflow)? / 1_000_000; // 调整小数 msg!("使用价格 {} 交换 {} -> {}", amount_in, amount_out, Price_scaled); 好的(()) } #[错误代码] pub 枚举错误代码 { #[msg("价格置信区间太宽")] 信心太大， #[msg("数学溢出")] 数学溢出， } ### 多个价格源 #[导出（帐户）] pub struct Liquidation<'info> { #[账户( 约束 = collateral_price.to_account_info().owner == &pyth_solana_receiver_sdk::ID )] pub collation_price: 帐户<'info, PriceUpdateV2>, #[账户( 约束 = Debt_price.to_account_info().owner == &pyth_solana_receiver_sdk::ID )] pub Debt_price：帐户<'info，PriceUpdateV2>， } pub fn check_liquidation(ctx: Context) -> Result { 让时钟 = Clock::get()?; 让抵押品 = ctx.accounts.collateral_price .get_price_no_older_than(&clock, 60)?; 让债务 = ctx.accounts.debt_price .get_price_no_older_than(&clock, 60)?; // 标准化为相同指数以进行比较让 collateral_value = normalize_price（collateral.price，collateral.exponent）; 让debt_value = normalize_price(debt.price,debt.exponent); // 检查是否抵押不足让 is_liquidatable = 抵押品价值 < 债务价值 * 150 / 100; // 150% 比例好的（可清算） } fn Normalize_price(价格: i64, 博览会: i32) -> i128 { 让target_expo = -8； // 标准化为 8 位小数让调整 = expo - target_expo; 如果调整 >= 0 { (价格为i128) * 10_i128.pow(调整为u32) } 否则{ （价格为 i128）/ 10_i128.pow（（-调整）为 u32） } } ** ** ## 最佳实践 ### 1\.始终检查陈旧性 // 不要使用旧价格 - 设置适当的最大年龄让 max_age_seconds = 60; 让价格 = Price_update.get_price_no_older_than(&clock, max_age_seconds)?; ### 2\.验证置信区间 // 以广泛的信心拒绝价格（高度不确定性）常量 MAX_CONF_BPS: u64 = 200; // 2% 让conf_bps = (price.conf as u128 * 10000) / (price.price.unsigned_abs() as u128); require!(conf_bps <= MAX_CONF_BPS as u128, ErrorCode::ConfidenceTooWide); ### 3\.验证帐户所有权 // 始终验证价格帐户是否属于 Pyth #[账户( 约束 = Price_update.to_account_info().owner == &pyth_solana_receiver_sdk::ID )] pub Price_update: 账户<'info, PriceUpdateV2>, ### 4\.使用 EMA 进行敏感操作 // 对于强平，使用 EMA 以避免操纵让 ema_price = Price_update.get_ema_price_no_older_than(&clock, 60)?; ### 5\.处理价格不可用的情况尝试{ const 价格 = 等待 client.getLatestPriceUpdates([feedId]); // 使用价格 } 捕获（错误）{ // 回退行为或拒绝事务 console.error("价格不可用：", error); } ### 6\.考虑抢先交易 * 对手可能会在您交易之前看到价格更新 * 不要设计与价格更新竞争的逻辑 * 使用适当的滑移容差 ** ** ## 价格反馈类型 ### 固定价格账户 * 由 Pyth 持续维护 * 每个提要的固定地址 * 始终有最新价格 * 由所有用户共享（潜在拥塞） ### 临时价格更新账户 * 每笔交易创建 * 可以指定shard ID进行并行化 * 使用后可收回租金 * 更适合高通量应用 // 使用分片ID避免拥塞 const transactionBuilder = pythReceiver.newTransactionBuilder({ shardId: Math.floor(Math.random() * 65536), // 随机分片 }); ** ** ## 资源 ### 官方文档 * [Pyth 文档]() * [价格 Feed ID]() * [Solana 集成指南]() ### GitHub 存储库 * [pyth-network/pyth-crosschain]() * [pyth-network/pyth-sdk-rs]() ### NPM 包 * [@pythnetwork/hermes-client]() * [@pythnetwork/pyth-solana-receiver]() ### 生锈的箱子 * [pyth-solana-receiver-sdk]() ** ** ## 技能结构 pyth/ ├── SKILL.md # 这个文件 ├── 资源/ │ ├── program-addresses.md # 所有程序 ID 和 Feed ID │ └── api-reference.md # SDK API参考 ├── 例子/ │ ├── 价格反馈/ │ │ ├── fetch-price.ts # 基本价格获取 │ │ └── multiple-prices.ts # 多个价格源 │ ├── 链上/ │ │ ├──anchor-integration.rs # 锚点程序示例 │ │ └──price-validation.rs # 价格验证模式 │ └── 串流/ │ └── real-time-updates.ts # WebSocket 流式传输 ├── 模板/ │ ├── pyth-client.ts # TypeScript 客户端模板 │ └──anchor-oracle.rs # 锚点程序模板 └── 文档/ └── Troubleshooting.md # 常见问题及解决方案

pyth

包含技能