@bitgo/wasm-solana 1.6.0 → 2.0.1

package/dist/esm/js/builder.d.ts

@@ -1,29 +1,15 @@
 /**
- * Transaction building from high-level intents.
+ * Versioned Transaction Building from Raw MessageV0 Data.
  *
- * Provides types and functions for building Solana transactions from a
- * declarative intent structure, without requiring the full @solana/web3.js dependency.
+ * This module provides `buildFromVersionedData` for building versioned transactions
+ * from pre-compiled MessageV0 data. This is used for:
+ * - WalletConnect/Jupiter pre-compiled versioned transactions
+ * - Custom transaction pass-through (customTx intent)
+ *
+ * Unlike the intent-based builder, this takes already-compiled instruction
+ * data with account indexes, not high-level instructions.
  */
-import { Transaction } from "./transaction.js";
 import { VersionedTransaction } from "./versioned.js";
-/** Use a recent blockhash for the transaction */
-export interface BlockhashNonceSource {
-    type: "blockhash";
-    /** The recent blockhash value (base58) */
-    value: string;
-}
-/** Use a durable nonce account for the transaction */
-export interface DurableNonceSource {
-    type: "durable";
-    /** The nonce account address (base58) */
-    address: string;
-    /** The nonce authority address (base58) */
-    authority: string;
-    /** The nonce value stored in the account (base58) - this becomes the blockhash */
-    value: string;
-}
-/** Nonce source for the transaction */
-export type NonceSource = BlockhashNonceSource | DurableNonceSource;
 /**
  * Address Lookup Table data for versioned transactions.
  *
@@ -38,386 +24,6 @@ export interface AddressLookupTable {
     /** Indices of readonly accounts in the lookup table */
     readonlyIndexes: number[];
 }
