@pythnetwork/pyth-solana-receiver 0.12.0 → 0.14.0

package/dist/esm/PythSolanaReceiver.mjs

@@ -0,0 +1,462 @@
+/* eslint-disable @typescript-eslint/no-non-null-assertion */ /* eslint-disable tsdoc/syntax */ // eslint-disable-next-line unicorn/prefer-node-protocol
+import { Buffer as IsomorphicBuffer } from "buffer";
+import { AnchorProvider, Program } from "@coral-xyz/anchor";
+import { parseAccumulatorUpdateData, parsePriceFeedMessage } from "@pythnetwork/price-service-sdk";
+import { TransactionBuilder } from "@pythnetwork/solana-utils";
+import { PublicKey, Keypair } from "@solana/web3.js";
+import { DEFAULT_PUSH_ORACLE_PROGRAM_ID, DEFAULT_RECEIVER_PROGRAM_ID, DEFAULT_WORMHOLE_PROGRAM_ID, getConfigPda, getGuardianSetPda, getRandomTreasuryId, getTreasuryPda } from "./address.mjs";
+import { POST_UPDATE_ATOMIC_COMPUTE_BUDGET, POST_UPDATE_COMPUTE_BUDGET, UPDATE_PRICE_FEED_COMPUTE_BUDGET } from "./compute_budget.mjs";
+import { IDL as PythPushOracleIdl } from "./idl/pyth_push_oracle.mjs";
+import { IDL as Idl } from "./idl/pyth_solana_receiver.mjs";
+import { IDL as WormholeCoreBridgeSolanaIdl } from "./idl/wormhole_core_bridge_solana.mjs";
+import { buildCloseEncodedVaaInstruction, buildPostEncodedVaaInstructions, findEncodedVaaAccountsByWriteAuthority, getGuardianSetIndex, trimSignatures } from "./vaa.mjs";
+/**
+ * A stable treasury ID. This ID's corresponding treasury address
+ * can be cached in an account lookup table in order to reduce the overall txn size.
+ */ export const DEFAULT_TREASURY_ID = 0;
+/**
+ * A builder class to build transactions that:
+ * - Post price updates (fully or partially verified) or update price feed accounts
+ * - Consume price updates in a consumer program
+ * - (Optionally) Close price update and encoded vaa accounts to recover the rent (`closeUpdateAccounts` in `PythTransactionBuilderConfig`)
+ *
+ * This class provides methods for working with both price update accounts and price feed accounts.
+ * Price update accounts are ephemeral accounts containing a single price update, whereas price feed accounts are long-lived
+ * accounts that always hold price data for a specific feed id. Price feed accounts can be updated to advance the current price.
+ * Applications should choose which type of account to work with based on their needs. In general, applications that
+ * want the price at a specific time (e.g., to settle a trade) should use price update accounts, while applications that want
+ * any recent price should use price feed accounts.
+ *
+ * @example
+ * ```typescript
+ *
+ * // Get the price feed ids from https://pyth.network/developers/price-feed-ids#pyth-evm-stable
+ *  const priceUpdateData = await priceServiceConnection.getLatestVaas([
+ *    SOL_PRICE_FEED_ID,
+ *    ETH_PRICE_FEED_ID,
+ *  ]);
+ *
+ * const transactionBuilder = pythSolanaReceiver.newTransactionBuilder({});
+ * await transactionBuilder.addPostPriceUpdates(priceUpdateData);
+ * console.log("The SOL/USD price update will get posted to:", transactionBuilder.getPriceUpdateAccount(SOL_PRICE_FEED_ID).toBase58())
+ * await transactionBuilder.addPriceConsumerInstructions(...)
+ *
+ * await pythSolanaReceiver.provider.sendAll(await transactionBuilder.buildVersionedTransactions({computeUnitPriceMicroLamports:100000, tightComputeBudget: true}))
+ * ```
+ */ export class PythTransactionBuilder extends TransactionBuilder {
+    pythSolanaReceiver;
+    closeInstructions;
+    priceFeedIdToPriceUpdateAccount;
+    closeUpdateAccounts;
+    constructor(pythSolanaReceiver, config, addressLookupTable){
+        super(pythSolanaReceiver.wallet.publicKey, pythSolanaReceiver.connection, addressLookupTable);
+        this.pythSolanaReceiver = pythSolanaReceiver;
+        this.closeInstructions = [];
+        this.priceFeedIdToPriceUpdateAccount = {};
+        this.closeUpdateAccounts = config.closeUpdateAccounts ?? true;
+    }
+    /**
+   * Add instructions to post price updates to the builder.
+   * Use this function to post fully verified price updates from the present or from the past for your program to consume.
+   *
+   * @param priceUpdateDataArray the output of the `@pythnetwork/price-service-client`'s `PriceServiceConnection.getLatestVaas`. This is an array of verifiable price updates.
+   *
+   * @example
+   * ```typescript
+   * // Get the price feed ids from https://pyth.network/developers/price-feed-ids#pyth-evm-stable
+   * const priceUpdateData = await priceServiceConnection.getLatestVaas([
+   *    SOL_PRICE_FEED_ID,
+   *    ETH_PRICE_FEED_ID,
+   * ]);
+   *
+   * const transactionBuilder = pythSolanaReceiver.newTransactionBuilder({});
+   * await transactionBuilder.addPostPriceUpdates(priceUpdateData);
+   * console.log("The SOL/USD price update will get posted to:", transactionBuilder.getPriceUpdateAccount(SOL_PRICE_FEED_ID).toBase58())
+   * await transactionBuilder.addPriceConsumerInstructions(...)
+   * ```
+   */ async addPostPriceUpdates(priceUpdateDataArray) {
+        const { postInstructions, priceFeedIdToPriceUpdateAccount, closeInstructions } = await this.pythSolanaReceiver.buildPostPriceUpdateInstructions(priceUpdateDataArray);
+        this.closeInstructions.push(...closeInstructions);
+        Object.assign(this.priceFeedIdToPriceUpdateAccount, priceFeedIdToPriceUpdateAccount);
+        this.addInstructions(postInstructions);
+    }
+    /**
+   * Add instructions to post partially verified price updates to the builder.
+   * Use this function to post partially verified price updates from the present or from the past for your program to consume.
+   *
+   * @param priceUpdateDataArray the output of the `@pythnetwork/price-service-client`'s `PriceServiceConnection.getLatestVaas`. This is an array of verifiable price updates.
+   *
+   * Partially verified price updates are price updates where not all the guardian signatures have been verified. By default this methods checks `DEFAULT_REDUCED_GUARDIAN_SET_SIZE` signatures when posting the VAA.
+   * If you are a on-chain program developer, make sure you understand the risks of consuming partially verified price updates here: {@link https://github.com/pyth-network/pyth-crosschain/blob/main/target_chains/solana/pyth_solana_receiver_sdk/src/price_update.rs}.
+   *
+   * @example
+   * ```typescript
+   * // Get the price feed ids from https://pyth.network/developers/price-feed-ids#pyth-evm-stable
+   * const priceUpdateData = await priceServiceConnection.getLatestVaas([
+   *    SOL_PRICE_FEED_ID,
+   *    ETH_PRICE_FEED_ID,
+   * ]);
+   *
+   * const transactionBuilder = pythSolanaReceiver.newTransactionBuilder({});
+   * await transactionBuilder.addPostPartiallyVerifiedPriceUpdates(priceUpdateData);
+   * console.log("The SOL/USD price update will get posted to:", transactionBuilder.getPriceUpdateAccount(SOL_PRICE_FEED_ID).toBase58())
+   * await transactionBuilder.addPriceConsumerInstructions(...)
+   * ...
+   * ```
+   */ async addPostPartiallyVerifiedPriceUpdates(priceUpdateDataArray) {
+        const { postInstructions, priceFeedIdToPriceUpdateAccount, closeInstructions } = await this.pythSolanaReceiver.buildPostPriceUpdateAtomicInstructions(priceUpdateDataArray);
+        this.closeInstructions.push(...closeInstructions);
+        Object.assign(this.priceFeedIdToPriceUpdateAccount, priceFeedIdToPriceUpdateAccount);
+        this.addInstructions(postInstructions);
+    }
+    /**
+   * Add instructions to update price feed accounts to the builder.
+   * Price feed accounts are fixed accounts per price feed id that can only be updated with a more recent price.
+   *
+   * @param priceUpdateDataArray the output of the `@pythnetwork/price-service-client`'s `PriceServiceConnection.getLatestVaas`. This is an array of verifiable price updates.
+   * @param shardId the shard ID of the set of price feed accounts. This shard ID allows for multiple price feed accounts for the same price feed id to exist.
+   *
+   * @example
+   * ```typescript
+   * // Get the price feed ids from https://pyth.network/developers/price-feed-ids#pyth-evm-stable
+   * const priceUpdateData = await priceServiceConnection.getLatestVaas([
+   *    SOL_PRICE_FEED_ID,
+   *    ETH_PRICE_FEED_ID,
+   * ]);
+   *
+   * const transactionBuilder = pythSolanaReceiver.newTransactionBuilder({});
+   * await transactionBuilder.addUpdatePriceFeed(priceUpdateData);
+   * await transactionBuilder.addPriceConsumerInstructions(...)
+   * ...
+   * ```
+   */ async addUpdatePriceFeed(priceUpdateDataArray, shardId) {
+        const { postInstructions, priceFeedIdToPriceUpdateAccount, closeInstructions } = await this.pythSolanaReceiver.buildUpdatePriceFeedInstructions(priceUpdateDataArray, shardId);
+        this.closeInstructions.push(...closeInstructions);
+        Object.assign(this.priceFeedIdToPriceUpdateAccount, priceFeedIdToPriceUpdateAccount);
+        this.addInstructions(postInstructions);
+    }
+    /**
+   * Add instructions that consume price updates to the builder.
+   *
+   * @param getInstructions a function that given a mapping of price feed IDs to price update accounts, generates a series of instructions. Price updates get posted to ephemeral accounts and this function allows the user to indicate which accounts in their instruction need to be "replaced" with each price update account.
+   * If multiple price updates for the same price feed ID are posted with the same builder, the account corresponding to the last update to get posted will be used.
+   *
+   * @example
+   * ```typescript
+   * ...
+   * await transactionBuilder.addPostPriceUpdates(priceUpdateData);
+   * await transactionBuilder.addPriceConsumerInstructions(
+   *   async (
+   *     getPriceUpdateAccount: ( priceFeedId: string) => PublicKey
+   *   ): Promise<InstructionWithEphemeralSigners[]> => {
+   *     return [
+   *       {
+   *         instruction: await myFirstPythApp.methods
+   *           .consume()
+   *           .accounts({
+   *              solPriceUpdate: getPriceUpdateAccount(SOL_PRICE_FEED_ID),
+   *              ethPriceUpdate: getPriceUpdateAccount(ETH_PRICE_FEED_ID),
+   *           })
+   *           .instruction(),
+   *         signers: [],
+   *       },
+   *     ];
+   *   }
+   * );
+   * ```
+   */ async addPriceConsumerInstructions(getInstructions) {
+        this.addInstructions(await getInstructions(this.getPriceUpdateAccount.bind(this)));
+    }
+    /** Add instructions to close encoded VAA accounts from previous actions.
+   * If you have previously used the PythTransactionBuilder with closeUpdateAccounts set to false or if you posted encoded VAAs but the transaction to close them did not land on-chain, your wallet might own many encoded VAA accounts.
+   * The rent cost for these accounts is 0.008 SOL per encoded VAA account. You can recover this rent calling this function when building a set of transactions.
+   */ async addClosePreviousEncodedVaasInstructions(maxInstructions = 40) {
+        this.addInstructions(await this.pythSolanaReceiver.buildClosePreviousEncodedVaasInstructions(maxInstructions));
+    }
+    /**
+   * Returns all the added instructions batched into versioned transactions, plus for each transaction the ephemeral signers that need to sign it
+   */ async buildVersionedTransactions(args) {
+        if (this.closeUpdateAccounts) {
+            this.addInstructions(this.closeInstructions);
+        }
+        return super.buildVersionedTransactions(args);
+    }
+    /**
+   * Returns all the added instructions batched into transactions, plus for each transaction the ephemeral signers that need to sign it
+   */ buildLegacyTransactions(args) {
+        if (this.closeUpdateAccounts) {
+            this.addInstructions(this.closeInstructions);
+        }
+        return super.buildLegacyTransactions(args);
+    }
+    /**
+   * This method is used to retrieve the address of the price update account where the price update for a given price feed ID will be posted.
+   * If multiple price updates for the same price feed ID will be posted with the same builder, the address of the account corresponding to the last update to get posted will be returned.
+   * */ getPriceUpdateAccount(priceFeedId) {
+        const priceUpdateAccount = this.priceFeedIdToPriceUpdateAccount[priceFeedId];
+        if (!priceUpdateAccount) {
+            throw new Error(`No price update account found for the price feed ID ${priceFeedId}. Make sure to call addPostPriceUpdates or addPostPartiallyVerifiedPriceUpdates before calling this function.`);
+        }
+        return priceUpdateAccount;
+    }
+}
+/**
+ * A class to interact with the Pyth Solana Receiver program.
+ *
+ * This class provides helpful methods to build instructions to interact with the Pyth Solana Receiver program:
+ * - Post price updates (fully or partially verified)
+ * - Close price update and encoded vaa accounts to recover rent
+ */ export class PythSolanaReceiver {
+    connection;
+    wallet;
+    provider;
+    receiver;
+    wormhole;
+    pushOracle;
+    treasuryId;
+    constructor({ connection, wallet, wormholeProgramId = DEFAULT_WORMHOLE_PROGRAM_ID, receiverProgramId = DEFAULT_RECEIVER_PROGRAM_ID, pushOracleProgramId = DEFAULT_PUSH_ORACLE_PROGRAM_ID, treasuryId }){
+        if (treasuryId !== undefined && (treasuryId < 0 || treasuryId > 255)) {
+            throw new Error("treasuryId must be between 0 and 255");
+        }
+        this.connection = connection;
+        this.wallet = wallet;
+        this.provider = new AnchorProvider(this.connection, this.wallet, {
+            commitment: connection.commitment
+        });
+        this.receiver = new Program(Idl, receiverProgramId, this.provider);
+        this.wormhole = new Program(WormholeCoreBridgeSolanaIdl, wormholeProgramId, this.provider);
+        this.pushOracle = new Program(PythPushOracleIdl, pushOracleProgramId, this.provider);
+        this.treasuryId = treasuryId;
+    }
+    /**
+   * Get a new transaction builder to build transactions that interact with the Pyth Solana Receiver program and consume price updates
+   */ newTransactionBuilder(config, addressLookupAccount) {
+        return new PythTransactionBuilder(this, config, addressLookupAccount);
+    }
+    /**
+   * Build a series of helper instructions that post price updates to the Pyth Solana Receiver program and another series to close the price update accounts.
+   *
+   * This function uses partially verified price updates. Partially verified price updates are price updates where not all the guardian signatures have been verified. By default this methods checks `DEFAULT_REDUCED_GUARDIAN_SET_SIZE` signatures when posting the VAA.
+   * If you are a on-chain program developer, make sure you understand the risks of consuming partially verified price updates here: {@link https://github.com/pyth-network/pyth-crosschain/blob/main/target_chains/solana/pyth_solana_receiver_sdk/src/price_update.rs}.
+   *
+   * @param priceUpdateDataArray the output of the `@pythnetwork/price-service-client`'s `PriceServiceConnection.getLatestVaas`. This is an array of verifiable price updates.
+   * @returns `postInstructions`: the instructions to post the price updates, these should be called before consuming the price updates
+   * @returns `priceFeedIdToPriceUpdateAccount`: this is a map of price feed IDs to Solana address. Given a price feed ID, you can use this map to find the account where `postInstructions` will post the price update.
+   * @returns `closeInstructions`: the instructions to close the price update accounts, these should be called after consuming the price updates
+   */ async buildPostPriceUpdateAtomicInstructions(priceUpdateDataArray) {
+        const postInstructions = [];
+        const priceFeedIdToPriceUpdateAccount = {};
+        const closeInstructions = [];
+        const treasuryId = this.treasuryId ?? getRandomTreasuryId();
+        for (const priceUpdateData of priceUpdateDataArray){
+            const accumulatorUpdateData = parseAccumulatorUpdateData(IsomorphicBuffer.from(priceUpdateData, "base64"));
+            const guardianSetIndex = getGuardianSetIndex(accumulatorUpdateData.vaa);
+            const trimmedVaa = trimSignatures(accumulatorUpdateData.vaa);
+            for (const update of accumulatorUpdateData.updates){
+                const priceUpdateKeypair = new Keypair();
+                postInstructions.push({
+                    instruction: await this.receiver.methods.postUpdateAtomic({
+                        vaa: trimmedVaa,
+                        merklePriceUpdate: update,
+                        treasuryId
+                    }).accounts({
+                        priceUpdateAccount: priceUpdateKeypair.publicKey,
+                        treasury: getTreasuryPda(treasuryId, this.receiver.programId),
+                        config: getConfigPda(this.receiver.programId),
+                        guardianSet: getGuardianSetPda(guardianSetIndex, this.wormhole.programId)
+                    }).instruction(),
+                    signers: [
+                        priceUpdateKeypair
+                    ],
+                    computeUnits: POST_UPDATE_ATOMIC_COMPUTE_BUDGET
+                });
+                priceFeedIdToPriceUpdateAccount["0x" + parsePriceFeedMessage(update.message).feedId.toString("hex")] = priceUpdateKeypair.publicKey;
+                closeInstructions.push(await this.buildClosePriceUpdateInstruction(priceUpdateKeypair.publicKey));
+            }
+        }
+        return {
+            postInstructions,
+            priceFeedIdToPriceUpdateAccount,
+            closeInstructions
+        };
+    }
+    /**
+   * Build a series of helper instructions that post price updates to the Pyth Solana Receiver program and another series to close the encoded vaa accounts and the price update accounts.
+   *
+   * @param priceUpdateDataArray the output of the `@pythnetwork/price-service-client`'s `PriceServiceConnection.getLatestVaas`. This is an array of verifiable price updates.
+   * @returns `postInstructions`: the instructions to post the price updates, these should be called before consuming the price updates
+   * @returns `priceFeedIdToPriceUpdateAccount`: this is a map of price feed IDs to Solana address. Given a price feed ID, you can use this map to find the account where `postInstructions` will post the price update.
+   * @returns `closeInstructions`: the instructions to close the price update accounts, these should be called after consuming the price updates
+   */ async buildPostPriceUpdateInstructions(priceUpdateDataArray) {
+        const postInstructions = [];
+        const priceFeedIdToPriceUpdateAccount = {};
+        const closeInstructions = [];
+        const treasuryId = this.treasuryId ?? getRandomTreasuryId();
+        for (const priceUpdateData of priceUpdateDataArray){
+            const accumulatorUpdateData = parseAccumulatorUpdateData(IsomorphicBuffer.from(priceUpdateData, "base64"));
+            const { postInstructions: postEncodedVaaInstructions, encodedVaaAddress: encodedVaa, closeInstructions: postEncodedVaacloseInstructions } = await this.buildPostEncodedVaaInstructions(accumulatorUpdateData.vaa);
+            postInstructions.push(...postEncodedVaaInstructions);
+            closeInstructions.push(...postEncodedVaacloseInstructions);
+            for (const update of accumulatorUpdateData.updates){
+                const priceUpdateKeypair = new Keypair();
+                postInstructions.push({
+                    instruction: await this.receiver.methods.postUpdate({
+                        merklePriceUpdate: update,
+                        treasuryId
+                    }).accounts({
+                        encodedVaa,
+                        priceUpdateAccount: priceUpdateKeypair.publicKey,
+                        treasury: getTreasuryPda(treasuryId, this.receiver.programId),
+                        config: getConfigPda(this.receiver.programId)
+                    }).instruction(),
+                    signers: [
+                        priceUpdateKeypair
+                    ],
+                    computeUnits: POST_UPDATE_COMPUTE_BUDGET
+                });
+                priceFeedIdToPriceUpdateAccount["0x" + parsePriceFeedMessage(update.message).feedId.toString("hex")] = priceUpdateKeypair.publicKey;
+                closeInstructions.push(await this.buildClosePriceUpdateInstruction(priceUpdateKeypair.publicKey));
+            }
+        }
+        return {
+            postInstructions,
+            priceFeedIdToPriceUpdateAccount,
+            closeInstructions
+        };
+    }
+    /**
+   * Build a series of helper instructions that update one or many price feed accounts and another series to close the encoded vaa accounts used to update the price feed accounts.
+   *
+   * @param priceUpdateDataArray the output of the `@pythnetwork/price-service-client`'s `PriceServiceConnection.getLatestVaas`. This is an array of verifiable price updates.
+   * @param shardId the shard ID of the set of price feed accounts. This shard ID allows for multiple price feed accounts for the same price feed id to exist.
+   * @returns `postInstructions`: the instructions to update the price feed accounts. If the price feed accounts don't contain a recent update, these should be called before consuming the price updates.
+   * @returns `priceFeedIdToPriceUpdateAccount`: this is a map of price feed IDs to Solana address. Given a price feed ID, you can use this map to find the account where `postInstructions` will post the price update. Note that since price feed accounts are PDAs, the address of the account can also be found with `getPriceFeedAccountAddress`.
+   * @returns `closeInstructions`: the instructions to close the encoded VAA accounts that were used to update the price feed accounts.
+   */ async buildUpdatePriceFeedInstructions(priceUpdateDataArray, shardId) {
+        const postInstructions = [];
+        const priceFeedIdToPriceUpdateAccount = {};
+        const closeInstructions = [];
+        const treasuryId = this.treasuryId ?? getRandomTreasuryId();
+        for (const priceUpdateData of priceUpdateDataArray){
+            const accumulatorUpdateData = parseAccumulatorUpdateData(IsomorphicBuffer.from(priceUpdateData, "base64"));
+            const { postInstructions: postEncodedVaaInstructions, encodedVaaAddress: encodedVaa, closeInstructions: postEncodedVaacloseInstructions } = await this.buildPostEncodedVaaInstructions(accumulatorUpdateData.vaa);
+            postInstructions.push(...postEncodedVaaInstructions);
+            closeInstructions.push(...postEncodedVaacloseInstructions);
+            for (const update of accumulatorUpdateData.updates){
+                const feedId = parsePriceFeedMessage(update.message).feedId;
+                postInstructions.push({
+                    instruction: await this.pushOracle.methods.updatePriceFeed({
+                        merklePriceUpdate: update,
+                        treasuryId
+                    }, shardId, [
+                        ...feedId
+                    ]).accounts({
+                        pythSolanaReceiver: this.receiver.programId,
+                        encodedVaa,
+                        priceFeedAccount: this.getPriceFeedAccountAddress(shardId, feedId),
+                        treasury: getTreasuryPda(treasuryId, this.receiver.programId),
+                        config: getConfigPda(this.receiver.programId)
+                    }).instruction(),
+                    signers: [],
+                    computeUnits: UPDATE_PRICE_FEED_COMPUTE_BUDGET
+                });
+                priceFeedIdToPriceUpdateAccount["0x" + parsePriceFeedMessage(update.message).feedId.toString("hex")] = this.getPriceFeedAccountAddress(shardId, feedId);
+            }
+        }
+        return {
+            postInstructions,
+            priceFeedIdToPriceUpdateAccount,
+            closeInstructions
+        };
+    }
+    /**
+   * Build a series of helper instructions that post a VAA in an encoded VAA account. This function is bespoke for posting Pyth VAAs and might not work for other usecases.
+   *
+   * @param vaa a Wormhole VAA
+   * @returns `encodedVaaAddress`: the address of the encoded VAA account where the VAA will be posted
+   * @returns `postInstructions`: the instructions to post the VAA
+   * @returns `closeInstructions`: the instructions to close the encoded VAA account
+   */ async buildPostEncodedVaaInstructions(vaa) {
+        return buildPostEncodedVaaInstructions(this.wormhole, vaa);
+    }
+    /**
+   * Build an instruction to close an encoded VAA account, recovering the rent.
+   */ async buildCloseEncodedVaaInstruction(encodedVaa) {
+        return buildCloseEncodedVaaInstruction(this.wormhole, encodedVaa);
+    }
+    /**
+   * Build aset of instructions to close all the existing encoded VAA accounts owned by this PythSolanaReceiver's wallet
+   */ async buildClosePreviousEncodedVaasInstructions(maxInstructions) {
+        const encodedVaas = await this.findOwnedEncodedVaaAccounts();
+        const instructions = [];
+        for (const encodedVaa of encodedVaas){
+            instructions.push(await this.buildCloseEncodedVaaInstruction(encodedVaa));
+        }
+        return instructions.slice(0, maxInstructions);
+    }
+    /**
+   * Build an instruction to close a price update account, recovering the rent.
+   */ async buildClosePriceUpdateInstruction(priceUpdateAccount) {
+        const instruction = await this.receiver.methods.reclaimRent().accounts({
+            priceUpdateAccount
+        }).instruction();
+        return {
+            instruction,
+            signers: []
+        };
+    }
+    /**
+   * Returns a set of versioned transactions that contain the provided instructions in the same order and with efficient batching
+   */ async batchIntoVersionedTransactions(instructions, priorityFeeConfig, addressLookupTable) {
+        return TransactionBuilder.batchIntoVersionedTransactions(this.wallet.publicKey, this.connection, instructions, priorityFeeConfig, addressLookupTable);
+    }
+    /**
+   * Fetch the contents of a price update account
+   * @param priceUpdateAccount The address of the price update account
+   * @returns The contents of the deserialized price update account or `null` if the account doesn't exist
+   */ async fetchPriceUpdateAccount(priceUpdateAccount) {
+        return this.receiver.account.priceUpdateV2.fetchNullable(priceUpdateAccount);
+    }
+    /**
+   * Fetch the contents of a price feed account
+   * @param shardId The shard ID of the set of price feed accounts. This shard ID allows for multiple price feed accounts for the same price feed id to exist.
+   * @param priceFeedId The price feed ID, as either a 32-byte buffer or hexadecimal string with or without a leading "0x" prefix.
+   * @returns The contents of the deserialized price feed account or `null` if the account doesn't exist
+   */ async fetchPriceFeedAccount(shardId, priceFeedId) {
+        return this.receiver.account.priceUpdateV2.fetchNullable(this.getPriceFeedAccountAddress(shardId, priceFeedId));
+    }
+    /**
+   * Derive the address of a price feed account
+   * @param shardId The shard ID of the set of price feed accounts. This shard ID allows for multiple price feed accounts for the same price feed id to exist.
+   * @param priceFeedId The price feed ID, as either a 32-byte buffer or hexadecimal string with or without a leading "0x" prefix.
+   * @returns The address of the price feed account
+   */ getPriceFeedAccountAddress(shardId, priceFeedId) {
+        return getPriceFeedAccountForProgram(shardId, priceFeedId, this.pushOracle.programId);
+    }
+    /**
+   * Find all the encoded VAA accounts owned by this PythSolanaReceiver's wallet
+   * @returns a list of the public keys of the encoded VAA accounts
+   */ async findOwnedEncodedVaaAccounts() {
+        return await findEncodedVaaAccountsByWriteAuthority(this.receiver.provider.connection, this.wallet.publicKey, this.wormhole.programId);
+    }
+}
+/**
+ * Derive the address of a price feed account
+ * @param shardId The shard ID of the set of price feed accounts. This shard ID allows for multiple price feed accounts for the same price feed id to exist.
+ * @param priceFeedId The price feed ID, as either a 32-byte buffer or hexadecimal string with or without a leading "0x" prefix.
+ * @param pushOracleProgramId The program ID of the Pyth Push Oracle program. If not provided, the default deployment will be used.
+ * @returns The address of the price feed account
+ */ export function getPriceFeedAccountForProgram(shardId, priceFeedId, pushOracleProgramId) {
+    if (typeof priceFeedId == "string") {
+        priceFeedId = priceFeedId.startsWith("0x") ? IsomorphicBuffer.from(priceFeedId.slice(2), "hex") : IsomorphicBuffer.from(priceFeedId, "hex");
+    }
+    if (priceFeedId.length != 32) {
+        throw new Error("Feed ID should be 32 bytes long");
+    }
+    const shardBuffer = IsomorphicBuffer.alloc(2);
+    shardBuffer.writeUint16LE(shardId, 0);
+    return PublicKey.findProgramAddressSync([
+        shardBuffer,
+        priceFeedId
+    ], pushOracleProgramId ?? DEFAULT_PUSH_ORACLE_PROGRAM_ID)[0];
+}

