@pythnetwork/pyth-solana-receiver 0.8.2 → 0.9.0

package/README.md

@@ -65,6 +65,7 @@ Instantiate it with a Solana web3 `Connection` and anchor `Wallet`:
 import { PythSolanaReceiver } from "@pythnetwork/pyth-solana-receiver";
 import { Connection, Keypair, PublicKey } from "@solana/web3.js";
 import { Wallet } from "@coral-xyz/anchor";
+import { sendTransactions } from "@pythnetwork/solana-utils";
 
 const connection = new Connection("https://api.mainnet-beta.solana.com");
 const wallet = new Wallet(
@@ -101,10 +102,15 @@ await transactionBuilder.addPriceConsumerInstructions(
 
 // Send the instructions in the builder in 1 or more transactions.
 // The builder will pack the instructions into transactions automatically.
-await pythSolanaReceiver.provider.sendAll(
+// We use some custom transaction dispatch logic instead of the simple `provider.sendAll` to increase landing rate,
+// feel free to use your own optimized logic.
+sendTransactions(
   await transactionBuilder.buildVersionedTransactions({
     computeUnitPriceMicroLamports: 100000,
-  })
+    tightComputeBudget: true,
+  }),
+  pythSolanaReceiver.connection,
+  pythSolanaReceiver.wallet
 );
 ```
 
@@ -137,10 +143,15 @@ await transactionBuilder.addPriceConsumerInstructions(
 
 // Send the instructions in the builder in 1 or more transactions.
 // The builder will pack the instructions into transactions automatically.
-await pythSolanaReceiver.provider.sendAll(
+// We use some custom transaction dispatch logic instead of the simple `provider.sendAll` to increase landing rate,
+// feel free to use your own optimized logic.
+sendTransactions(
   await transactionBuilder.buildVersionedTransactions({
     computeUnitPriceMicroLamports: 100000,
-  })
+    tightComputeBudget: true,
+  }),
+  pythSolanaReceiver.connection,
+  pythSolanaReceiver.wallet
 );
 ```
 
@@ -164,6 +175,50 @@ Price updates are relatively large and can take multiple transactions to post on
 You can reduce the size of the transaction payload by using `addPostPartiallyVerifiedPriceUpdates` instead of `addPostPriceUpdates`.
 This method does sacrifice some security however -- please see the method documentation for more details.
 
+### Post a TWAP price update
+
+TWAP price updates are calculated using a pair of verifiable cumulative price updates per price feed (the "start" and "end" updates for the given time window), and then performing an averaging calculation on-chain to create the time-weighted average price.
+
+The flow of using, verifying, posting, and consuming these prices is the same as standard price updates. Get the binary update data from Hermes or Benchmarks, post and verify the VAAs via the Wormhole contract, and verify the updates against the VAAs via Pyth receiver contract. After this, you can consume the calculated TWAP posted to the TwapUpdate account. You can also optionally close these ephemeral accounts after the TWAP has been consumed to save on rent.
+
+```typescript
+// Fetch the binary TWAP data from hermes or benchmarks. See Preliminaries section above for more info.
+const binaryDataArray = ["UE5BV...khz609", "UE5BV...BAg8i6"];
+
+// Pass `closeUpdateAccounts: true` to automatically close the TWAP update accounts
+// after they're consumed
+const transactionBuilder = pythSolanaReceiver.newTransactionBuilder({
+  closeUpdateAccounts: false,
+});
+
+// Post the updates and calculate the TWAP
+await transactionBuilder.addPostTwapUpdates(binaryDataArray);
+
+// You can now use the TWAP prices in subsequent instructions
+await transactionBuilder.addTwapConsumerInstructions(
+  async (
+    getTwapUpdateAccount: (priceFeedId: string) => PublicKey
+  ): Promise<InstructionWithEphemeralSigners[]> => {
+    // Generate instructions here that use the TWAP updates posted above.
+    // getTwapUpdateAccount(<price feed id>) will give you the account for each TWAP update.
+    return [];
+  }
+);
+
+// Send the instructions in the builder in 1 or more transactions.
+// The builder will pack the instructions into transactions automatically.
+sendTransactions(
+  await transactionBuilder.buildVersionedTransactions({
+    computeUnitPriceMicroLamports: 100000,
+    tightComputeBudget: true,
+  }),
+  pythSolanaReceiver.connection,
+  pythSolanaReceiver.wallet
+);
+```
+
+See `examples/post_twap_update.ts` for a runnable example of posting a TWAP price update.
+
 ### Get Instructions
 
 The `PythTransactionBuilder` class used in the examples above helps craft transactions that update prices and then use them in successive instructions.
@@ -178,7 +233,7 @@ First, install and build any necessary typescript dependencies:
 
 1. Clone the `pyth-crosschain` git repo
 2. Run `pnpm i` in the root of the repo
-3. Run `pnpm exec lerna run build` anywhere in the repo
+3. Run `pnpm turbo build` anywhere in the repo
 4. From the `pyth_solana_receiver` directory, run `pnpm exec ts-node examples/<example filename>.ts`
 
 The examples require a Solana keypair with SOL to send Solana transactions.

package/lib/PythSolanaReceiver.d.ts

@@ -8,6 +8,7 @@ import { Wallet } from "@coral-xyz/anchor";
 import { TransactionBuilder, InstructionWithEphemeralSigners, PriorityFeeConfig } from "@pythnetwork/solana-utils";
 import { PythPushOracle } from "./idl/pyth_push_oracle";
 export type PriceUpdateAccount = IdlAccounts<PythSolanaReceiverProgram>["priceUpdateV2"];
+export type TwapUpdateAccount = IdlAccounts<PythSolanaReceiverProgram>["twapUpdate"];
 /**
  * Configuration for the PythTransactionBuilder
  * @property closeUpdateAccounts (default: true) if true, the builder will add instructions to close the price update accounts and the encoded vaa accounts to recover the rent
@@ -42,13 +43,14 @@ export type PythTransactionBuilderConfig = {
  * 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}))
+ * await pythSolanaReceiver.provider.sendAll(await transactionBuilder.buildVersionedTransactions({computeUnitPriceMicroLamports:100000, tightComputeBudget: true}))
  * ```
  */
 export declare class PythTransactionBuilder extends TransactionBuilder {
     readonly pythSolanaReceiver: PythSolanaReceiver;
     readonly closeInstructions: InstructionWithEphemeralSigners[];
     readonly priceFeedIdToPriceUpdateAccount: Record<string, PublicKey>;
+    readonly priceFeedIdToTwapUpdateAccount: Record<string, PublicKey>;
     readonly closeUpdateAccounts: boolean;
     constructor(pythSolanaReceiver: PythSolanaReceiver, config: PythTransactionBuilderConfig, addressLookupTable?: AddressLookupTableAccount);
     /**
@@ -97,6 +99,27 @@ export declare class PythTransactionBuilder extends TransactionBuilder {
      * ```
      */
     addPostPartiallyVerifiedPriceUpdates(priceUpdateDataArray: string[]): Promise<void>;
+    /**
+     * Add instructions to post TWAP updates to the builder.
+     * Use this function to post fully verified TWAP updates from the present or from the past for your program to consume.
+     *
+     * @param twapUpdateDataArray the output of the `@pythnetwork/hermes-client`'s `getLatestTwaps`. 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 twapUpdateData = await hermesClient.getLatestTwaps([
+     *    SOL_PRICE_FEED_ID,
+     *    ETH_PRICE_FEED_ID,
+     * ]);
+     *
+     * const transactionBuilder = pythSolanaReceiver.newTransactionBuilder({});
+     * await transactionBuilder.addPostTwapUpdates(priceUpdateData);
+     * console.log("The SOL/USD price update will get posted to:", transactionBuilder.getTwapUpdateAccount(SOL_PRICE_FEED_ID).toBase58())
+     * await transactionBuilder.addTwapConsumerInstructions(...)
+     * ```
+     */
+    addPostTwapUpdates(twapUpdateDataArray: string[]): Promise<void>;
     /**
      * 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.
@@ -150,6 +173,37 @@ export declare class PythTransactionBuilder extends TransactionBuilder {
      * ```
      */
     addPriceConsumerInstructions(getInstructions: (getPriceUpdateAccount: (priceFeedId: string) => PublicKey) => Promise<InstructionWithEphemeralSigners[]>): Promise<void>;
+    /**
+     * Add instructions that consume TWAP updates to the builder.
+     *
+     * @param getInstructions a function that given a mapping of price feed IDs to TWAP update accounts, generates a series of instructions. TWAP 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 TWAP 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.addPostTwapUpdates(twapUpdateData);
+     * await transactionBuilder.addTwapConsumerInstructions(
+     *   async (
+     *     getTwapUpdateAccount: ( priceFeedId: string) => PublicKey
+     *   ): Promise<InstructionWithEphemeralSigners[]> => {
+     *     return [
+     *       {
+     *         instruction: await myFirstPythApp.methods
+     *           .consume()
+     *           .accounts({
+     *              solTwapUpdate: getTwapUpdateAccount(SOL_PRICE_FEED_ID),
+     *              ethTwapUpdate: getTwapUpdateAccount(ETH_PRICE_FEED_ID),
+     *           })
+     *           .instruction(),
+     *         signers: [],
+     *       },
+     *     ];
+     *   }
+     * );
+     * ```
+     */
+    addTwapConsumerInstructions(getInstructions: (getTwapUpdateAccount: (priceFeedId: string) => PublicKey) => Promise<InstructionWithEphemeralSigners[]>): Promise<void>;
     /** 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.
@@ -174,6 +228,11 @@ export declare class PythTransactionBuilder extends TransactionBuilder {
      * 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: string): PublicKey;
+    /**
+     * This method is used to retrieve the address of the TWAP update account where the TWAP update for a given price feed ID will be posted.
+     * If multiple 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.
+     * */
+    getTwapUpdateAccount(priceFeedId: string): PublicKey;
 }
 /**
  * A class to interact with the Pyth Solana Receiver program.
@@ -216,19 +275,6 @@ export declare class PythSolanaReceiver {
         priceFeedIdToPriceUpdateAccount: Record<string, PublicKey>;
         closeInstructions: InstructionWithEphemeralSigners[];
     }>;
-    /**
-     * 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 `postInstructions`: the instructions to post the VAA
-     * @returns `encodedVaaAddress`: the address of the encoded VAA account where the VAA will be posted
-     * @returns `closeInstructions`: the instructions to close the encoded VAA account
-     */
-    buildPostEncodedVaaInstructions(vaa: Buffer): Promise<{
-        postInstructions: InstructionWithEphemeralSigners[];
-        encodedVaaAddress: PublicKey;
-        closeInstructions: InstructionWithEphemeralSigners[];
-    }>;
     /**
      * 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.
      *
@@ -242,6 +288,19 @@ export declare class PythSolanaReceiver {
         priceFeedIdToPriceUpdateAccount: Record<string, PublicKey>;
         closeInstructions: InstructionWithEphemeralSigners[];
     }>;
+    /**
+     * Build a series of helper instructions that post TWAP updates to the Pyth Solana Receiver program and another series to close the encoded vaa accounts and the TWAP update accounts.
+     *
+     * @param twapUpdateDataArray the output of the `@pythnetwork/price-service-client`'s `PriceServiceConnection.getLatestTwaps`. This is an array of verifiable price updates.
+     * @returns `postInstructions`: the instructions to post the TWAP updates, these should be called before consuming the price updates
+     * @returns `priceFeedIdToTwapUpdateAccount`: 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 TWAP update.
+     * @returns `closeInstructions`: the instructions to close the TWAP update accounts, these should be called after consuming the TWAP updates
+     */
+    buildPostTwapUpdateInstructions(twapUpdateDataArray: string[]): Promise<{
+        postInstructions: InstructionWithEphemeralSigners[];
+        priceFeedIdToTwapUpdateAccount: Record<string, PublicKey>;
+        closeInstructions: InstructionWithEphemeralSigners[];
+    }>;
     /**
      * 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.
      *
@@ -256,6 +315,19 @@ export declare class PythSolanaReceiver {
         priceFeedIdToPriceUpdateAccount: Record<string, PublicKey>;
         closeInstructions: InstructionWithEphemeralSigners[];
     }>;
+    /**
+     * 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
+     */
+    buildPostEncodedVaaInstructions(vaa: Buffer): Promise<{
+        encodedVaaAddress: PublicKey;
+        postInstructions: InstructionWithEphemeralSigners[];
+        closeInstructions: InstructionWithEphemeralSigners[];
+    }>;
     /**
      * Build an instruction to close an encoded VAA account, recovering the rent.
      */
@@ -268,6 +340,10 @@ export declare class PythSolanaReceiver {
      * Build an instruction to close a price update account, recovering the rent.
      */
     buildClosePriceUpdateInstruction(priceUpdateAccount: PublicKey): Promise<InstructionWithEphemeralSigners>;
+    /**
+     * Build an instruction to close a TWAP update account, recovering the rent.
+     */
+    buildCloseTwapUpdateInstruction(twapUpdateAccount: PublicKey): Promise<InstructionWithEphemeralSigners>;
     /**
      * Returns a set of versioned transactions that contain the provided instructions in the same order and with efficient batching
      */

package/lib/PythSolanaReceiver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PythSolanaReceiver.d.ts","sourceRoot":"","sources":["../src/PythSolanaReceiver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PythSolanaReceiver.d.ts","sourceRoot":"","sources":["../src/PythSolanaReceiver.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EACL,yBAAyB,EACzB,UAAU,EACV,MAAM,EACN,WAAW,EACX,oBAAoB,EACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,kBAAkB,IAAI,yBAAyB,EAEhD,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,wBAAwB,EAEzB,MAAM,mCAAmC,CAAC;AAU3C,OAAO,EAAE,SAAS,EAAW,MAAM,iBAAiB,CAAC;AAYrD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAS3C,OAAO,EACL,kBAAkB,EAClB,+BAA+B,EAC/B,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,cAAc,EAEf,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,kBAAkB,GAC5B,WAAW,CAAC,yBAAyB,CAAC,CAAC,eAAe,CAAC,CAAC;AAC1D,MAAM,MAAM,iBAAiB,GAC3B,WAAW,CAAC,yBAAyB,CAAC,CAAC,YAAY,CAAC,CAAC;AACvD;;;GAGG;AACH,MAAM,MAAM,4BAA4B,GAAG;IACzC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,sBAAuB,SAAQ,kBAAkB;IAC5D,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAChD,QAAQ,CAAC,iBAAiB,EAAE,+BAA+B,EAAE,CAAC;IAC9D,QAAQ,CAAC,+BAA+B,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACpE,QAAQ,CAAC,8BAA8B,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACnE,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;gBAGpC,kBAAkB,EAAE,kBAAkB,EACtC,MAAM,EAAE,4BAA4B,EACpC,kBAAkB,CAAC,EAAE,yBAAyB;IAchD;;;;;;;;;;;;;;;;;;;OAmBG;IACG,mBAAmB,CAAC,oBAAoB,EAAE,MAAM,EAAE;IAgBxD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,oCAAoC,CAAC,oBAAoB,EAAE,MAAM,EAAE;IAgBzE;;;;;;;;;;;;;;;;;;;OAmBG;IACG,kBAAkB,CAAC,mBAAmB,EAAE,MAAM,EAAE;IAgBtD;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,kBAAkB,CAAC,oBAAoB,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM;IAiBxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,4BAA4B,CAChC,eAAe,EAAE,CACf,qBAAqB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,SAAS,KACtD,OAAO,CAAC,+BAA+B,EAAE,CAAC;IAOjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,2BAA2B,CAC/B,eAAe,EAAE,CACf,oBAAoB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,SAAS,KACrD,OAAO,CAAC,+BAA+B,EAAE,CAAC;IAOjD;;;OAGG;IACG,uCAAuC,CAAC,eAAe,SAAK;IAQlE;;OAEG;IACG,0BAA0B,CAC9B,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC;QAAE,EAAE,EAAE,oBAAoB,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IAO7D;;OAEG;IACH,uBAAuB,CACrB,IAAI,EAAE,iBAAiB,GACtB;QAAE,EAAE,EAAE,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE;IAO3C;;;SAGK;IACL,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS;IAWrD;;;SAGK;IACL,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS;CASrD;AAED;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAC7B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACrD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;gBAEjC,EACV,UAAU,EACV,MAAM,EACN,iBAA+C,EAC/C,iBAA+C,EAC/C,mBAAoD,GACrD,EAAE;QACD,UAAU,EAAE,UAAU,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,iBAAiB,CAAC,EAAE,SAAS,CAAC;QAC9B,iBAAiB,CAAC,EAAE,SAAS,CAAC;QAC9B,mBAAmB,CAAC,EAAE,SAAS,CAAC;KACjC;IAuBD;;OAEG;IACH,qBAAqB,CACnB,MAAM,EAAE,4BAA4B,GACnC,sBAAsB;IAIzB;;;;;;;;;;OAUG;IACG,sCAAsC,CAC1C,oBAAoB,EAAE,MAAM,EAAE,GAC7B,OAAO,CAAC;QACT,gBAAgB,EAAE,+BAA+B,EAAE,CAAC;QACpD,+BAA+B,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC3D,iBAAiB,EAAE,+BAA+B,EAAE,CAAC;KACtD,CAAC;IAsDF;;;;;;;OAOG;IACG,gCAAgC,CACpC,oBAAoB,EAAE,MAAM,EAAE,GAC7B,OAAO,CAAC;QACT,gBAAgB,EAAE,+BAA+B,EAAE,CAAC;QACpD,+BAA+B,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC3D,iBAAiB,EAAE,+BAA+B,EAAE,CAAC;KACtD,CAAC;IAyDF;;;;;;;OAOG;IACG,+BAA+B,CACnC,mBAAmB,EAAE,MAAM,EAAE,GAC5B,OAAO,CAAC;QACT,gBAAgB,EAAE,+BAA+B,EAAE,CAAC;QACpD,8BAA8B,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC1D,iBAAiB,EAAE,+BAA+B,EAAE,CAAC;KACtD,CAAC;IA8EF;;;;;;;;OAQG;IACG,gCAAgC,CACpC,oBAAoB,EAAE,MAAM,EAAE,EAC9B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QACT,gBAAgB,EAAE,+BAA+B,EAAE,CAAC;QACpD,+BAA+B,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC3D,iBAAiB,EAAE,+BAA+B,EAAE,CAAC;KACtD,CAAC;IA2DF;;;;;;;OAOG;IACG,+BAA+B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAC1D,iBAAiB,EAAE,SAAS,CAAC;QAC7B,gBAAgB,EAAE,+BAA+B,EAAE,CAAC;QACpD,iBAAiB,EAAE,+BAA+B,EAAE,CAAC;KACtD,CAAC;IAIF;;OAEG;IACG,+BAA+B,CACnC,UAAU,EAAE,SAAS,GACpB,OAAO,CAAC,+BAA+B,CAAC;IAI3C;;OAEG;IACG,yCAAyC,CAC7C,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,+BAA+B,EAAE,CAAC;IAS7C;;OAEG;IACG,gCAAgC,CACpC,kBAAkB,EAAE,SAAS,GAC5B,OAAO,CAAC,+BAA+B,CAAC;IAQ3C;;OAEG;IACG,+BAA+B,CACnC,iBAAiB,EAAE,SAAS,GAC3B,OAAO,CAAC,+BAA+B,CAAC;IAQ3C;;OAEG;IACG,8BAA8B,CAClC,YAAY,EAAE,+BAA+B,EAAE,EAC/C,iBAAiB,EAAE,iBAAiB,EACpC,kBAAkB,CAAC,EAAE,yBAAyB,GAC7C,OAAO,CAAC;QAAE,EAAE,EAAE,oBAAoB,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IAU7D;;;;OAIG;IACG,uBAAuB,CAC3B,kBAAkB,EAAE,SAAS,GAC5B,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAMrC;;;;;OAKG;IACG,qBAAqB,CACzB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAMrC;;;;;OAKG;IACH,0BAA0B,CACxB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,SAAS;IAQZ;;;OAGG;IACG,2BAA2B;CAOlC;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAAG,MAAM,EAC5B,mBAAmB,CAAC,EAAE,SAAS,GAC9B,SAAS,CAmBX"}

package/lib/PythSolanaReceiver.js

@@ -38,19 +38,21 @@ const pyth_push_oracle_1 = require("./idl/pyth_push_oracle");
  * 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}))