-/** SOL transfer instruction */
-export interface TransferInstruction {
-    type: "transfer";
-    /** Source account (base58) */
-    from: string;
-    /** Destination account (base58) */
-    to: string;
-    /** Amount in lamports */
-    lamports: bigint;
-}
-/** Create new account instruction */
-export interface CreateAccountInstruction {
-    type: "createAccount";
-    /** Funding account (base58) */
-    from: string;
-    /** New account address (base58) */
-    newAccount: string;
-    /** Lamports to transfer */
-    lamports: bigint;
-    /** Space to allocate in bytes */
-    space: number;
-    /** Owner program (base58) */
-    owner: string;
-}
-/** Advance durable nonce instruction */
-export interface NonceAdvanceInstruction {
-    type: "nonceAdvance";
-    /** Nonce account address (base58) */
-    nonce: string;
-    /** Nonce authority (base58) */
-    authority: string;
-}
-/** Initialize nonce account instruction */
-export interface NonceInitializeInstruction {
-    type: "nonceInitialize";
-    /** Nonce account address (base58) */
-    nonce: string;
-    /** Nonce authority (base58) */
-    authority: string;
-}
-/** Allocate space instruction */
-export interface AllocateInstruction {
-    type: "allocate";
-    /** Account to allocate (base58) */
-    account: string;
-    /** Space to allocate in bytes */
-    space: number;
-}
-/** Assign account to program instruction */
-export interface AssignInstruction {
-    type: "assign";
-    /** Account to assign (base58) */
-    account: string;
-    /** New owner program (base58) */
-    owner: string;
-}
-/** Memo instruction */
-export interface MemoInstruction {
-    type: "memo";
-    /** The memo message */
-    message: string;
-}
-/** Compute budget instruction */
-export interface ComputeBudgetInstruction {
-    type: "computeBudget";
-    /** Compute unit limit (optional) */
-    unitLimit?: number;
-    /** Compute unit price in micro-lamports (optional) */
-    unitPrice?: number;
-}
-/** Initialize a stake account instruction */
-export interface StakeInitializeInstruction {
-    type: "stakeInitialize";
-    /** Stake account address (base58) */
-    stake: string;
-    /** Authorized staker pubkey (base58) */
-    staker: string;
-    /** Authorized withdrawer pubkey (base58) */
-    withdrawer: string;
-}
-/** Delegate stake to a validator instruction */
-export interface StakeDelegateInstruction {
-    type: "stakeDelegate";
-    /** Stake account address (base58) */
-    stake: string;
-    /** Vote account (validator) to delegate to (base58) */
-    vote: string;
-    /** Stake authority (base58) */
-    authority: string;
-}
-/** Deactivate a stake account instruction */
-export interface StakeDeactivateInstruction {
-    type: "stakeDeactivate";
-    /** Stake account address (base58) */
-    stake: string;
-    /** Stake authority (base58) */
-    authority: string;
-}
-/** Withdraw from a stake account instruction */
-export interface StakeWithdrawInstruction {
-    type: "stakeWithdraw";
-    /** Stake account address (base58) */
-    stake: string;
-    /** Recipient address (base58) */
-    recipient: string;
-    /** Amount in lamports to withdraw */
-    lamports: bigint;
-    /** Withdraw authority (base58) */
-    authority: string;
-}
-/** Change stake account authorization instruction */
-export interface StakeAuthorizeInstruction {
-    type: "stakeAuthorize";
-    /** Stake account address (base58) */
-    stake: string;
-    /** New authority pubkey (base58) */
-    newAuthority: string;
-    /** Authorization type: "staker" or "withdrawer" */
-    authorizeType: "staker" | "withdrawer";
-    /** Current authority (base58) */
-    authority: string;
-}
-/** Split stake account instruction (for partial deactivation) */
-export interface StakeSplitInstruction {
-    type: "stakeSplit";
-    /** Source stake account address (base58) */
-    stake: string;
-    /** Destination stake account (must be uninitialized/created first) (base58) */
-    splitStake: string;
-    /** Stake authority (base58) */
-    authority: string;
-    /** Amount in lamports to split */
-    lamports: bigint;
-}
-/** Transfer tokens instruction (uses TransferChecked) */
-export interface TokenTransferInstruction {
-    type: "tokenTransfer";
-    /** Source token account (base58) */
-    source: string;
-    /** Destination token account (base58) */
-    destination: string;
-    /** Token mint address (base58) */
-    mint: string;
-    /** Amount of tokens (in smallest units) */
-    amount: bigint;
-    /** Number of decimals for the token */
-    decimals: number;
-    /** Owner/authority of the source account (base58) */
-    authority: string;
-    /** Token program ID (optional, defaults to SPL Token) */
-    programId?: string;
-}
-/** Create an Associated Token Account instruction */
-export interface CreateAssociatedTokenAccountInstruction {
-    type: "createAssociatedTokenAccount";
-    /** Payer for account creation (base58) */
-    payer: string;
-    /** Owner of the new ATA (base58) */
-    owner: string;
-    /** Token mint address (base58) */
-    mint: string;
-    /** Token program ID (optional, defaults to SPL Token) */
-    tokenProgramId?: string;
-}
-/** Close an Associated Token Account instruction */
-export interface CloseAssociatedTokenAccountInstruction {
-    type: "closeAssociatedTokenAccount";
-    /** Token account to close (base58) */
-    account: string;
-    /** Destination for remaining lamports (base58) */
-    destination: string;
-    /** Authority of the account (base58) */
-    authority: string;
-    /** Token program ID (optional, defaults to SPL Token) */
-    programId?: string;
-}
-/** Mint tokens to an account instruction */
-export interface MintToInstruction {
-    type: "mintTo";
-    /** Token mint address (base58) */
-    mint: string;
-    /** Destination token account (base58) */
-    destination: string;
-    /** Mint authority (base58) */
-    authority: string;
-    /** Amount of tokens to mint (in smallest units) */
-    amount: bigint;
-    /** Token program ID (optional, defaults to SPL Token) */
-    programId?: string;
-}
-/** Burn tokens from an account instruction */
-export interface BurnInstruction {
-    type: "burn";
-    /** Token mint address (base58) */
-    mint: string;
-    /** Source token account to burn from (base58) */
-    account: string;
-    /** Token account authority (base58) */
-    authority: string;
-    /** Amount of tokens to burn (in smallest units) */
-    amount: bigint;
-    /** Token program ID (optional, defaults to SPL Token) */
-    programId?: string;
-}
-/** Approve a delegate to transfer tokens instruction */
-export interface ApproveInstruction {
-    type: "approve";
-    /** Token account to approve delegation for (base58) */
-    account: string;
-    /** Delegate address (who can transfer) (base58) */
-    delegate: string;
-    /** Token account owner (base58) */
-    owner: string;
-    /** Amount of tokens to approve (in smallest units) */
-    amount: bigint;
-    /** Token program ID (optional, defaults to SPL Token) */
-    programId?: string;
-}
-/** Deposit SOL into a stake pool (Jito liquid staking) */
-export interface StakePoolDepositSolInstruction {
-    type: "stakePoolDepositSol";
-    /** Stake pool address (base58) */
-    stakePool: string;
-    /** Withdraw authority PDA (base58) */
-    withdrawAuthority: string;
-    /** Reserve stake account (base58) */
-    reserveStake: string;
-    /** Funding account (SOL source, signer) (base58) */
-    fundingAccount: string;
-    /** Destination for pool tokens (base58) */
-    destinationPoolAccount: string;
-    /** Manager fee account (base58) */
-    managerFeeAccount: string;
-    /** Referral pool account (base58) */
-    referralPoolAccount: string;
-    /** Pool mint address (base58) */
-    poolMint: string;
-    /** Amount in lamports to deposit */
-    lamports: bigint;
-}
-/** Withdraw stake from a stake pool (Jito liquid staking) */
-export interface StakePoolWithdrawStakeInstruction {
-    type: "stakePoolWithdrawStake";
-    /** Stake pool address (base58) */
-    stakePool: string;
-    /** Validator list account (base58) */
-    validatorList: string;
-    /** Withdraw authority PDA (base58) */
-    withdrawAuthority: string;
-    /** Validator stake account to split from (base58) */
-    validatorStake: string;
-    /** Destination stake account (uninitialized) (base58) */
-    destinationStake: string;
-    /** Authority for the destination stake account (base58) */
-    destinationStakeAuthority: string;
-    /** Source pool token account authority (signer) (base58) */
-    sourceTransferAuthority: string;
-    /** Source pool token account (base58) */
-    sourcePoolAccount: string;
-    /** Manager fee account (base58) */
-    managerFeeAccount: string;
-    /** Pool mint address (base58) */
-    poolMint: string;
-    /** Amount of pool tokens to burn */
-    poolTokens: bigint;
-}
-/** Account metadata for custom instructions */
-export interface CustomAccountMeta {
-    /** Account public key (base58) */
-    pubkey: string;
-    /** Whether the account is a signer */
-    isSigner: boolean;
-    /** Whether the account is writable */
-    isWritable: boolean;
-}
-/**
- * Custom instruction for invoking any program.
- * Enables passthrough of arbitrary instructions for extensibility.
- */
-export interface CustomInstruction {
-    type: "custom";
-    /** The program ID to invoke (base58) */
-    programId: string;
-    /** Account metas for the instruction */
-    accounts: CustomAccountMeta[];
-    /** Instruction data (base64 or hex encoded) */
-    data: string;
-    /** Encoding of the data field: "base64" (default) or "hex" */
-    encoding?: "base64" | "hex";
-}
-/** Union of all instruction types */
-export type Instruction = TransferInstruction | CreateAccountInstruction | NonceAdvanceInstruction | NonceInitializeInstruction | AllocateInstruction | AssignInstruction | MemoInstruction | ComputeBudgetInstruction | StakeInitializeInstruction | StakeDelegateInstruction | StakeDeactivateInstruction | StakeWithdrawInstruction | StakeAuthorizeInstruction | StakeSplitInstruction | TokenTransferInstruction | CreateAssociatedTokenAccountInstruction | CloseAssociatedTokenAccountInstruction | MintToInstruction | BurnInstruction | ApproveInstruction | StakePoolDepositSolInstruction | StakePoolWithdrawStakeInstruction | CustomInstruction;
-/**
- * A declarative intent to build a Solana transaction.
- *
- * @example
- * ```typescript
- * const intent: TransactionIntent = {
- *   feePayer: 'DgT9qyYwYKBRDyDw3EfR12LHQCQjtNrKu2qMsXHuosmB',
- *   nonce: {
- *     type: 'blockhash',
- *     value: 'GWaQEymC3Z9SHM2gkh8u12xL1zJPMHPCSVR3pSDpEXE4'
- *   },
- *   instructions: [
- *     { type: 'transfer', from: '...', to: '...', lamports: '1000000' }
- *   ]
- * };
- * ```
- */
-export interface TransactionIntent {
-    /** The fee payer's public key (base58) */
-    feePayer: string;
-    /** The nonce source (blockhash or durable nonce) */
-    nonce: NonceSource;
-    /** List of instructions to include */
-    instructions: Instruction[];
-    /**
-     * Address Lookup Tables for versioned transactions.
-     * If provided, builds a MessageV0 transaction instead of legacy.
-     */
-    addressLookupTables?: AddressLookupTable[];
-    /**
-     * Static account keys (for versioned transaction round-trip).
-     * These are the accounts stored directly in the message.
-     */
-    staticAccountKeys?: string[];
-}
-/**
- * Build a Solana transaction from a high-level intent.
- *
- * This function takes a declarative TransactionIntent and produces a Transaction
- * object that can be inspected, signed, and serialized.
- *
- * The returned transaction is unsigned - signatures should be added via
- * `addSignature()` before serializing with `toBytes()` and broadcasting.
- *
- * @param intent - The transaction intent describing what to build
- * @returns A Transaction object that can be inspected, signed, and serialized
- * @throws Error if the intent cannot be built (e.g., invalid addresses)
- *
- * @example
- * ```typescript
- * import { buildTransaction } from '@bitgo/wasm-solana';
- *
- * // Build a simple SOL transfer
- * const tx = buildTransaction({
- *   feePayer: sender,
- *   nonce: { type: 'blockhash', value: blockhash },
- *   instructions: [
- *     { type: 'transfer', from: sender, to: recipient, lamports: 1000000n }
- *   ]
- * });
- *
- * // Inspect the transaction
- * console.log(tx.feePayer);
- * console.log(tx.recentBlockhash);
- *
- * // Get the signable payload for signing
- * const payload = tx.signablePayload();
- *
- * // Add signature and serialize
- * tx.addSignature(signerPubkey, signature);
- * const txBytes = tx.toBytes();
- * ```
- *
- * @example
- * ```typescript
- * // Build with durable nonce and priority fee
- * const tx = buildTransaction({
- *   feePayer: sender,
- *   nonce: { type: 'durable', address: nonceAccount, authority: sender, value: nonceValue },
- *   instructions: [
- *     { type: 'computeBudget', unitLimit: 200000, unitPrice: 5000 },
- *     { type: 'transfer', from: sender, to: recipient, lamports: 1000000n },
- *     { type: 'memo', message: 'BitGo transfer' }
- *   ]
- * });
- * ```
- */
-export declare function buildTransaction(intent: TransactionIntent): Transaction;
 /**
  * A pre-compiled versioned instruction (uses indexes, not pubkeys).
  * This is the format used in MessageV0 transactions.

package/dist/esm/js/builder.js

@@ -1,71 +1,19 @@
 /**
- * Transaction building from high-level intents.
+ * Versioned Transaction Building from Raw MessageV0 Data.
  *
- * Provides types and functions for building Solana transactions from a
- * declarative intent structure, without requiring the full @solana/web3.js dependency.
+ * This module provides `buildFromVersionedData` for building versioned transactions
+ * from pre-compiled MessageV0 data. This is used for:
+ * - WalletConnect/Jupiter pre-compiled versioned transactions
+ * - Custom transaction pass-through (customTx intent)
+ *
+ * Unlike the intent-based builder, this takes already-compiled instruction
+ * data with account indexes, not high-level instructions.
  */
 import { BuilderNamespace } from "./wasm/wasm_solana.js";