package/dist/esm/address.d.ts

@@ -0,0 +1,29 @@
+import { PublicKey } from "@solana/web3.js";
+/**
+ * The default Pyth Solana Receiver program ID.
+ * The program is deployed at this address on all SVM networks.
+ */
+export declare const DEFAULT_RECEIVER_PROGRAM_ID: PublicKey;
+/**
+ * The default Wormhole program ID.
+ * The program is deployed at this address on all SVM networks.
+ */
+export declare const DEFAULT_WORMHOLE_PROGRAM_ID: PublicKey;
+export declare const DEFAULT_PUSH_ORACLE_PROGRAM_ID: PublicKey;
+/**
+ * Returns the address of a guardian set account from the Wormhole program.
+ */
+export declare const getGuardianSetPda: (guardianSetIndex: number, wormholeProgramId: PublicKey) => PublicKey;
+/**
+ * The Pyth Solana Receiver has one treasury account for each u8 `treasuryId`.
+ * This is meant to avoid write-locks on the treasury account by load-balancing the writes across multiple accounts.
+ */
+export declare function getRandomTreasuryId(): number;
+/**
+ * Returns the address of a treasury account from the Pyth Solana Receiver program.
+ */
+export declare const getTreasuryPda: (treasuryId: number, receiverProgramId: PublicKey) => PublicKey;
+/**
+ * Returns the address of the config account from the Pyth Solana Receiver program.
+ */
+export declare const getConfigPda: (receiverProgramId: PublicKey) => PublicKey;

