Class InstructionUtils

StaticasV0TxWithComputeIxs

• asV0TxWithComputeIxs(
      params: {
          connection: Connection;
          ixs: TransactionInstruction[];
          payer?: PublicKey;
          computeUnitLimitMultiple?: number;
          computeUnitPrice?: number;
          lookupTables?: AddressLookupTableAccount[];
          signers?: Signer[];
      },
  ): Promise<VersionedTransaction>

  Builds a versioned transaction with automatic compute budget optimization

  This method simplifies transaction creation by:

  • Automatically simulating to determine compute requirements
  • Adding appropriate compute budget instructions
  • Using address lookup tables for smaller transactions
  • Handling transaction size limits gracefully

  The method performs two key optimizations:

  1. Compute Budget: Simulates first to determine actual compute usage, then sets the limit based on actual needs (with optional buffer)
  2. Transaction Size: Uses v0 transactions with lookup tables to minimize transaction size

  Parameters

  • params: {
        connection: Connection;
        ixs: TransactionInstruction[];
        payer?: PublicKey;
        computeUnitLimitMultiple?: number;
        computeUnitPrice?: number;
        lookupTables?: AddressLookupTableAccount[];
        signers?: Signer[];
    }

    Transaction building parameters

    • connection: Connection

      Solana RPC connection

    • ixs: TransactionInstruction[]

      Instructions to include

    • Optionalpayer?: PublicKey

      Transaction fee payer (defaults to first signer)

    • OptionalcomputeUnitLimitMultiple?: number

      Multiplier for compute limit (e.g., 1.3 = 30% buffer)

    • OptionalcomputeUnitPrice?: number

      Priority fee in microlamports per compute unit

    • OptionallookupTables?: AddressLookupTableAccount[]

      Address lookup tables to use

    • Optionalsigners?: Signer[]

      Transaction signers

  Returns Promise<VersionedTransaction>

  Signed versioned transaction ready to send

  Throws

  If transaction is too large or payer not provided

  Example

  const tx = await InstructionUtils.asV0TxWithComputeIxs({
    connection,
    ixs: [updateIx, userIx],
    signers: [payer],
    computeUnitPrice: 10_000, // 0.01 lamports per compute unit
    computeUnitLimitMultiple: 1.3, // 30% safety buffer
    lookupTables: [lut],
  });
  
  const signature = await connection.sendTransaction(tx);
  Copy