@bitgo/wasm-solana 2.5.0 → 2.6.0

package/dist/cjs/js/index.d.ts

@@ -3,53 +3,16 @@ export * as pubkey from "./pubkey.js";
 export * as transaction from "./transaction.js";
 export * as parser from "./parser.js";
 export * as builder from "./builder.js";
-export * as explain from "./explain.js";
 export { Keypair } from "./keypair.js";
 export { Pubkey } from "./pubkey.js";
 export { Transaction } from "./transaction.js";
 export { VersionedTransaction, isVersionedTransaction } from "./versioned.js";
 export type { AddressLookupTableData } from "./versioned.js";
-export { parseTransactionData } from "./parser.js";
+export { parseTransaction } from "./parser.js";
 export { buildFromVersionedData } from "./builder.js";
 export { buildFromIntent, buildFromIntent as buildTransactionFromIntent } from "./intentBuilder.js";
-export { explainTransaction, TransactionType } from "./explain.js";
-import { Transaction as _Transaction } from "./transaction.js";
-/**
- * Parse a Solana transaction from raw bytes.
- *
- * Returns a `Transaction` instance that can be both inspected and signed.
- * Use `.parse()` on the returned Transaction to get decoded instruction data.
- *
- * This is the single entry point for working with transactions — like
- * `BitGoPsbt.fromBytes()` in wasm-utxo.
- *
- * @param bytes - Raw transaction bytes
- * @returns A Transaction that can be inspected (`.parse()`) and signed (`.addSignature()`)
- *
- * @example
- * ```typescript
- * import { parseTransaction } from '@bitgo/wasm-solana';
- *
- * const tx = parseTransaction(txBytes);
- *
- * // Inspect
- * const parsed = tx.parse();
- * console.log(parsed.feePayer);
- * for (const instr of parsed.instructionsData) {
- *   if (instr.type === 'Transfer') {
- *     console.log(`${instr.amount} lamports to ${instr.toAddress}`);
- *   }
- * }
- *
- * // Sign
- * tx.addSignature(pubkey, signature);
- * const signedBytes = tx.toBytes();
- * ```
- */
-export declare function parseTransaction(bytes: Uint8Array): _Transaction;
 export type { BaseIntent, PaymentIntent, StakeIntent, UnstakeIntent, ClaimIntent, DeactivateIntent, DelegateIntent, EnableTokenIntent, CloseAtaIntent, ConsolidateIntent, AuthorizeIntent, CustomTxIntent, CustomTxInstruction, CustomTxKey, SolanaIntent, StakePoolConfig, BuildFromIntentParams, BuildFromIntentResult, GeneratedKeypair, NonceSource, BlockhashNonce, DurableNonce, } from "./intentBuilder.js";
 export { system_program_id as systemProgramId, stake_program_id as stakeProgramId, compute_budget_program_id as computeBudgetProgramId, memo_program_id as memoProgramId, token_program_id as tokenProgramId, token_2022_program_id as token2022ProgramId, ata_program_id as ataProgramId, stake_pool_program_id as stakePoolProgramId, stake_account_space as stakeAccountSpace, nonce_account_space as nonceAccountSpace, sysvar_recent_blockhashes as sysvarRecentBlockhashes, get_associated_token_address as getAssociatedTokenAddress, find_withdraw_authority_program_address as findWithdrawAuthorityProgramAddress, } from "./wasm/wasm_solana.js";
 export type { AccountMeta, Instruction } from "./transaction.js";
 export type { ParsedTransaction, DurableNonce as ParsedDurableNonce, InstructionParams, TransferParams, CreateAccountParams, NonceAdvanceParams, CreateNonceAccountParams, NonceInitializeParams, StakeInitializeParams, StakingActivateParams, StakingDeactivateParams, StakingWithdrawParams, StakingDelegateParams, StakingAuthorizeParams, SetComputeUnitLimitParams, SetPriorityFeeParams, TokenTransferParams, CreateAtaParams, CloseAtaParams, MemoParams, StakePoolDepositSolParams, StakePoolWithdrawStakeParams, UnknownInstructionParams, } from "./parser.js";