package/dist/esm/address.mjs

@@ -0,0 +1,45 @@
+// eslint-disable-next-line unicorn/prefer-node-protocol
+import { Buffer as IsomorphicBuffer } from "buffer";
+import { PublicKey } from "@solana/web3.js";
+/**
+ * The default Pyth Solana Receiver program ID.
+ * The program is deployed at this address on all SVM networks.
+ */ export const DEFAULT_RECEIVER_PROGRAM_ID = new PublicKey("rec5EKMGg6MxZYaMdyBfgwp4d5rB9T1VQH5pJv5LtFJ");
+/**
+ * The default Wormhole program ID.
+ * The program is deployed at this address on all SVM networks.
+ */ export const DEFAULT_WORMHOLE_PROGRAM_ID = new PublicKey("HDwcJBJXjL9FpJ7UBsYBtaDjsBUhuLCUYoz3zr8SWWaQ");
+export const DEFAULT_PUSH_ORACLE_PROGRAM_ID = new PublicKey("pythWSnswVUd12oZpeFP8e9CVaEqJg25g1Vtc2biRsT");
+/**
+ * Returns the address of a guardian set account from the Wormhole program.
+ */ export const getGuardianSetPda = (guardianSetIndex, wormholeProgramId)=>{
+    const guardianSetIndexBuf = IsomorphicBuffer.alloc(4);
+    guardianSetIndexBuf.writeUInt32BE(guardianSetIndex, 0);
+    return PublicKey.findProgramAddressSync([
+        IsomorphicBuffer.from("GuardianSet"),
+        guardianSetIndexBuf
+    ], wormholeProgramId)[0];
+};
+/**
+ * The Pyth Solana Receiver has one treasury account for each u8 `treasuryId`.
+ * This is meant to avoid write-locks on the treasury account by load-balancing the writes across multiple accounts.
+ */ export function getRandomTreasuryId() {
+    return Math.floor(Math.random() * 256);
+}
+/**
+ * Returns the address of a treasury account from the Pyth Solana Receiver program.
+ */ export const getTreasuryPda = (treasuryId, receiverProgramId)=>{
+    return PublicKey.findProgramAddressSync([
+        IsomorphicBuffer.from("treasury"),
+        IsomorphicBuffer.from([
+            treasuryId
+        ])
+    ], receiverProgramId)[0];
+};
+/**
+ * Returns the address of the config account from the Pyth Solana Receiver program.
+ */ export const getConfigPda = (receiverProgramId)=>{
+    return PublicKey.findProgramAddressSync([
+        IsomorphicBuffer.from("config")
+    ], receiverProgramId)[0];
+};