+ * await pythSolanaReceiver.provider.sendAll(await transactionBuilder.buildVersionedTransactions({computeUnitPriceMicroLamports:100000, tightComputeBudget: true}))
  * ```
  */
 class PythTransactionBuilder extends solana_utils_1.TransactionBuilder {
     pythSolanaReceiver;
     closeInstructions;
     priceFeedIdToPriceUpdateAccount;
+    priceFeedIdToTwapUpdateAccount;
     closeUpdateAccounts;
     constructor(pythSolanaReceiver, config, addressLookupTable) {
         super(pythSolanaReceiver.wallet.publicKey, pythSolanaReceiver.connection, addressLookupTable);
         this.pythSolanaReceiver = pythSolanaReceiver;
         this.closeInstructions = [];
         this.priceFeedIdToPriceUpdateAccount = {};
+        this.priceFeedIdToTwapUpdateAccount = {};
         this.closeUpdateAccounts = config.closeUpdateAccounts ?? true;
     }
     /**
@@ -109,6 +111,32 @@ class PythTransactionBuilder extends solana_utils_1.TransactionBuilder {
         Object.assign(this.priceFeedIdToPriceUpdateAccount, priceFeedIdToPriceUpdateAccount);
         this.addInstructions(postInstructions);
     }
+    /**
+     * Add instructions to post TWAP updates to the builder.
+     * Use this function to post fully verified TWAP updates from the present or from the past for your program to consume.
+     *
+     * @param twapUpdateDataArray the output of the `@pythnetwork/hermes-client`'s `getLatestTwaps`. 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 twapUpdateData = await hermesClient.getLatestTwaps([
+     *    SOL_PRICE_FEED_ID,
+     *    ETH_PRICE_FEED_ID,
+     * ]);
+     *
+     * const transactionBuilder = pythSolanaReceiver.newTransactionBuilder({});
+     * await transactionBuilder.addPostTwapUpdates(priceUpdateData);
+     * console.log("The SOL/USD price update will get posted to:", transactionBuilder.getTwapUpdateAccount(SOL_PRICE_FEED_ID).toBase58())
+     * await transactionBuilder.addTwapConsumerInstructions(...)
+     * ```
+     */
+    async addPostTwapUpdates(twapUpdateDataArray) {
+        const { postInstructions, priceFeedIdToTwapUpdateAccount, closeInstructions, } = await this.pythSolanaReceiver.buildPostTwapUpdateInstructions(twapUpdateDataArray);
+        this.closeInstructions.push(...closeInstructions);
+        Object.assign(this.priceFeedIdToTwapUpdateAccount, priceFeedIdToTwapUpdateAccount);
+        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.
@@ -169,6 +197,39 @@ class PythTransactionBuilder extends solana_utils_1.TransactionBuilder {
     async addPriceConsumerInstructions(getInstructions) {
         this.addInstructions(await getInstructions(this.getPriceUpdateAccount.bind(this)));
     }
+    /**
+     * Add instructions that consume TWAP updates to the builder.
+     *
+     * @param getInstructions a function that given a mapping of price feed IDs to TWAP update accounts, generates a series of instructions. TWAP 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 TWAP 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.addPostTwapUpdates(twapUpdateData);
+     * await transactionBuilder.addTwapConsumerInstructions(
+     *   async (
+     *     getTwapUpdateAccount: ( priceFeedId: string) => PublicKey
+     *   ): Promise<InstructionWithEphemeralSigners[]> => {
+     *     return [
+     *       {
+     *         instruction: await myFirstPythApp.methods
+     *           .consume()
+     *           .accounts({
+     *              solTwapUpdate: getTwapUpdateAccount(SOL_PRICE_FEED_ID),
+     *              ethTwapUpdate: getTwapUpdateAccount(ETH_PRICE_FEED_ID),
+     *           })
+     *           .instruction(),
+     *         signers: [],
+     *       },
+     *     ];
+     *   }
+     * );
+     * ```
+     */
+    async addTwapConsumerInstructions(getInstructions) {
+        this.addInstructions(await getInstructions(this.getTwapUpdateAccount.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.
@@ -205,6 +266,17 @@ class PythTransactionBuilder extends solana_utils_1.TransactionBuilder {
         }
         return priceUpdateAccount;
     }
+    /**
+     * This method is used to retrieve the address of the TWAP update account where the TWAP update for a given price feed ID will be posted.
+     * If multiple 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.
+     * */
+    getTwapUpdateAccount(priceFeedId) {
+        const twapUpdateAccount = this.priceFeedIdToTwapUpdateAccount[priceFeedId];
+        if (!twapUpdateAccount) {
+            throw new Error(`No TWAP update account found for the price feed ID ${priceFeedId}. Make sure to call addPostTwapUpdates before calling this function.`);
+        }
+        return twapUpdateAccount;
+    }
 }
 exports.PythTransactionBuilder = PythTransactionBuilder;
 /**
@@ -286,50 +358,6 @@ class PythSolanaReceiver {
             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 `postInstructions`: the instructions to post the VAA
-     * @returns `encodedVaaAddress`: the address of the encoded VAA account where the VAA will be posted
-     * @returns `closeInstructions`: the instructions to close the encoded VAA account
-     */
-    async buildPostEncodedVaaInstructions(vaa) {
-        const trimmedVaa = (0, vaa_1.trimSignatures)(vaa, 13);
-        const postInstructions = [];
-        const closeInstructions = [];
-        const encodedVaaKeypair = new web3_js_1.Keypair();
-        const guardianSetIndex = (0, vaa_1.getGuardianSetIndex)(trimmedVaa);
-        postInstructions.push(await (0, vaa_1.buildEncodedVaaCreateInstruction)(this.wormhole, trimmedVaa, encodedVaaKeypair));
-        postInstructions.push({
-            instruction: await this.wormhole.methods
-                .initEncodedVaa()
-                .accounts({
-                encodedVaa: encodedVaaKeypair.publicKey,
-            })
-                .instruction(),
-            signers: [],
-            computeUnits: compute_budget_1.INIT_ENCODED_VAA_COMPUTE_BUDGET,
-        });
-        postInstructions.push(...(await (0, vaa_1.buildWriteEncodedVaaWithSplitInstructions)(this.wormhole, trimmedVaa, encodedVaaKeypair.publicKey)));
-        postInstructions.push({
-            instruction: await this.wormhole.methods
-                .verifyEncodedVaaV1()
-                .accounts({
-                guardianSet: (0, address_1.getGuardianSetPda)(guardianSetIndex, this.wormhole.programId),
-                draftVaa: encodedVaaKeypair.publicKey,
-            })
-                .instruction(),
-            signers: [],
-            computeUnits: compute_budget_1.VERIFY_ENCODED_VAA_COMPUTE_BUDGET,
-        });
-        closeInstructions.push(await this.buildCloseEncodedVaaInstruction(encodedVaaKeypair.publicKey));
-        return {
-            postInstructions,
-            encodedVaaAddress: encodedVaaKeypair.publicKey,
-            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.
      *
@@ -376,6 +404,63 @@ class PythSolanaReceiver {
             closeInstructions,
         };
     }
+    /**
+     * Build a series of helper instructions that post TWAP updates to the Pyth Solana Receiver program and another series to close the encoded vaa accounts and the TWAP update accounts.
+     *
+     * @param twapUpdateDataArray the output of the `@pythnetwork/price-service-client`'s `PriceServiceConnection.getLatestTwaps`. This is an array of verifiable price updates.
+     * @returns `postInstructions`: the instructions to post the TWAP updates, these should be called before consuming the price updates
+     * @returns `priceFeedIdToTwapUpdateAccount`: 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 TWAP update.
+     * @returns `closeInstructions`: the instructions to close the TWAP update accounts, these should be called after consuming the TWAP updates
+     */
+    async buildPostTwapUpdateInstructions(twapUpdateDataArray) {
+        const postInstructions = [];
+        const priceFeedIdToTwapUpdateAccount = {};
+        const closeInstructions = [];
+        const treasuryId = (0, address_1.getRandomTreasuryId)();
+        if (twapUpdateDataArray.length !== 2) {
+            throw new Error("twapUpdateDataArray must contain exactly two updates (start and end)");
+        }
+        const [startUpdateData, endUpdateData] = twapUpdateDataArray.map((data) => (0, price_service_sdk_1.parseAccumulatorUpdateData)(Buffer.from(data, "base64")));
+        // Validate that the start and end updates contain the same number of price feeds
+        if (startUpdateData.updates.length !== endUpdateData.updates.length) {
+            throw new Error("Start and end updates must contain the same number of price feeds");
+        }
+        // Post encoded VAAs
+        const { postInstructions: buildVaasInstructions, closeInstructions: closeVaasInstructions, startEncodedVaaAddress, endEncodedVaaAddress, } = await (0, vaa_1.buildPostEncodedVaasForTwapInstructions)(this.wormhole, startUpdateData, endUpdateData);
+        postInstructions.push(...buildVaasInstructions);
+        closeInstructions.push(...closeVaasInstructions);
+        // Post a TWAP update to the receiver contract for each price feed
+        for (let i = 0; i < startUpdateData.updates.length; i++) {
+            const startUpdate = startUpdateData.updates[i];
+            const endUpdate = endUpdateData.updates[i];
+            const twapUpdateKeypair = new web3_js_1.Keypair();
+            postInstructions.push({
+                instruction: await this.receiver.methods
+                    .postTwapUpdate({
+                    startMerklePriceUpdate: startUpdate,
+                    endMerklePriceUpdate: endUpdate,
+                    treasuryId,
+                })
+                    .accounts({
+                    startEncodedVaa: startEncodedVaaAddress,
+                    endEncodedVaa: endEncodedVaaAddress,
+                    twapUpdateAccount: twapUpdateKeypair.publicKey,
+                    treasury: (0, address_1.getTreasuryPda)(treasuryId, this.receiver.programId),
+                    config: (0, address_1.getConfigPda)(this.receiver.programId),
+                })
+                    .instruction(),
+                signers: [twapUpdateKeypair],
+                computeUnits: compute_budget_1.POST_TWAP_UPDATE_COMPUTE_BUDGET,
+            });
+            priceFeedIdToTwapUpdateAccount["0x" + (0, price_service_sdk_1.parseTwapMessage)(startUpdate.message).feedId.toString("hex")] = twapUpdateKeypair.publicKey;
+            closeInstructions.push(await this.buildCloseTwapUpdateInstruction(twapUpdateKeypair.publicKey));
+        }
+        return {
+            postInstructions,
+            priceFeedIdToTwapUpdateAccount,
+            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.
      *
@@ -423,19 +508,22 @@ class PythSolanaReceiver {
             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 (0, vaa_1.buildPostEncodedVaaInstructions)(this.wormhole, vaa);
+    }
     /**
      * Build an instruction to close an encoded VAA account, recovering the rent.
      */
     async buildCloseEncodedVaaInstruction(encodedVaa) {
-        const instruction = await this.wormhole.methods
-            .closeEncodedVaa()
-            .accounts({ encodedVaa })
-            .instruction();
-        return {
-            instruction,
-            signers: [],
-            computeUnits: compute_budget_1.CLOSE_ENCODED_VAA_COMPUTE_BUDGET,
-        };
+        return (0, vaa_1.buildCloseEncodedVaaInstruction)(this.wormhole, encodedVaa);
     }
     /**
      * Build aset of instructions to close all the existing encoded VAA accounts owned by this PythSolanaReceiver's wallet
@@ -458,6 +546,16 @@ class PythSolanaReceiver {
             .instruction();
         return { instruction, signers: [] };
     }
+    /**
+     * Build an instruction to close a TWAP update account, recovering the rent.
+     */
+    async buildCloseTwapUpdateInstruction(twapUpdateAccount) {
+        const instruction = await this.receiver.methods
+            .reclaimTwapRent()
+            .accounts({ twapUpdateAccount })
+            .instruction();
+        return { instruction, signers: [] };
+    }
     /**
      * Returns a set of versioned transactions that contain the provided instructions in the same order and with efficient batching
      */

package/lib/compute_budget.d.ts

@@ -10,6 +10,10 @@ 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 `postTwapUpdate` instruction in the Pyth Solana Receiver program.
+ */
+export declare const POST_TWAP_UPDATE_COMPUTE_BUDGET = 50000;
 /**
  * A hard-coded budget for the compute units required for the `updatePriceFeed` instruction in the Pyth Push Oracle program.
  */

package/lib/compute_budget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compute_budget.d.ts","sourceRoot":"","sources":["../src/compute_budget.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,iCAAiC,SAAS,CAAC;AACxD;;GAEG;AACH,eAAO,MAAM,iCAAiC,SAAS,CAAC;AACxD;;GAEG;AACH,eAAO,MAAM,0BAA0B,QAAQ,CAAC;AAChD;;GAEG;AACH,eAAO,MAAM,gCAAgC,QAAQ,CAAC;AACtD;;GAEG;AACH,eAAO,MAAM,+BAA+B,OAAO,CAAC;AACpD;;GAEG;AACH,eAAO,MAAM,gCAAgC,OAAO,CAAC;AACrD;;GAEG;AACH,eAAO,MAAM,gCAAgC,QAAQ,CAAC"}
+{"version":3,"file":"compute_budget.d.ts","sourceRoot":"","sources":["../src/compute_budget.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,iCAAiC,SAAS,CAAC;AACxD;;GAEG;AACH,eAAO,MAAM,iCAAiC,SAAS,CAAC;AACxD;;GAEG;AACH,eAAO,MAAM,0BAA0B,QAAQ,CAAC;AAChD;;GAEG;AACH,eAAO,MAAM,+BAA+B,QAAS,CAAC;AACtD;;GAEG;AACH,eAAO,MAAM,gCAAgC,QAAQ,CAAC;AACtD;;GAEG;AACH,eAAO,MAAM,+BAA+B,OAAO,CAAC;AACpD;;GAEG;AACH,eAAO,MAAM,gCAAgC,OAAO,CAAC;AACrD;;GAEG;AACH,eAAO,MAAM,gCAAgC,QAAQ,CAAC"}

package/lib/compute_budget.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CLOSE_ENCODED_VAA_COMPUTE_BUDGET = exports.WRITE_ENCODED_VAA_COMPUTE_BUDGET = exports.INIT_ENCODED_VAA_COMPUTE_BUDGET = exports.UPDATE_PRICE_FEED_COMPUTE_BUDGET = exports.POST_UPDATE_COMPUTE_BUDGET = exports.POST_UPDATE_ATOMIC_COMPUTE_BUDGET = exports.VERIFY_ENCODED_VAA_COMPUTE_BUDGET = void 0;
+exports.CLOSE_ENCODED_VAA_COMPUTE_BUDGET = exports.WRITE_ENCODED_VAA_COMPUTE_BUDGET = exports.INIT_ENCODED_VAA_COMPUTE_BUDGET = exports.UPDATE_PRICE_FEED_COMPUTE_BUDGET = exports.POST_TWAP_UPDATE_COMPUTE_BUDGET = exports.POST_UPDATE_COMPUTE_BUDGET = exports.POST_UPDATE_ATOMIC_COMPUTE_BUDGET = exports.VERIFY_ENCODED_VAA_COMPUTE_BUDGET = void 0;
 /**
  * A hard-coded budget for the compute units required for the `verifyEncodedVaa` instruction in the Wormhole program.
  */
@@ -13,6 +13,10 @@ exports.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.
  */
 exports.POST_UPDATE_COMPUTE_BUDGET = 35000;
+/**
+ * A hard-coded budget for the compute units required for the `postTwapUpdate` instruction in the Pyth Solana Receiver program.
+ */
+exports.POST_TWAP_UPDATE_COMPUTE_BUDGET = 50_000;
 /**
  * A hard-coded budget for the compute units required for the `updatePriceFeed` instruction in the Pyth Push Oracle program.
  */