-export type { ExplainedTransaction, ExplainedOutput, ExplainedInput, ExplainOptions, TokenEnablement, StakingAuthorizeInfo, } from "./explain.js";
 export type { AddressLookupTable as BuilderAddressLookupTable, RawVersionedTransactionData, VersionedInstruction as BuilderVersionedInstruction, MessageHeader, } from "./builder.js";

package/dist/cjs/js/index.js

@@ -33,8 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.findWithdrawAuthorityProgramAddress = exports.getAssociatedTokenAddress = exports.sysvarRecentBlockhashes = exports.nonceAccountSpace = exports.stakeAccountSpace = exports.stakePoolProgramId = exports.ataProgramId = exports.token2022ProgramId = exports.tokenProgramId = exports.memoProgramId = exports.computeBudgetProgramId = exports.stakeProgramId = exports.systemProgramId = exports.TransactionType = exports.explainTransaction = exports.buildTransactionFromIntent = exports.buildFromIntent = exports.buildFromVersionedData = exports.parseTransactionData = exports.isVersionedTransaction = exports.VersionedTransaction = exports.Transaction = exports.Pubkey = exports.Keypair = exports.explain = exports.builder = exports.parser = exports.transaction = exports.pubkey = exports.keypair = void 0;
-exports.parseTransaction = parseTransaction;
+exports.findWithdrawAuthorityProgramAddress = exports.getAssociatedTokenAddress = exports.sysvarRecentBlockhashes = exports.nonceAccountSpace = exports.stakeAccountSpace = exports.stakePoolProgramId = exports.ataProgramId = exports.token2022ProgramId = exports.tokenProgramId = exports.memoProgramId = exports.computeBudgetProgramId = exports.stakeProgramId = exports.systemProgramId = exports.buildTransactionFromIntent = exports.buildFromIntent = exports.buildFromVersionedData = exports.parseTransaction = exports.isVersionedTransaction = exports.VersionedTransaction = exports.Transaction = exports.Pubkey = exports.Keypair = exports.builder = exports.parser = exports.transaction = exports.pubkey = exports.keypair = void 0;
 const wasm = __importStar(require("./wasm/wasm_solana.js"));
 // Force webpack to include the WASM module
 void wasm;
@@ -44,7 +43,6 @@ exports.pubkey = __importStar(require("./pubkey.js"));
 exports.transaction = __importStar(require("./transaction.js"));
 exports.parser = __importStar(require("./parser.js"));
 exports.builder = __importStar(require("./builder.js"));
-exports.explain = __importStar(require("./explain.js"));
 // Top-level class exports for convenience
 var keypair_js_1 = require("./keypair.js");
 Object.defineProperty(exports, "Keypair", { enumerable: true, get: function () { return keypair_js_1.Keypair; } });