package/dist/esm/compute_budget.d.ts

@@ -0,0 +1,28 @@
+/**
+ * A hard-coded budget for the compute units required for the `verifyEncodedVaa` instruction in the Wormhole program.
+ */
+export declare const VERIFY_ENCODED_VAA_COMPUTE_BUDGET = 350000;
+/**
+ * A hard-coded budget for the compute units required for the `postUpdateAtomic` instruction in the Pyth Solana Receiver program.
+ */
+export declare const POST_UPDATE_ATOMIC_COMPUTE_BUDGET = 170000;
+/**
+ * A hard-coded budget for the compute units required for the `postUpdate` instruction in the Pyth Solana Receiver program.
+ */
+export declare const POST_UPDATE_COMPUTE_BUDGET = 35000;
+/**
+ * A hard-coded budget for the compute units required for the `updatePriceFeed` instruction in the Pyth Push Oracle program.
+ */
+export declare const UPDATE_PRICE_FEED_COMPUTE_BUDGET = 55000;
+/**
+ * A hard-coded budget for the compute units required for the `initEncodedVaa` instruction in the Wormhole program.
+ */
+export declare const INIT_ENCODED_VAA_COMPUTE_BUDGET = 3000;
+/**
+ * A hard-coded budget for the compute units required for the `writeEncodedVaa` instruction in the Wormhole program.
+ */
+export declare const WRITE_ENCODED_VAA_COMPUTE_BUDGET = 3000;
+/**
+ * A hard-coded budget for the compute units required for the `closeEncodedVaa` instruction in the Wormhole program.
+ */
+export declare const CLOSE_ENCODED_VAA_COMPUTE_BUDGET = 30000;

