feat(wasm-solana): add fromVersionedData() for raw MessageV0 building

Adds VersionedTransaction.fromVersionedData() to build versioned transactions
from raw MessageV0 data. This supports the fromVersionedTransactionData() path
where we have pre-compiled versioned data (indexes + ALT refs).

The method is on VersionedTransaction class since it builds MessageV0 format
which requires WasmVersionedTransaction internally.

Author: lcovar

packages/wasm-solana/bitgo-wasm-solana-0.0.1.tgz

@@ -506,3 +506,87 @@ export interface TransactionIntent {
 export function buildTransaction(intent: TransactionIntent): Uint8Array {
   return BuilderNamespace.build_transaction(intent);
 }
+
+// =============================================================================
+// Raw Versioned Transaction Data Types (for fromVersionedTransactionData path)
+// =============================================================================
+
+/**
+ * A pre-compiled versioned instruction (uses indexes, not pubkeys).
+ * This is the format used in MessageV0 transactions.
+ */
+export interface VersionedInstruction {
+  /** Index into the account keys array for the program ID */
+  programIdIndex: number;
+  /** Indexes into the account keys array for instruction accounts */
+  accountKeyIndexes: number[];
+  /** Instruction data (base58 encoded) */
+  data: string;
+}
+
+/**
+ * Message header for versioned transactions.
+ * Describes the structure of the account keys array.
+ */
+export interface MessageHeader {
+  /** Number of required signatures */
+  numRequiredSignatures: number;
+  /** Number of readonly signed accounts */
+  numReadonlySignedAccounts: number;
+  /** Number of readonly unsigned accounts */
+  numReadonlyUnsignedAccounts: number;
+}
+
+/**
+ * Raw versioned transaction data for direct serialization.
+ * This is used when we have pre-formed MessageV0 data that just needs to be serialized.
+ * No instruction compilation is needed - just serialize the raw structure.
+ */
+export interface RawVersionedTransactionData {
+  /** Static account keys (base58 encoded public keys) */
+  staticAccountKeys: string[];
+  /** Address lookup tables */
+  addressLookupTables: AddressLookupTable[];
+  /** Pre-compiled instructions with index-based account references */
+  versionedInstructions: VersionedInstruction[];
+  /** Message header */
+  messageHeader: MessageHeader;
+  /** Recent blockhash (base58) */
+  recentBlockhash: string;
+}
+
+/**
+ * Build a versioned transaction directly from raw MessageV0 data.
+ *
+ * This function is used for the `fromVersionedTransactionData()` path where we already
+ * have pre-compiled versioned data (indexes + ALT refs). No instruction compilation
+ * is needed - we just serialize the raw structure to bytes.
+ *
+ * @param data - Raw versioned transaction data
+ * @returns Serialized unsigned versioned transaction bytes (Uint8Array)
+ * @throws Error if the data is invalid
+ *
+ * @example
+ * ```typescript
+ * import { buildFromVersionedData } from '@bitgo/wasm-solana';
+ *
+ * const txBytes = buildFromVersionedData({
+ *   staticAccountKeys: ['pubkey1', 'pubkey2', ...],
+ *   addressLookupTables: [
+ *     { accountKey: 'altPubkey', writableIndexes: [0, 1], readonlyIndexes: [2] }
+ *   ],
+ *   versionedInstructions: [
+ *     { programIdIndex: 0, accountKeyIndexes: [1, 2], data: 'base58EncodedData' }
+ *   ],
+ *   messageHeader: {
+ *     numRequiredSignatures: 1,
+ *     numReadonlySignedAccounts: 0,
+ *     numReadonlyUnsignedAccounts: 3
+ *   },
+ *   recentBlockhash: 'blockhash'
+ * });
+ * ```
+ */
+export function buildFromVersionedData(data: RawVersionedTransactionData): Uint8Array {
+  return BuilderNamespace.build_from_versioned_data(data);
+}

packages/wasm-solana/js/builder.ts

@@ -21,7 +21,7 @@ export type { AddressLookupTableData } from "./versioned.js";
 
 // Top-level function exports
 export { parseTransaction } from "./parser.js";
-export { buildTransaction } from "./builder.js";
+export { buildTransaction, buildFromVersionedData } from "./builder.js";
 
 // Program ID constants (from WASM)
 export {
@@ -35,6 +35,8 @@ export {
   stake_pool_program_id as stakePoolProgramId,
   stake_account_space as stakeAccountSpace,
   nonce_account_space as nonceAccountSpace,
+  // Sysvar addresses
+  sysvar_recent_blockhashes as sysvarRecentBlockhashes,
   // PDA derivation functions (eliminates @solana/web3.js dependency)
   get_associated_token_address as getAssociatedTokenAddress,
   find_withdraw_authority_program_address as findWithdrawAuthorityProgramAddress,
@@ -104,4 +106,8 @@ export type {
   // Custom Instruction
   CustomInstruction as BuilderCustomInstruction,
   CustomAccountMeta,
+  // Raw Versioned Transaction Data (for fromVersionedTransactionData path)
+  RawVersionedTransactionData,
+  VersionedInstruction as BuilderVersionedInstruction,
+  MessageHeader,
 } from "./builder.js";

packages/wasm-solana/js/index.ts

@@ -6,7 +6,12 @@
  * transaction size by referencing accounts via lookup table indices.
  */
 
-import { WasmVersionedTransaction, is_versioned_transaction } from "./wasm/wasm_solana.js";
+import {
+  WasmVersionedTransaction,
+  is_versioned_transaction,
+  BuilderNamespace,
+} from "./wasm/wasm_solana.js";
+import type { RawVersionedTransactionData } from "./builder.js";
 
 /**
  * Address Lookup Table data extracted from versioned transactions.
@@ -85,6 +90,42 @@ export class VersionedTransaction {
     return VersionedTransaction.fromBytes(bytes);
   }
 
+  /**
+   * Create a versioned transaction from raw MessageV0 data.
+   *
+   * This is used for the `fromVersionedTransactionData()` path where we have
+   * pre-compiled versioned data (indexes + ALT refs). No instruction compilation
+   * is needed - this just constructs the transaction from the raw structure.
+   *
+   * @param data - Raw versioned transaction data
+   * @returns A VersionedTransaction instance
+   *
+   * @example
+   * ```typescript
+   * const tx = VersionedTransaction.fromVersionedData({
+   *   staticAccountKeys: ['pubkey1', 'pubkey2', ...],
+   *   addressLookupTables: [
+   *     { accountKey: 'altPubkey', writableIndexes: [0, 1], readonlyIndexes: [2] }
+   *   ],
+   *   versionedInstructions: [
+   *     { programIdIndex: 0, accountKeyIndexes: [1, 2], data: 'base58EncodedData' }
+   *   ],
+   *   messageHeader: {
+   *     numRequiredSignatures: 1,
+   *     numReadonlySignedAccounts: 0,
+   *     numReadonlyUnsignedAccounts: 3
+   *   },
+   *   recentBlockhash: 'blockhash'
+   * });
+   * ```
+   */
+  static fromVersionedData(data: RawVersionedTransactionData): VersionedTransaction {
+    // Build the transaction bytes using WASM
+    const bytes = BuilderNamespace.build_from_versioned_data(data);
+    // Parse the bytes to create a VersionedTransaction
+    return VersionedTransaction.fromBytes(bytes);
+  }
+
   /**
    * Check if this is a versioned transaction (MessageV0).
    */
@@ -127,6 +168,16 @@ export class VersionedTransaction {
     return this.inner.signable_payload();
   }
 
+  /**
+   * Serialize the message portion of the transaction.
+   * Alias for signablePayload() - provides compatibility with @solana/web3.js API.
+   * Returns a Buffer for compatibility with code expecting .toString('base64').
+   * @returns The serialized message bytes as a Buffer
+   */
+  serializeMessage(): Buffer {
+    return Buffer.from(this.signablePayload());
+  }
+
   /**
    * Serialize the transaction to bytes.
    */
@@ -163,9 +214,10 @@ export class VersionedTransaction {
   }
 
   /**
-   * Get all signatures.
+   * Get all signatures as byte arrays.
+   * Provides compatibility with @solana/web3.js Transaction.signatures API.
    */
-  signatures(): Uint8Array[] {
+  get signatures(): Uint8Array[] {
     return Array.from(this.inner.signatures()) as Uint8Array[];
   }
 

packages/wasm-solana/js/versioned.ts

@@ -16,5 +16,8 @@ mod types;
 mod versioned;
 
 pub use build::build_transaction;
-pub use types::{AddressLookupTable, Instruction, Nonce, TransactionIntent};
-pub use versioned::should_build_versioned;
+pub use types::{
+    AddressLookupTable, Instruction, MessageHeader, Nonce, RawVersionedTransactionData,
+    TransactionIntent, VersionedInstruction,
+};
+pub use versioned::{build_from_raw_versioned_data, should_build_versioned};

packages/wasm-solana/src/builder/mod.rs

@@ -390,3 +390,67 @@ fn default_token_program() -> String {
 fn default_encoding() -> String {
     "base64".to_string()
 }
+
+// =============================================================================
+// Raw Versioned Transaction Data (for fromVersionedTransactionData path)
+// =============================================================================
+
+/// Raw versioned transaction data for direct serialization.
+/// This is used when we have pre-formed MessageV0 data that just needs to be serialized.
+/// No instruction compilation is needed - just serialize the raw structure.
+#[derive(Debug, Clone, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct RawVersionedTransactionData {
+    /// Static account keys (base58 encoded public keys)
+    #[serde(rename = "staticAccountKeys")]
+    pub static_account_keys: Vec<String>,
+
+    /// Address lookup tables
+    #[serde(rename = "addressLookupTables")]
+    pub address_lookup_tables: Vec<AddressLookupTable>,
+
+    /// Pre-compiled instructions with index-based account references
+    #[serde(rename = "versionedInstructions")]
+    pub versioned_instructions: Vec<VersionedInstruction>,
+
+    /// Message header
+    #[serde(rename = "messageHeader")]
+    pub message_header: MessageHeader,
+
+    /// Recent blockhash (base58)
+    #[serde(rename = "recentBlockhash")]
+    pub recent_blockhash: String,
+}
+
+/// A pre-compiled versioned instruction (uses indexes, not pubkeys)
+#[derive(Debug, Clone, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct VersionedInstruction {
+    /// Index into the account keys array for the program ID
+    #[serde(rename = "programIdIndex")]
+    pub program_id_index: u8,
+
+    /// Indexes into the account keys array for instruction accounts
+    #[serde(rename = "accountKeyIndexes")]
+    pub account_key_indexes: Vec<u8>,
+
+    /// Instruction data (base58 encoded)
+    pub data: String,
+}
+
+/// Message header for versioned transactions
+#[derive(Debug, Clone, Deserialize)]
+#[serde(rename_all = "camelCase")]
+pub struct MessageHeader {
+    /// Number of required signatures
+    #[serde(rename = "numRequiredSignatures")]
+    pub num_required_signatures: u8,
+
+    /// Number of readonly signed accounts
+    #[serde(rename = "numReadonlySignedAccounts")]
+    pub num_readonly_signed_accounts: u8,
+
+    /// Number of readonly unsigned accounts
+    #[serde(rename = "numReadonlyUnsignedAccounts")]
+    pub num_readonly_unsigned_accounts: u8,
+}