@@ -58,52 +56,12 @@ Object.defineProperty(exports, "VersionedTransaction", { enumerable: true, get:
 Object.defineProperty(exports, "isVersionedTransaction", { enumerable: true, get: function () { return versioned_js_1.isVersionedTransaction; } });
 // Top-level function exports
 var parser_js_1 = require("./parser.js");
-Object.defineProperty(exports, "parseTransactionData", { enumerable: true, get: function () { return parser_js_1.parseTransactionData; } });
+Object.defineProperty(exports, "parseTransaction", { enumerable: true, get: function () { return parser_js_1.parseTransaction; } });
 var builder_js_1 = require("./builder.js");
 Object.defineProperty(exports, "buildFromVersionedData", { enumerable: true, get: function () { return builder_js_1.buildFromVersionedData; } });
 var intentBuilder_js_1 = require("./intentBuilder.js");
 Object.defineProperty(exports, "buildFromIntent", { enumerable: true, get: function () { return intentBuilder_js_1.buildFromIntent; } });
 Object.defineProperty(exports, "buildTransactionFromIntent", { enumerable: true, get: function () { return intentBuilder_js_1.buildFromIntent; } });
-var explain_js_1 = require("./explain.js");
-Object.defineProperty(exports, "explainTransaction", { enumerable: true, get: function () { return explain_js_1.explainTransaction; } });
-Object.defineProperty(exports, "TransactionType", { enumerable: true, get: function () { return explain_js_1.TransactionType; } });
-// Re-export Transaction import for parseTransaction
-const transaction_js_2 = require("./transaction.js");
-/**
- * Parse a Solana transaction from raw bytes.
- *
- * Returns a `Transaction` instance that can be both inspected and signed.
- * Use `.parse()` on the returned Transaction to get decoded instruction data.
- *
- * This is the single entry point for working with transactions — like
- * `BitGoPsbt.fromBytes()` in wasm-utxo.
- *
- * @param bytes - Raw transaction bytes
- * @returns A Transaction that can be inspected (`.parse()`) and signed (`.addSignature()`)
- *
- * @example
- * ```typescript
- * import { parseTransaction } from '@bitgo/wasm-solana';
- *
- * const tx = parseTransaction(txBytes);
- *
- * // Inspect
- * const parsed = tx.parse();
- * console.log(parsed.feePayer);
- * for (const instr of parsed.instructionsData) {
- *   if (instr.type === 'Transfer') {
- *     console.log(`${instr.amount} lamports to ${instr.toAddress}`);
- *   }
- * }
- *
- * // Sign
- * tx.addSignature(pubkey, signature);
- * const signedBytes = tx.toBytes();
- * ```
- */
-function parseTransaction(bytes) {
-    return transaction_js_2.Transaction.fromBytes(bytes);
-}
 // Program ID constants (from WASM)
 var wasm_solana_js_1 = require("./wasm/wasm_solana.js");
 Object.defineProperty(exports, "systemProgramId", { enumerable: true, get: function () { return wasm_solana_js_1.system_program_id; } });

package/dist/cjs/js/parser.d.ts

@@ -1,11 +1,12 @@
 /**
  * High-level transaction parsing.
  *
- * Provides types and functions for parsing Solana transactions into semantic data
- * matching BitGoJS's TxData format.
+ * Provides types and functions for parsing Solana transactions into
+ * semantic data matching BitGoJS's TxData format.
  *
  * All monetary amounts (amount, fee, lamports, poolTokens) are returned as bigint.
  */
+import type { Transaction } from "./transaction.js";
 /** SOL transfer parameters */
 export interface TransferParams {
     type: "Transfer";
@@ -207,13 +208,22 @@ export interface ParsedTransaction {
     signatures: string[];
 }
 /**
- * Parse raw transaction bytes into a plain data object with decoded instructions.
+ * Parse a Transaction into a plain data object with decoded instructions.
  *
- * This is the low-level parsing function. Most callers should use the top-level
- * `parseTransaction(bytes)` which returns a `Transaction` instance with both
- * inspection (`.parse()`) and signing (`.addSignature()`) capabilities.
+ * This is the main parsing function that returns structured data with all
+ * instructions decoded into semantic types (Transfer, StakingActivate, etc.)
+ * with amounts as bigint.
  *
- * @param bytes - Raw transaction bytes
+ * Accepts a `Transaction` object (from `Transaction.fromBytes()`), avoiding
+ * double deserialization.
+ *
+ * @param tx - A Transaction instance (from Transaction.fromBytes())
  * @returns A ParsedTransaction with all instructions decoded
+ *
+ * @example
+ * ```typescript
+ * const tx = Transaction.fromBytes(txBytes);
+ * const parsed = parseTransaction(tx);
+ * ```
  */
-export declare function parseTransactionData(bytes: Uint8Array): ParsedTransaction;
+export declare function parseTransaction(tx: Transaction): ParsedTransaction;

package/dist/cjs/js/parser.js

@@ -2,27 +2,36 @@
 /**
  * High-level transaction parsing.
  *
- * Provides types and functions for parsing Solana transactions into semantic data
- * matching BitGoJS's TxData format.
+ * Provides types and functions for parsing Solana transactions into
+ * semantic data matching BitGoJS's TxData format.
  *
  * All monetary amounts (amount, fee, lamports, poolTokens) are returned as bigint.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseTransactionData = parseTransactionData;
+exports.parseTransaction = parseTransaction;
 const wasm_solana_js_1 = require("./wasm/wasm_solana.js");
 // =============================================================================
-// parseTransactionData function
+// parseTransaction function
 // =============================================================================
 /**
- * Parse raw transaction bytes into a plain data object with decoded instructions.
+ * Parse a Transaction into a plain data object with decoded instructions.
  *
- * This is the low-level parsing function. Most callers should use the top-level
- * `parseTransaction(bytes)` which returns a `Transaction` instance with both
- * inspection (`.parse()`) and signing (`.addSignature()`) capabilities.
+ * This is the main parsing function that returns structured data with all
+ * instructions decoded into semantic types (Transfer, StakingActivate, etc.)
+ * with amounts as bigint.
  *
- * @param bytes - Raw transaction bytes
+ * Accepts a `Transaction` object (from `Transaction.fromBytes()`), avoiding
+ * double deserialization.
+ *
+ * @param tx - A Transaction instance (from Transaction.fromBytes())
  * @returns A ParsedTransaction with all instructions decoded
+ *
+ * @example
+ * ```typescript
+ * const tx = Transaction.fromBytes(txBytes);
+ * const parsed = parseTransaction(tx);
+ * ```
  */
-function parseTransactionData(bytes) {
-    return wasm_solana_js_1.ParserNamespace.parse_transaction(bytes);
+function parseTransaction(tx) {
+    return wasm_solana_js_1.ParserNamespace.parse_from_transaction(tx.wasm);
 }

package/dist/cjs/js/transaction.d.ts

@@ -1,7 +1,6 @@
 import { WasmTransaction } from "./wasm/wasm_solana.js";
 import { Keypair } from "./keypair.js";
 import { Pubkey } from "./pubkey.js";
-import type { ParsedTransaction } from "./parser.js";
 /**
  * Account metadata for an instruction
  */
@@ -25,20 +24,19 @@ export interface Instruction {
     data: Uint8Array;
 }
 /**
- * Solana Transaction — the single object for inspecting and signing transactions.
+ * Solana Transaction — deserialization wrapper for signing and serialization.
  *
- * Use `parseTransaction(bytes)` to create an instance. The returned Transaction
- * can be both inspected (`.parse()` for decoded instructions) and signed
- * (`.addSignature()`, `.signablePayload()`, `.toBytes()`).
+ * Use `Transaction.fromBytes(bytes)` to create an instance for signing.
+ * Use `parseTransaction(tx)` from parser.ts to get decoded instruction data.
  *
  * @example
  * ```typescript
- * import { parseTransaction } from '@bitgo/wasm-solana';
+ * import { Transaction, parseTransaction } from '@bitgo/wasm-solana';
  *
- * const tx = parseTransaction(txBytes);
+ * const tx = Transaction.fromBytes(txBytes);
  *
- * // Inspect decoded instructions
- * const parsed = tx.parse();
+ * // Parse for decoded instructions
+ * const parsed = parseTransaction(tx);
  * for (const instr of parsed.instructionsData) {
  *   if (instr.type === 'Transfer') {
  *     console.log(`${instr.amount} lamports to ${instr.toAddress}`);
@@ -184,23 +182,6 @@ export declare class Transaction {
      * @param keypair - A Keypair instance
      */
     signWithKeypair(keypair: Keypair): void;
-    /**
-     * Parse the transaction into decoded instruction data.
-     *
-     * Returns structured data with all instructions decoded into semantic types
-     * (Transfer, StakeActivate, TokenTransfer, etc.) with amounts as bigint.
-     *
-     * @returns A ParsedTransaction with decoded instructions, feePayer, nonce, etc.
-     *
-     * @example
-     * ```typescript
-     * const tx = parseTransaction(txBytes);
-     * const parsed = tx.parse();
-     * console.log(parsed.feePayer);
-     * console.log(parsed.instructionsData); // Decoded instruction types
-     * ```
-     */
-    parse(): ParsedTransaction;
     /**
      * Get the underlying WASM instance (internal use only)
      * @internal

package/dist/cjs/js/transaction.js

@@ -3,22 +3,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Transaction = void 0;
 const wasm_solana_js_1 = require("./wasm/wasm_solana.js");
 const pubkey_js_1 = require("./pubkey.js");
-const parser_js_1 = require("./parser.js");
 /**
- * Solana Transaction — the single object for inspecting and signing transactions.
+ * Solana Transaction — deserialization wrapper for signing and serialization.
  *
- * Use `parseTransaction(bytes)` to create an instance. The returned Transaction
- * can be both inspected (`.parse()` for decoded instructions) and signed
- * (`.addSignature()`, `.signablePayload()`, `.toBytes()`).
+ * Use `Transaction.fromBytes(bytes)` to create an instance for signing.
+ * Use `parseTransaction(tx)` from parser.ts to get decoded instruction data.
  *
  * @example
  * ```typescript
- * import { parseTransaction } from '@bitgo/wasm-solana';
+ * import { Transaction, parseTransaction } from '@bitgo/wasm-solana';
  *
- * const tx = parseTransaction(txBytes);
+ * const tx = Transaction.fromBytes(txBytes);
  *
- * // Inspect decoded instructions
- * const parsed = tx.parse();
+ * // Parse for decoded instructions
+ * const parsed = parseTransaction(tx);
  * for (const instr of parsed.instructionsData) {
  *   if (instr.type === 'Transfer') {
  *     console.log(`${instr.amount} lamports to ${instr.toAddress}`);
@@ -206,25 +204,6 @@ class Transaction {
     signWithKeypair(keypair) {
         this._wasm.sign_with_keypair(keypair.wasm);
     }
-    /**
-     * Parse the transaction into decoded instruction data.
-     *
-     * Returns structured data with all instructions decoded into semantic types
-     * (Transfer, StakeActivate, TokenTransfer, etc.) with amounts as bigint.
-     *
-     * @returns A ParsedTransaction with decoded instructions, feePayer, nonce, etc.
-     *
-     * @example
-     * ```typescript
-     * const tx = parseTransaction(txBytes);
-     * const parsed = tx.parse();
-     * console.log(parsed.feePayer);
-     * console.log(parsed.instructionsData); // Decoded instruction types
-     * ```
-     */
-    parse() {
-        return (0, parser_js_1.parseTransactionData)(this._wasm.to_bytes());
-    }
     /**
      * Get the underlying WASM instance (internal use only)
      * @internal

package/dist/cjs/js/wasm/wasm_solana.d.ts

@@ -411,6 +411,17 @@ export class ParserNamespace {
    * @returns A ParsedTransaction object
    */
   static parse_transaction(bytes: Uint8Array): any;
+  /**
+   * Parse a pre-deserialized Transaction into structured data.
+   *
+   * Same as `parse_transaction(bytes)` but accepts an already-deserialized
+   * WasmTransaction, avoiding double deserialization when the caller already
+   * has a Transaction from `fromBytes()`.
+   *
+   * @param tx - A WasmTransaction instance
+   * @returns A ParsedTransaction object
+   */
+  static parse_from_transaction(tx: WasmTransaction): any;
 }
 
 export class Pedersen {

package/dist/cjs/js/wasm/wasm_solana.js

@@ -2871,6 +2871,34 @@ class ParserNamespace {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Parse a pre-deserialized Transaction into structured data.
+     *
+     * Same as `parse_transaction(bytes)` but accepts an already-deserialized
+     * WasmTransaction, avoiding double deserialization when the caller already
+     * has a Transaction from `fromBytes()`.
+     *
+     * @param tx - A WasmTransaction instance
+     * @returns A ParsedTransaction object
+     * @param {WasmTransaction} tx
+     * @returns {any}
+     */
+    static parse_from_transaction(tx) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            _assertClass(tx, WasmTransaction);
+            wasm.parsernamespace_parse_from_transaction(retptr, tx.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
 }
 if (Symbol.dispose) ParserNamespace.prototype[Symbol.dispose] = ParserNamespace.prototype.free;
 exports.ParserNamespace = ParserNamespace;

package/dist/cjs/js/wasm/wasm_solana_bg.wasm.d.ts

@@ -15,11 +15,17 @@ export const sysvar_recent_blockhashes: (a: number) => void;
 export const token_2022_program_id: (a: number) => void;
 export const token_program_id: (a: number) => void;
 export const __wbg_parsernamespace_free: (a: number, b: number) => void;
+export const parsernamespace_parse_from_transaction: (a: number, b: number) => void;
+export const parsernamespace_parse_transaction: (a: number, b: number, c: number) => void;
+export const __wbg_intentnamespace_free: (a: number, b: number) => void;
+export const intentnamespace_build_from_intent: (a: number, b: number, c: number) => void;
+export const __wbg_buildernamespace_free: (a: number, b: number) => void;
+export const buildernamespace_build_from_versioned_data: (a: number, b: number) => void;
 export const __wbg_wasmkeypair_free: (a: number, b: number) => void;
+export const __wbg_wasmpubkey_free: (a: number, b: number) => void;
 export const __wbg_wasmtransaction_free: (a: number, b: number) => void;
 export const __wbg_wasmversionedtransaction_free: (a: number, b: number) => void;
 export const is_versioned_transaction: (a: number, b: number) => number;
-export const parsernamespace_parse_transaction: (a: number, b: number, c: number) => void;
 export const wasmkeypair_address: (a: number, b: number) => void;
 export const wasmkeypair_from_secret_key: (a: number, b: number, c: number) => void;
 export const wasmkeypair_from_solana_secret_key: (a: number, b: number, c: number) => void;
@@ -27,6 +33,12 @@ export const wasmkeypair_generate: () => number;
 export const wasmkeypair_public_key: (a: number) => number;
 export const wasmkeypair_secret_key: (a: number) => number;
 export const wasmkeypair_sign: (a: number, b: number, c: number) => number;
+export const wasmpubkey_equals: (a: number, b: number) => number;
+export const wasmpubkey_from_base58: (a: number, b: number, c: number) => void;
+export const wasmpubkey_from_bytes: (a: number, b: number, c: number) => void;
+export const wasmpubkey_is_on_curve: (a: number) => number;
+export const wasmpubkey_to_base58: (a: number, b: number) => void;
+export const wasmpubkey_to_bytes: (a: number) => number;
 export const wasmtransaction_account_keys: (a: number) => number;
 export const wasmtransaction_add_signature: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const wasmtransaction_fee_payer: (a: number, b: number) => void;
@@ -56,17 +68,6 @@ export const wasmversionedtransaction_signer_index: (a: number, b: number, c: nu
 export const wasmversionedtransaction_static_account_keys: (a: number) => number;
 export const wasmversionedtransaction_to_bytes: (a: number, b: number) => void;
 export const wasmversionedtransaction_num_signatures: (a: number) => number;
-export const __wbg_buildernamespace_free: (a: number, b: number) => void;
-export const __wbg_intentnamespace_free: (a: number, b: number) => void;
-export const buildernamespace_build_from_versioned_data: (a: number, b: number) => void;
-export const intentnamespace_build_from_intent: (a: number, b: number, c: number) => void;
-export const __wbg_wasmpubkey_free: (a: number, b: number) => void;
-export const wasmpubkey_equals: (a: number, b: number) => number;
-export const wasmpubkey_from_base58: (a: number, b: number, c: number) => void;
-export const wasmpubkey_from_bytes: (a: number, b: number, c: number) => void;
-export const wasmpubkey_is_on_curve: (a: number) => number;
-export const wasmpubkey_to_base58: (a: number, b: number) => void;
-export const wasmpubkey_to_bytes: (a: number) => number;
 export const __wbg_keypair_free: (a: number, b: number) => void;
 export const keypair_constructor: () => number;
 export const keypair_fromBytes: (a: number, b: number, c: number) => void;