-import { Transaction } from "./transaction.js";
 import { VersionedTransaction } from "./versioned.js";
 // =============================================================================
-// buildTransaction function
+// buildFromVersionedData function
 // =============================================================================
-/**
- * Build a Solana transaction from a high-level intent.
- *
- * This function takes a declarative TransactionIntent and produces a Transaction
- * object that can be inspected, signed, and serialized.
- *
- * The returned transaction is unsigned - signatures should be added via
- * `addSignature()` before serializing with `toBytes()` and broadcasting.
- *
- * @param intent - The transaction intent describing what to build
- * @returns A Transaction object that can be inspected, signed, and serialized
- * @throws Error if the intent cannot be built (e.g., invalid addresses)
- *
- * @example
- * ```typescript
- * import { buildTransaction } from '@bitgo/wasm-solana';
- *
- * // Build a simple SOL transfer
- * const tx = buildTransaction({
- *   feePayer: sender,
- *   nonce: { type: 'blockhash', value: blockhash },
- *   instructions: [
- *     { type: 'transfer', from: sender, to: recipient, lamports: 1000000n }
- *   ]
- * });
- *
- * // Inspect the transaction
- * console.log(tx.feePayer);
- * console.log(tx.recentBlockhash);
- *
- * // Get the signable payload for signing
- * const payload = tx.signablePayload();
- *
- * // Add signature and serialize
- * tx.addSignature(signerPubkey, signature);
- * const txBytes = tx.toBytes();
- * ```
- *
- * @example
- * ```typescript
- * // Build with durable nonce and priority fee
- * const tx = buildTransaction({
- *   feePayer: sender,
- *   nonce: { type: 'durable', address: nonceAccount, authority: sender, value: nonceValue },
- *   instructions: [
- *     { type: 'computeBudget', unitLimit: 200000, unitPrice: 5000 },
- *     { type: 'transfer', from: sender, to: recipient, lamports: 1000000n },
- *     { type: 'memo', message: 'BitGo transfer' }
- *   ]
- * });
- * ```
- */
-export function buildTransaction(intent) {
-    const wasm = BuilderNamespace.build_transaction(intent);
-    return Transaction.fromWasm(wasm);
-}
 /**
  * Build a versioned transaction directly from raw MessageV0 data.
  *

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

@@ -9,10 +9,10 @@ export { Transaction } from "./transaction.js";
 export { VersionedTransaction, isVersionedTransaction } from "./versioned.js";
 export type { AddressLookupTableData } from "./versioned.js";
 export { parseTransaction } from "./parser.js";
-export { buildTransaction, buildFromVersionedData } from "./builder.js";
-export { buildFromIntent } from "./intentBuilder.js";
+export { buildFromVersionedData } from "./builder.js";
+export { buildFromIntent, buildFromIntent as buildTransactionFromIntent } from "./intentBuilder.js";
 export type { BaseIntent, PaymentIntent, StakeIntent, UnstakeIntent, ClaimIntent, DeactivateIntent, DelegateIntent, EnableTokenIntent, CloseAtaIntent, ConsolidateIntent, 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 { TransactionInput, 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 { TransactionIntent, NonceSource as BuilderNonceSource, BlockhashNonceSource, DurableNonceSource, AddressLookupTable as BuilderAddressLookupTable, Instruction as BuilderInstruction, TransferInstruction, CreateAccountInstruction, NonceAdvanceInstruction, NonceInitializeInstruction, AllocateInstruction, AssignInstruction, MemoInstruction, ComputeBudgetInstruction, StakeInitializeInstruction, StakeDelegateInstruction, StakeDeactivateInstruction, StakeWithdrawInstruction, StakeAuthorizeInstruction, StakeSplitInstruction, TokenTransferInstruction, CreateAssociatedTokenAccountInstruction, CloseAssociatedTokenAccountInstruction, MintToInstruction, BurnInstruction, ApproveInstruction, StakePoolDepositSolInstruction, StakePoolWithdrawStakeInstruction, CustomInstruction as BuilderCustomInstruction, CustomAccountMeta, RawVersionedTransactionData, VersionedInstruction as BuilderVersionedInstruction, MessageHeader, } from "./builder.js";
+export type { AddressLookupTable as BuilderAddressLookupTable, RawVersionedTransactionData, VersionedInstruction as BuilderVersionedInstruction, MessageHeader, } from "./builder.js";

package/dist/esm/js/index.js

@@ -15,8 +15,8 @@ export { Transaction } from "./transaction.js";
 export { VersionedTransaction, isVersionedTransaction } from "./versioned.js";
 // Top-level function exports
 export { parseTransaction } from "./parser.js";
-export { buildTransaction, buildFromVersionedData } from "./builder.js";
-export { buildFromIntent } from "./intentBuilder.js";
+export { buildFromVersionedData } from "./builder.js";
+export { buildFromIntent, buildFromIntent as buildTransactionFromIntent } from "./intentBuilder.js";
 // Program ID constants (from WASM)
 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 addresses

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

@@ -72,7 +72,7 @@ export declare class Transaction {
      * Get the transaction ID (first signature as base58).
      *
      * For Solana, the transaction ID is the first signature.
-     * Returns "UNSIGNED" if the transaction has no valid signatures.
+     * Returns `undefined` if the transaction is unsigned (no signatures or all-zeros signature).
      *
      * @example
      * ```typescript
@@ -81,7 +81,7 @@ export declare class Transaction {
      * console.log(tx.id); // Base58 encoded signature
      * ```
      */
