Struct PriceUpdateV2

pub struct PriceUpdateV2 {
    pub write_authority: Pubkey,
    pub verification_level: VerificationLevel,
    pub price_message: PriceFeedMessage,
    pub posted_slot: u64,
}

A price update account. This account is used by the Pyth Receiver program to store a verified price update from a Pyth price feed. It contains:

• write_authority: The write authority for this account. This authority can close this account to reclaim rent or update the account to contain a different price update.
• verification_level: The VerificationLevel of this price update. This represents how many Wormhole guardian signatures have been verified for this price update.
• price_message: The actual price update.
• posted_slot: The slot at which this price update was posted.

Fields

write_authority: Pubkey

verification_level: VerificationLevel

price_message: PriceFeedMessage

posted_slot: u64

Implementations

impl PriceUpdateV2

pub const LEN: usize = 134usize

impl PriceUpdateV2

pub fn get_price_unchecked( &self, feed_id: &FeedId, ) -> Result<Price, GetPriceError>

Get a Price from a PriceUpdateV2 account for a given FeedId.

Warning

This function does not check :

• How recent the price is
• Whether the price update has been verified

It is therefore unsafe to use this function without any extra checks, as it allows for the possibility of using unverified or outdated price updates.

pub fn get_price_no_older_than_with_custom_verification_level( &self, clock: &Clock, maximum_age: u64, feed_id: &FeedId, verification_level: VerificationLevel, ) -> Result<Price, GetPriceError>

Get a Price from a PriceUpdateV2 account for a given FeedId no older than maximum_age with customizable verification level.

Warning

Lowering the verification level from Full to Partial increases the risk of using a malicious price update. Please read the documentation for VerificationLevel for more information.

Example

use pyth_solana_receiver_sdk::price_update::{get_feed_id_from_hex, VerificationLevel, PriceUpdateV2};
use anchor_lang::prelude::*;

const MAXIMUM_AGE : u64 = 30;
const FEED_ID: &str = "0xef0d8b6fda2ceba41da15d4095d1da392a0d2f8ed0c6c7bc0f4cfac8c280b56d"; // SOL/USD

#[derive(Accounts)]
#[instruction(amount_in_usd : u64)]
pub struct ReadPriceAccount<'info> {
    pub price_update: Account<'info, PriceUpdateV2>,
}

pub fn read_price_account(ctx : Context<ReadPriceAccount>) -> Result<()> {
    let price_update = &mut ctx.accounts.price_update;
    let price = price_update.get_price_no_older_than_with_custom_verification_level(&Clock::get()?, MAXIMUM_AGE, &get_feed_id_from_hex(FEED_ID)?, VerificationLevel::Partial{num_signatures: 5})?;
    Ok(())
}

pub fn get_price_no_older_than( &self, clock: &Clock, maximum_age: u64, feed_id: &FeedId, ) -> Result<Price, GetPriceError>

Get a Price from a PriceUpdateV2 account for a given FeedId no older than maximum_age with Full verification.

Example

use pyth_solana_receiver_sdk::price_update::{get_feed_id_from_hex, PriceUpdateV2};
use anchor_lang::prelude::*;

const MAXIMUM_AGE : u64 = 30;
const FEED_ID: &str = "0xef0d8b6fda2ceba41da15d4095d1da392a0d2f8ed0c6c7bc0f4cfac8c280b56d"; // SOL/USD

#[derive(Accounts)]
#[instruction(amount_in_usd : u64)]
pub struct ReadPriceAccount<'info> {
    pub price_update: Account<'info, PriceUpdateV2>,
}

pub fn read_price_account(ctx : Context<ReadPriceAccount>) -> Result<()> {
    let price_update = &mut ctx.accounts.price_update;
    let price = price_update.get_price_no_older_than(&Clock::get()?, MAXIMUM_AGE, &get_feed_id_from_hex(FEED_ID)?)?;
    Ok(())
}

Trait Implementations

impl AccountDeserialize for PriceUpdateV2

fn try_deserialize(buf: &mut &[u8]) -> Result<Self>

Deserializes previously initialized account data. Should fail for all uninitialized accounts, where the bytes are zeroed. Implementations should be unique to a particular account type so that one can never successfully deserialize the data of one account type into another. For example, if the SPL token program were to implement this trait, it should be impossible to deserialize a Mint account into a token Account.

fn try_deserialize_unchecked(buf: &mut &[u8]) -> Result<Self>

Deserializes account data without checking the account discriminator. This should only be used on account initialization, when the bytes of the account are zeroed.

impl AccountSerialize for PriceUpdateV2

fn try_serialize<W: Write>(&self, writer: &mut W) -> Result<()>

Serializes the account data into writer.

impl BorshDeserialize for PriceUpdateV2

where Pubkey: BorshDeserialize, VerificationLevel: BorshDeserialize, PriceFeedMessage: BorshDeserialize, u64: BorshDeserialize,

fn deserialize(buf: &mut &[u8]) -> Result<Self, Error>

Deserializes this instance from a given slice of bytes. Updates the buffer to point at the remaining bytes.

fn try_from_slice(v: &[u8]) -> Result<Self, Error>

Deserialize this instance from a slice of bytes.

impl BorshSerialize for PriceUpdateV2

where Pubkey: BorshSerialize, VerificationLevel: BorshSerialize, PriceFeedMessage: BorshSerialize, u64: BorshSerialize,

fn serialize<W: Write>(&self, writer: &mut W) -> Result<(), Error>

fn try_to_vec(&self) -> Result<Vec<u8>, Error>

Serialize this instance into a vector of bytes.

impl BorshSchema for PriceUpdateV2

where Pubkey: BorshSchema, VerificationLevel: BorshSchema, PriceFeedMessage: BorshSchema, u64: BorshSchema,

fn declaration() -> Declaration

Get the name of the type without brackets.

fn add_definitions_recursively( definitions: &mut HashMap<Declaration, Definition>, )

Recursively, using DFS, add type definitions required for this type. For primitive types this is an empty map. Type definition explains how to serialize/deserialize a type.

fn add_definition( declaration: String, definition: Definition, definitions: &mut HashMap<String, Definition>, )

Helper method to add a single type definition to the map.

fn schema_container() -> BorshSchemaContainer

impl Clone for PriceUpdateV2

fn clone(&self) -> PriceUpdateV2

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Discriminator for PriceUpdateV2

fn discriminator() -> [u8; 8]

impl Owner for PriceUpdateV2

fn owner() -> Pubkey