package/dist/esm/compute_budget.mjs

@@ -0,0 +1,21 @@
+/**
+ * A hard-coded budget for the compute units required for the `verifyEncodedVaa` instruction in the Wormhole program.
+ */ export const VERIFY_ENCODED_VAA_COMPUTE_BUDGET = 350_000;
+/**
+ * A hard-coded budget for the compute units required for the `postUpdateAtomic` instruction in the Pyth Solana Receiver program.
+ */ export const POST_UPDATE_ATOMIC_COMPUTE_BUDGET = 170_000;
+/**
+ * A hard-coded budget for the compute units required for the `postUpdate` instruction in the Pyth Solana Receiver program.
+ */ export const POST_UPDATE_COMPUTE_BUDGET = 35_000;
+/**
+ * A hard-coded budget for the compute units required for the `updatePriceFeed` instruction in the Pyth Push Oracle program.
+ */ export const UPDATE_PRICE_FEED_COMPUTE_BUDGET = 55_000;
+/**
+ * A hard-coded budget for the compute units required for the `initEncodedVaa` instruction in the Wormhole program.
+ */ export const INIT_ENCODED_VAA_COMPUTE_BUDGET = 3000;
+/**
+ * A hard-coded budget for the compute units required for the `writeEncodedVaa` instruction in the Wormhole program.
+ */ export const WRITE_ENCODED_VAA_COMPUTE_BUDGET = 3000;
+/**
+ * A hard-coded budget for the compute units required for the `closeEncodedVaa` instruction in the Wormhole program.
+ */ export const CLOSE_ENCODED_VAA_COMPUTE_BUDGET = 30_000;