-    get id(): string;
+    get id(): string | undefined;
     /**
      * Get the signable message payload (what gets signed)
      * This is the serialized message that signers sign
@@ -91,10 +91,9 @@ export declare class Transaction {
     /**
      * 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
+     * @returns The serialized message bytes
      */
-    serializeMessage(): Buffer;
+    serializeMessage(): Uint8Array;
     /**
      * Serialize the transaction to bytes
      * @returns The serialized transaction bytes

package/dist/esm/js/transaction.js

@@ -63,7 +63,7 @@ export class Transaction {
      * Get the transaction ID (first signature as base58).
      *
      * For Solana, the transaction ID is the first signature.
-     * Returns "UNSIGNED" if the transaction has no valid signatures.
+     * Returns `undefined` if the transaction is unsigned (no signatures or all-zeros signature).
      *
      * @example
      * ```typescript
@@ -86,11 +86,10 @@ export class Transaction {
     /**
      * 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
+     * @returns The serialized message bytes
      */
     serializeMessage() {
-        return Buffer.from(this.signablePayload());
+        return this.signablePayload();
     }
     /**
      * Serialize the transaction to bytes

package/dist/esm/js/versioned.d.ts

@@ -63,10 +63,6 @@ export declare class VersionedTransaction {
      * Automatically handles both legacy and versioned formats.
      */
     static fromBytes(bytes: Uint8Array): VersionedTransaction;
