@layerzerolabs/lz-solana-sdk-v2 2.3.36 → 2.3.37

package/dist/index.d.mts

@@ -15981,13 +15981,22 @@ declare abstract class BaseOApp {
     getRemote(connection: Connection, dstEid: number, commitmentOrConfig?: web3$1.Commitment | web3$1.GetAccountInfoConfig): Promise<Uint8Array | null>;
 }
 
-declare function extractSentPacketEventByTxHash(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, commitment?: Finality | GetVersionedTransactionConfig, skipErr?: boolean): Promise<PacketSentEvent[] | null>;
-declare function extractVerifiedPacketEventByTxHash(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, commitment?: Finality | GetVersionedTransactionConfig, skipErr?: boolean): Promise<PacketVerifiedEvent[] | null>;
-declare function extractReceivedPacketEventByTxHash(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, commitment?: Finality | GetVersionedTransactionConfig, skipErr?: boolean): Promise<PacketDeliveredEvent[] | null>;
-declare function extractComposeSentEventByTxHash(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, commitment?: Finality | GetVersionedTransactionConfig, skipErr?: boolean): Promise<ComposeSentEvent[] | null>;
-declare function extractComposeDeliveredEventByTxHash(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, commitment?: Finality | GetVersionedTransactionConfig, skipErr?: boolean): Promise<ComposeDeliveredEvent[] | null>;
-declare function extractWorkerFeePaidEventByTxHash(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, commitment?: Finality | GetVersionedTransactionConfig, skipErr?: boolean): Promise<FeesPaidEvent[] | null>;
-declare function extractEventFromTransactionSignature<E>(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, eventBeet: beet.FixableBeetArgsStruct<E> | beet.BeetArgsStruct<E>, commitment?: Finality | GetVersionedTransactionConfig, skipErr?: boolean): Promise<E[] | null>;
+declare function extractSentPacketEventByTxHash(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, commitment?: Finality | GetVersionedTransactionConfig, unsafeParseErr?: boolean): Promise<PacketSentEvent[] | null>;
+declare function extractVerifiedPacketEventByTxHash(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, commitment?: Finality | GetVersionedTransactionConfig, unsafeParseErr?: boolean): Promise<PacketVerifiedEvent[] | null>;
+declare function extractReceivedPacketEventByTxHash(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, commitment?: Finality | GetVersionedTransactionConfig, unsafeParseErr?: boolean): Promise<PacketDeliveredEvent[] | null>;
+declare function extractComposeSentEventByTxHash(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, commitment?: Finality | GetVersionedTransactionConfig, unsafeParseErr?: boolean): Promise<ComposeSentEvent[] | null>;
+declare function extractComposeDeliveredEventByTxHash(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, commitment?: Finality | GetVersionedTransactionConfig, unsafeParseErr?: boolean): Promise<ComposeDeliveredEvent[] | null>;
+declare function extractWorkerFeePaidEventByTxHash(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, commitment?: Finality | GetVersionedTransactionConfig, unsafeParseErr?: boolean): Promise<FeesPaidEvent[] | null>;
+/**
+ * @param connection
+ * @param program extract event from specific program id
+ * @signature transaction signature(tx hash) or parsed transaction
+ * @eventBeet beet struct for event
+ * @commitment commitment level
+ * @unsafeParseErr Default is false, only parse event if transaction succeeded. if true, will parse event even if transaction failed. Please set this to false if you want to ignore failed transaction and set `true` with caution as it may lead to unexpected behavior.
+ * @returns array of events or null if no event found
+ */
+declare function extractEventFromTransactionSignature<E>(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, eventBeet: beet.FixableBeetArgsStruct<E> | beet.BeetArgsStruct<E>, commitment?: Finality | GetVersionedTransactionConfig, unsafeParseErr?: boolean): Promise<E[] | null>;
 declare function generateAddressLookupTable(connection: Connection, payer: PublicKey, authority: PublicKey, addresses: PublicKey[]): Promise<{
     instructions: TransactionInstruction[];
     address: PublicKey;

package/dist/index.d.ts

@@ -15981,13 +15981,22 @@ declare abstract class BaseOApp {
     getRemote(connection: Connection, dstEid: number, commitmentOrConfig?: web3$1.Commitment | web3$1.GetAccountInfoConfig): Promise<Uint8Array | null>;
 }
 
-declare function extractSentPacketEventByTxHash(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, commitment?: Finality | GetVersionedTransactionConfig, skipErr?: boolean): Promise<PacketSentEvent[] | null>;
-declare function extractVerifiedPacketEventByTxHash(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, commitment?: Finality | GetVersionedTransactionConfig, skipErr?: boolean): Promise<PacketVerifiedEvent[] | null>;
-declare function extractReceivedPacketEventByTxHash(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, commitment?: Finality | GetVersionedTransactionConfig, skipErr?: boolean): Promise<PacketDeliveredEvent[] | null>;
-declare function extractComposeSentEventByTxHash(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, commitment?: Finality | GetVersionedTransactionConfig, skipErr?: boolean): Promise<ComposeSentEvent[] | null>;
-declare function extractComposeDeliveredEventByTxHash(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, commitment?: Finality | GetVersionedTransactionConfig, skipErr?: boolean): Promise<ComposeDeliveredEvent[] | null>;
-declare function extractWorkerFeePaidEventByTxHash(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, commitment?: Finality | GetVersionedTransactionConfig, skipErr?: boolean): Promise<FeesPaidEvent[] | null>;
-declare function extractEventFromTransactionSignature<E>(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, eventBeet: beet.FixableBeetArgsStruct<E> | beet.BeetArgsStruct<E>, commitment?: Finality | GetVersionedTransactionConfig, skipErr?: boolean): Promise<E[] | null>;
+declare function extractSentPacketEventByTxHash(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, commitment?: Finality | GetVersionedTransactionConfig, unsafeParseErr?: boolean): Promise<PacketSentEvent[] | null>;
+declare function extractVerifiedPacketEventByTxHash(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, commitment?: Finality | GetVersionedTransactionConfig, unsafeParseErr?: boolean): Promise<PacketVerifiedEvent[] | null>;
+declare function extractReceivedPacketEventByTxHash(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, commitment?: Finality | GetVersionedTransactionConfig, unsafeParseErr?: boolean): Promise<PacketDeliveredEvent[] | null>;
+declare function extractComposeSentEventByTxHash(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, commitment?: Finality | GetVersionedTransactionConfig, unsafeParseErr?: boolean): Promise<ComposeSentEvent[] | null>;
+declare function extractComposeDeliveredEventByTxHash(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, commitment?: Finality | GetVersionedTransactionConfig, unsafeParseErr?: boolean): Promise<ComposeDeliveredEvent[] | null>;
+declare function extractWorkerFeePaidEventByTxHash(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, commitment?: Finality | GetVersionedTransactionConfig, unsafeParseErr?: boolean): Promise<FeesPaidEvent[] | null>;
+/**
+ * @param connection
+ * @param program extract event from specific program id
+ * @signature transaction signature(tx hash) or parsed transaction
+ * @eventBeet beet struct for event
+ * @commitment commitment level
+ * @unsafeParseErr Default is false, only parse event if transaction succeeded. if true, will parse event even if transaction failed. Please set this to false if you want to ignore failed transaction and set `true` with caution as it may lead to unexpected behavior.
+ * @returns array of events or null if no event found
+ */
+declare function extractEventFromTransactionSignature<E>(connection: Connection, program: PublicKey, signature: TransactionSignature | Awaited<ReturnType<typeof connection.getParsedTransaction>>, eventBeet: beet.FixableBeetArgsStruct<E> | beet.BeetArgsStruct<E>, commitment?: Finality | GetVersionedTransactionConfig, unsafeParseErr?: boolean): Promise<E[] | null>;
 declare function generateAddressLookupTable(connection: Connection, payer: PublicKey, authority: PublicKey, addresses: PublicKey[]): Promise<{
     instructions: TransactionInstruction[];
     address: PublicKey;

package/dist/index.mjs

@@ -14987,91 +14987,90 @@ function getEventDiscriminator(event) {
   const sha2562 = hash.digest("hex");
   return sha2562.slice(0, 16);
 }
-async function extractSentPacketEventByTxHash(connection, program, signature, commitment, skipErr = false) {
+async function extractSentPacketEventByTxHash(connection, program, signature, commitment, unsafeParseErr = false) {
   const events = await extractEventFromTransactionSignature(
     connection,
     program,
     signature,
     packetSentEventBeet,
     commitment,
-    skipErr
+    unsafeParseErr
   );
   if (!events)
     return null;
   return events;
 }
-async function extractVerifiedPacketEventByTxHash(connection, program, signature, commitment, skipErr = false) {
+async function extractVerifiedPacketEventByTxHash(connection, program, signature, commitment, unsafeParseErr = false) {
   const events = await extractEventFromTransactionSignature(
     connection,
     program,
     signature,
     packetVerifiedEventBeet,
     commitment,
-    skipErr
+    unsafeParseErr
   );
   if (!events)
     return null;
   return events;
 }
-async function extractReceivedPacketEventByTxHash(connection, program, signature, commitment, skipErr = false) {
+async function extractReceivedPacketEventByTxHash(connection, program, signature, commitment, unsafeParseErr = false) {
   const events = await extractEventFromTransactionSignature(
     connection,
     program,
     signature,
     packetDeliveredEventBeet,
     commitment,
-    skipErr
+    unsafeParseErr
   );
   if (!events)
     return null;
   return events;
 }
-async function extractComposeSentEventByTxHash(connection, program, signature, commitment, skipErr = false) {
+async function extractComposeSentEventByTxHash(connection, program, signature, commitment, unsafeParseErr = false) {
   const events = await extractEventFromTransactionSignature(
     connection,
     program,
     signature,
     composeSentEventBeet,
     commitment,
-    skipErr
+    unsafeParseErr
   );
   if (!events)
     return null;
   return events;
 }
-async function extractComposeDeliveredEventByTxHash(connection, program, signature, commitment, skipErr = false) {
+async function extractComposeDeliveredEventByTxHash(connection, program, signature, commitment, unsafeParseErr = false) {
   const events = await extractEventFromTransactionSignature(
     connection,
     program,
     signature,
     composeDeliveredEventBeet,
     commitment,
-    skipErr
+    unsafeParseErr
   );
   if (!events)
     return null;
   return events;
 }
-async function extractWorkerFeePaidEventByTxHash(connection, program, signature, commitment, skipErr = false) {
+async function extractWorkerFeePaidEventByTxHash(connection, program, signature, commitment, unsafeParseErr = false) {
   const events = await extractEventFromTransactionSignature(
     connection,
     program,
     signature,
     feesPaidEventBeet,
     commitment,
-    skipErr
+    unsafeParseErr
   );
   if (!events)
     return null;
   return events;
 }
-async function extractEventFromTransactionSignature(connection, program, signature, eventBeet, commitment, skipErr = false) {
+async function extractEventFromTransactionSignature(connection, program, signature, eventBeet, commitment, unsafeParseErr = false) {
   const tx = typeof signature === "string" ? await connection.getParsedTransaction(signature, commitment) : signature;
   if (tx == null)
     return null;
   const events = new Array();
-  const err = tx.meta?.err ?? null;
-  if (err !== null && !skipErr) {
+  if (tx.meta?.err !== null && !unsafeParseErr) {
     return null;
   }
   for (const instruction of tx.meta?.innerInstructions ?? []) {