-    /**
-     * Deserialize a transaction from base64 string.
-     */
-    static fromBase64(base64: string): VersionedTransaction;
     /**
      * Create a VersionedTransaction from a WasmVersionedTransaction instance.
      * @internal Used by builder functions
@@ -126,9 +122,9 @@ export declare class VersionedTransaction {
      * Get the transaction ID (first signature as base58).
      *
      * For Solana, the transaction ID is the first signature.
-     * Returns "UNSIGNED" if the transaction has no valid signatures.
+     * Returns `undefined` if the transaction is unsigned (no signatures or all-zeros signature).
      */
-    get id(): string;
+    get id(): string | undefined;
     /**
      * Get the signable message payload.
      */
@@ -136,18 +132,13 @@ export declare class VersionedTransaction {
     /**
      * 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
+     * @returns The serialized message bytes
      */
-    serializeMessage(): Buffer;
+    serializeMessage(): Uint8Array;
     /**
      * Serialize the transaction to bytes.
      */
     toBytes(): Uint8Array;
-    /**
-     * Serialize the transaction to base64.
-     */
-    toBase64(): string;
     /**
      * Serialize to network broadcast format.
      * @returns The transaction as bytes ready for broadcast

package/dist/esm/js/versioned.js

@@ -33,13 +33,6 @@ export class VersionedTransaction {
     static fromBytes(bytes) {
         return new VersionedTransaction(WasmVersionedTransaction.from_bytes(bytes));
     }
-    /**
-     * Deserialize a transaction from base64 string.
-     */
-    static fromBase64(base64) {
-        const bytes = Uint8Array.from(Buffer.from(base64, "base64"));
-        return VersionedTransaction.fromBytes(bytes);
-    }
     /**
      * Create a VersionedTransaction from a WasmVersionedTransaction instance.
      * @internal Used by builder functions
@@ -115,7 +108,7 @@ export class VersionedTransaction {
      * Get the transaction ID (first signature as base58).
      *
      * For Solana, the transaction ID is the first signature.
-     * Returns "UNSIGNED" if the transaction has no valid signatures.
+     * Returns `undefined` if the transaction is unsigned (no signatures or all-zeros signature).
      */
     get id() {
         return this.inner.id;
@@ -129,11 +122,10 @@ export class VersionedTransaction {
     /**
      * 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
+     * @returns The serialized message bytes
      */
     serializeMessage() {
-        return Buffer.from(this.signablePayload());
+        return this.signablePayload();
     }
     /**
      * Serialize the transaction to bytes.
@@ -141,12 +133,6 @@ export class VersionedTransaction {
     toBytes() {
         return this.inner.to_bytes();
     }
-    /**
-     * Serialize the transaction to base64.
-     */
-    toBase64() {
-        return Buffer.from(this.toBytes()).toString("base64");
-    }
     /**
      * Serialize to network broadcast format.
      * @returns The transaction as bytes ready for broadcast