@solana/transactions 2.0.0-experimental.e4483d3 → 2.0.0-experimental.e587f8d

package/dist/index.browser.cjs

@@ -1,15 +1,36 @@
 'use strict';
 
+var errors = require('@solana/errors');
 var codecsStrings = require('@solana/codecs-strings');
 var addresses = require('@solana/addresses');
+var functional = require('@solana/functional');
 var codecsCore = require('@solana/codecs-core');
 var codecsDataStructures = require('@solana/codecs-data-structures');
 var codecsNumbers = require('@solana/codecs-numbers');
-var functional = require('@solana/functional');
 var keys = require('@solana/keys');
 
-// ../build-scripts/env-shim.ts
-var __DEV__ = /* @__PURE__ */ (() => process["env"].NODE_ENV === "development")();
+// src/blockhash.ts
+var base58Encoder;
+function assertIsBlockhash(putativeBlockhash) {
+  if (!base58Encoder)
+    base58Encoder = codecsStrings.getBase58Encoder();
+  if (
+    // Lowest value (32 bytes of zeroes)
+    putativeBlockhash.length < 32 || // Highest value (32 bytes of 255)
+    putativeBlockhash.length > 44
+  ) {
+    throw new errors.SolanaError(errors.SOLANA_ERROR__BLOCKHASH_STRING_LENGTH_OUT_OF_RANGE, {
+      actualLength: putativeBlockhash.length
+    });
+  }
+  const bytes = base58Encoder.encode(putativeBlockhash);
+  const numBytes = bytes.byteLength;
+  if (numBytes !== 32) {
+    throw new errors.SolanaError(errors.SOLANA_ERROR__INVALID_BLOCKHASH_BYTE_LENGTH, {
+      actualLength: numBytes
+    });
+  }
+}
 
 // src/unsigned-transaction.ts
 function getUnsignedTransaction(transaction) {
@@ -26,27 +47,20 @@ function getUnsignedTransaction(transaction) {
 }
 
 // src/blockhash.ts
-var base58Encoder;
-function assertIsBlockhash(putativeBlockhash) {
-  if (!base58Encoder)
-    base58Encoder = codecsStrings.getBase58Encoder();
+function isTransactionWithBlockhashLifetime(transaction) {
+  const lifetimeConstraintShapeMatches = "lifetimeConstraint" in transaction && typeof transaction.lifetimeConstraint.blockhash === "string" && typeof transaction.lifetimeConstraint.lastValidBlockHeight === "bigint";
+  if (!lifetimeConstraintShapeMatches)
+    return false;
   try {
-    if (
-      // Lowest value (32 bytes of zeroes)
-      putativeBlockhash.length < 32 || // Highest value (32 bytes of 255)
-      putativeBlockhash.length > 44
-    ) {
-      throw new Error("Expected input string to decode to a byte array of length 32.");
-    }
-    const bytes = base58Encoder.encode(putativeBlockhash);
-    const numBytes = bytes.byteLength;
-    if (numBytes !== 32) {
-      throw new Error(`Expected input string to decode to a byte array of length 32. Actual length: ${numBytes}`);
-    }
-  } catch (e) {
-    throw new Error(`\`${putativeBlockhash}\` is not a blockhash`, {
-      cause: e
-    });
+    assertIsBlockhash(transaction.lifetimeConstraint.blockhash);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function assertIsTransactionWithBlockhashLifetime(transaction) {
+  if (!isTransactionWithBlockhashLifetime(transaction)) {
+    throw new errors.SolanaError(errors.SOLANA_ERROR__TRANSACTION__EXPECTED_BLOCKHASH_LIFETIME);
   }
 }
 function setTransactionLifetimeUsingBlockhash(blockhashLifetimeConstraint, transaction) {
@@ -72,8 +86,6 @@ function createTransaction({
   Object.freeze(out);
   return out;
 }
-
-// ../instructions/dist/index.browser.js
 var AccountRole = /* @__PURE__ */ ((AccountRole2) => {
   AccountRole2[AccountRole2["WRITABLE_SIGNER"] = /* 3 */
   3] = "WRITABLE_SIGNER";
@@ -95,13 +107,11 @@ function isWritableRole(role) {
 function mergeRoles(roleA, roleB) {
   return roleA | roleB;
 }
-
-// src/durable-nonce.ts
 var RECENT_BLOCKHASHES_SYSVAR_ADDRESS = "SysvarRecentB1ockHashes11111111111111111111";
 var SYSTEM_PROGRAM_ADDRESS = "11111111111111111111111111111111";
 function assertIsDurableNonceTransaction(transaction) {
   if (!isDurableNonceTransaction(transaction)) {
-    throw new Error("Transaction is not a durable nonce transaction");
+    throw new errors.SolanaError(errors.SOLANA_ERROR__TRANSACTION__EXPECTED_NONCE_LIFETIME);
   }
 }
 function createAdvanceNonceAccountInstruction(nonceAccountAddress, nonceAuthorityAddress) {
@@ -187,21 +197,181 @@ function setTransactionFeePayer(feePayer, transaction) {
 
 // src/instructions.ts
 function appendTransactionInstruction(instruction, transaction) {
+  return appendTransactionInstructions([instruction], transaction);
+}
+function appendTransactionInstructions(instructions, transaction) {
   const out = {
     ...getUnsignedTransaction(transaction),
-    instructions: [...transaction.instructions, instruction]
+    instructions: [...transaction.instructions, ...instructions]
   };
   Object.freeze(out);
   return out;
 }
 function prependTransactionInstruction(instruction, transaction) {
+  return prependTransactionInstructions([instruction], transaction);
+}
+function prependTransactionInstructions(instructions, transaction) {
   const out = {
     ...getUnsignedTransaction(transaction),
-    instructions: [instruction, ...transaction.instructions]
+    instructions: [...instructions, ...transaction.instructions]
   };
   Object.freeze(out);
   return out;
 }
+
+// src/decompile-transaction.ts
+function getAccountMetas(message) {
+  const { header } = message;
+  const numWritableSignerAccounts = header.numSignerAccounts - header.numReadonlySignerAccounts;
+  const numWritableNonSignerAccounts = message.staticAccounts.length - header.numSignerAccounts - header.numReadonlyNonSignerAccounts;
+  const accountMetas = [];
+  let accountIndex = 0;
+  for (let i = 0; i < numWritableSignerAccounts; i++) {
+    accountMetas.push({
+      address: message.staticAccounts[accountIndex],
+      role: AccountRole.WRITABLE_SIGNER
+    });
+    accountIndex++;
+  }
+  for (let i = 0; i < header.numReadonlySignerAccounts; i++) {
+    accountMetas.push({
+      address: message.staticAccounts[accountIndex],
+      role: AccountRole.READONLY_SIGNER
+    });
+    accountIndex++;
+  }
+  for (let i = 0; i < numWritableNonSignerAccounts; i++) {
+    accountMetas.push({
+      address: message.staticAccounts[accountIndex],
+      role: AccountRole.WRITABLE
+    });
+    accountIndex++;
+  }
+  for (let i = 0; i < header.numReadonlyNonSignerAccounts; i++) {
+    accountMetas.push({
+      address: message.staticAccounts[accountIndex],
+      role: AccountRole.READONLY
+    });
+    accountIndex++;
+  }
+  return accountMetas;
+}
+function getAddressLookupMetas(compiledAddressTableLookups, addressesByLookupTableAddress) {
+  const compiledAddressTableLookupAddresses = compiledAddressTableLookups.map((l) => l.lookupTableAddress);
+  const missing = compiledAddressTableLookupAddresses.filter((a) => addressesByLookupTableAddress[a] === void 0);
+  if (missing.length > 0) {
+    throw new errors.SolanaError(errors.SOLANA_ERROR__TRANSACTION__FAILED_TO_DECOMPILE_ADDRESS_LOOKUP_TABLE_CONTENTS_MISSING, {
+      lookupTableAddresses: missing
+    });
+  }
+  const readOnlyMetas = [];
+  const writableMetas = [];
+  for (const lookup of compiledAddressTableLookups) {
+    const addresses = addressesByLookupTableAddress[lookup.lookupTableAddress];
+    const highestIndex = Math.max(...lookup.readableIndices, ...lookup.writableIndices);
+    if (highestIndex >= addresses.length) {
+      throw new errors.SolanaError(
+        errors.SOLANA_ERROR__TRANSACTION__FAILED_TO_DECOMPILE_ADDRESS_LOOKUP_TABLE_INDEX_OUT_OF_RANGE,
+        {
+          highestKnownIndex: addresses.length - 1,
+          highestRequestedIndex: highestIndex,
+          lookupTableAddress: lookup.lookupTableAddress
+        }
+      );
+    }
+    const readOnlyForLookup = lookup.readableIndices.map((r) => ({
+      address: addresses[r],
+      addressIndex: r,
+      lookupTableAddress: lookup.lookupTableAddress,
+      role: AccountRole.READONLY
+    }));
+    readOnlyMetas.push(...readOnlyForLookup);
+    const writableForLookup = lookup.writableIndices.map((w) => ({
+      address: addresses[w],
+      addressIndex: w,
+      lookupTableAddress: lookup.lookupTableAddress,
+      role: AccountRole.WRITABLE
+    }));
+    writableMetas.push(...writableForLookup);
+  }
+  return [...writableMetas, ...readOnlyMetas];
+}
+function convertInstruction(instruction, accountMetas) {
+  const programAddress = accountMetas[instruction.programAddressIndex]?.address;
+  if (!programAddress) {
+    throw new errors.SolanaError(errors.SOLANA_ERROR__TRANSACTION__FAILED_TO_DECOMPILE_INSTRUCTION_PROGRAM_ADDRESS_NOT_FOUND, {
+      index: instruction.programAddressIndex
+    });
+  }
+  const accounts = instruction.accountIndices?.map((accountIndex) => accountMetas[accountIndex]);
+  const { data } = instruction;
+  return {
+    programAddress,
+    ...accounts && accounts.length ? { accounts } : {},
+    ...data && data.length ? { data } : {}
+  };
+}
+function getLifetimeConstraint(messageLifetimeToken, firstInstruction, lastValidBlockHeight) {
+  if (!firstInstruction || !isAdvanceNonceAccountInstruction(firstInstruction)) {
+    return {
+      blockhash: messageLifetimeToken,
+      lastValidBlockHeight: lastValidBlockHeight ?? 2n ** 64n - 1n
+      // U64 MAX
+    };
+  } else {
+    const nonceAccountAddress = firstInstruction.accounts[0].address;
+    addresses.assertIsAddress(nonceAccountAddress);
+    const nonceAuthorityAddress = firstInstruction.accounts[2].address;
+    addresses.assertIsAddress(nonceAuthorityAddress);
+    return {
+      nonce: messageLifetimeToken,
+      nonceAccountAddress,
+      nonceAuthorityAddress
+    };
+  }
+}
+function convertSignatures(compiledTransaction) {
+  const {
+    compiledMessage: { staticAccounts },
+    signatures
+  } = compiledTransaction;
+  return signatures.reduce((acc, sig, index) => {
+    const allZeros = sig.every((byte) => byte === 0);
+    if (allZeros)
+      return acc;
+    const address = staticAccounts[index];
+    return { ...acc, [address]: sig };
+  }, {});
+}
+function decompileTransaction(compiledTransaction, config) {
+  const { compiledMessage } = compiledTransaction;
+  const feePayer = compiledMessage.staticAccounts[0];
+  if (!feePayer) {
+    throw new errors.SolanaError(errors.SOLANA_ERROR__TRANSACTION__FAILED_TO_DECOMPILE_FEE_PAYER_MISSING);
+  }
+  const accountMetas = getAccountMetas(compiledMessage);
+  const accountLookupMetas = "addressTableLookups" in compiledMessage && compiledMessage.addressTableLookups !== void 0 && compiledMessage.addressTableLookups.length > 0 ? getAddressLookupMetas(compiledMessage.addressTableLookups, config?.addressesByLookupTableAddress ?? {}) : [];
+  const transactionMetas = [...accountMetas, ...accountLookupMetas];
+  const instructions = compiledMessage.instructions.map(
+    (compiledInstruction) => convertInstruction(compiledInstruction, transactionMetas)
+  );
+  const firstInstruction = instructions[0];
+  const lifetimeConstraint = getLifetimeConstraint(
+    compiledMessage.lifetimeToken,
+    firstInstruction,
+    config?.lastValidBlockHeight
+  );
+  const signatures = convertSignatures(compiledTransaction);
+  return functional.pipe(
+    createTransaction({ version: compiledMessage.version }),
+    (tx) => setTransactionFeePayer(feePayer, tx),
+    (tx) => instructions.reduce((acc, instruction) => {
+      return appendTransactionInstruction(instruction, acc);
+    }, tx),
+    (tx) => "blockhash" in lifetimeConstraint ? setTransactionLifetimeUsingBlockhash(lifetimeConstraint, tx) : setTransactionLifetimeUsingDurableNonce(lifetimeConstraint, tx),
+    (tx) => Object.keys(signatures).length > 0 ? { ...tx, signatures } : tx
+  );
+}
 function upsert(addressMap, address, update) {
   addressMap[address] = update(addressMap[address] ?? { role: AccountRole.READONLY });
 }
@@ -218,13 +388,13 @@ function getAddressMapFromInstructions(feePayer, instructions) {
         if (isWritableRole(entry.role)) {
           switch (entry[TYPE]) {
             case 0 /* FEE_PAYER */:
-              throw new Error(
-                `This transaction includes an address (\`${instruction.programAddress}\`) which is both invoked and set as the fee payer. Program addresses may not pay fees.`
-              );
+              throw new errors.SolanaError(errors.SOLANA_ERROR__TRANSACTION__INVOKED_PROGRAMS_CANNOT_PAY_FEES, {
+                programAddress: instruction.programAddress
+              });
             default:
-              throw new Error(
-                `This transaction includes an address (\`${instruction.programAddress}\`) which is both invoked and marked writable. Program addresses may not be writable.`
-              );
+              throw new errors.SolanaError(errors.SOLANA_ERROR__TRANSACTION__INVOKED_PROGRAMS_MUST_NOT_BE_WRITABLE, {
+                programAddress: instruction.programAddress
+              });
           }
         }
         if (entry[TYPE] === 2 /* STATIC */) {
@@ -289,8 +459,11 @@ function getAddressMapFromInstructions(feePayer, instructions) {
                 addressesOfInvokedPrograms.has(account.address)
               ) {
                 if (isWritableRole(accountMeta.role)) {
-                  throw new Error(
-                    `This transaction includes an address (\`${account.address}\`) which is both invoked and marked writable. Program addresses may not be writable.`
+                  throw new errors.SolanaError(
+                    errors.SOLANA_ERROR__TRANSACTION__INVOKED_PROGRAMS_MUST_NOT_BE_WRITABLE,
+                    {
+                      programAddress: account.address
+                    }
                   );
                 }
                 if (entry.role !== nextRole) {
@@ -467,59 +640,31 @@ function compileMessage(transaction) {
     version: transaction.version
   };
 }
-var lookupTableAddressDescription = __DEV__ ? "The address of the address lookup table account from which instruction addresses should be looked up" : "lookupTableAddress";
-var writableIndicesDescription = __DEV__ ? "The indices of the accounts in the lookup table that should be loaded as writeable" : "writableIndices";
-var readableIndicesDescription = __DEV__ ? "The indices of the accounts in the lookup table that should be loaded as read-only" : "readableIndices";
-var addressTableLookupDescription = __DEV__ ? "A pointer to the address of an address lookup table, along with the readonly/writeable indices of the addresses that should be loaded from it" : "addressTableLookup";
 var memoizedAddressTableLookupEncoder;
 function getAddressTableLookupEncoder() {
   if (!memoizedAddressTableLookupEncoder) {
-    memoizedAddressTableLookupEncoder = codecsDataStructures.getStructEncoder(
+    memoizedAddressTableLookupEncoder = codecsDataStructures.getStructEncoder([
+      ["lookupTableAddress", addresses.getAddressEncoder()],
       [
-        ["lookupTableAddress", addresses.getAddressEncoder({ description: lookupTableAddressDescription })],
-        [
-          "writableIndices",
-          codecsDataStructures.getArrayEncoder(codecsNumbers.getU8Encoder(), {
-            description: writableIndicesDescription,
-            size: codecsNumbers.getShortU16Encoder()
-          })
-        ],
-        [
-          "readableIndices",
-          codecsDataStructures.getArrayEncoder(codecsNumbers.getU8Encoder(), {
-            description: readableIndicesDescription,
-            size: codecsNumbers.getShortU16Encoder()
-          })
-        ]
+        "writableIndices",
+        codecsDataStructures.getArrayEncoder(codecsNumbers.getU8Encoder(), { size: codecsNumbers.getShortU16Encoder() })
       ],
-      { description: addressTableLookupDescription }
-    );
+      [
+        "readableIndices",
+        codecsDataStructures.getArrayEncoder(codecsNumbers.getU8Encoder(), { size: codecsNumbers.getShortU16Encoder() })
+      ]
+    ]);
   }
   return memoizedAddressTableLookupEncoder;
 }
 var memoizedAddressTableLookupDecoder;
 function getAddressTableLookupDecoder() {
   if (!memoizedAddressTableLookupDecoder) {
-    memoizedAddressTableLookupDecoder = codecsDataStructures.getStructDecoder(
-      [
-        ["lookupTableAddress", addresses.getAddressDecoder({ description: lookupTableAddressDescription })],
-        [
-          "writableIndices",
-          codecsDataStructures.getArrayDecoder(codecsNumbers.getU8Decoder(), {
-            description: writableIndicesDescription,
-            size: codecsNumbers.getShortU16Decoder()
-          })
-        ],
-        [
-          "readableIndices",
-          codecsDataStructures.getArrayDecoder(codecsNumbers.getU8Decoder(), {
-            description: readableIndicesDescription,
-            size: codecsNumbers.getShortU16Decoder()
-          })
-        ]
-      ],
-      { description: addressTableLookupDescription }
-    );
+    memoizedAddressTableLookupDecoder = codecsDataStructures.getStructDecoder([
+      ["lookupTableAddress", addresses.getAddressDecoder()],
+      ["writableIndices", codecsDataStructures.getArrayDecoder(codecsNumbers.getU8Decoder(), { size: codecsNumbers.getShortU16Decoder() })],
+      ["readableIndices", codecsDataStructures.getArrayDecoder(codecsNumbers.getU8Decoder(), { size: codecsNumbers.getShortU16Decoder() })]
+    ]);
   }
   return memoizedAddressTableLookupDecoder;
 }
@@ -529,72 +674,34 @@ function getMemoizedU8Encoder() {
     memoizedU8Encoder = codecsNumbers.getU8Encoder();
   return memoizedU8Encoder;
 }
-function getMemoizedU8EncoderDescription(description) {
-  const encoder = getMemoizedU8Encoder();
-  return {
-    ...encoder,
-    description: description ?? encoder.description
-  };
-}
 var memoizedU8Decoder;
 function getMemoizedU8Decoder() {
   if (!memoizedU8Decoder)
     memoizedU8Decoder = codecsNumbers.getU8Decoder();
   return memoizedU8Decoder;
 }
-function getMemoizedU8DecoderDescription(description) {
-  const decoder = getMemoizedU8Decoder();
-  return {
-    ...decoder,
-    description: description ?? decoder.description
-  };
-}
-var numSignerAccountsDescription = __DEV__ ? "The expected number of addresses in the static address list belonging to accounts that are required to sign this transaction" : void 0;
-var numReadonlySignerAccountsDescription = __DEV__ ? "The expected number of addresses in the static address list belonging to accounts that are required to sign this transaction, but may not be writable" : void 0;
-var numReadonlyNonSignerAccountsDescription = __DEV__ ? "The expected number of addresses in the static address list belonging to accounts that are neither signers, nor writable" : void 0;
-var messageHeaderDescription = __DEV__ ? "The transaction message header containing counts of the signer, readonly-signer, and readonly-nonsigner account addresses" : void 0;
 function getMessageHeaderEncoder() {
-  return codecsDataStructures.getStructEncoder(
-    [
-      ["numSignerAccounts", getMemoizedU8EncoderDescription(numSignerAccountsDescription)],
-      ["numReadonlySignerAccounts", getMemoizedU8EncoderDescription(numReadonlySignerAccountsDescription)],
-      ["numReadonlyNonSignerAccounts", getMemoizedU8EncoderDescription(numReadonlyNonSignerAccountsDescription)]
-    ],
-    {
-      description: messageHeaderDescription
-    }
-  );
+  return codecsDataStructures.getStructEncoder([
+    ["numSignerAccounts", getMemoizedU8Encoder()],
+    ["numReadonlySignerAccounts", getMemoizedU8Encoder()],
+    ["numReadonlyNonSignerAccounts", getMemoizedU8Encoder()]
+  ]);
 }
 function getMessageHeaderDecoder() {
-  return codecsDataStructures.getStructDecoder(
-    [
-      ["numSignerAccounts", getMemoizedU8DecoderDescription(numSignerAccountsDescription)],
-      ["numReadonlySignerAccounts", getMemoizedU8DecoderDescription(numReadonlySignerAccountsDescription)],
-      ["numReadonlyNonSignerAccounts", getMemoizedU8DecoderDescription(numReadonlyNonSignerAccountsDescription)]
-    ],
-    {
-      description: messageHeaderDescription
-    }
-  );
+  return codecsDataStructures.getStructDecoder([
+    ["numSignerAccounts", getMemoizedU8Decoder()],
+    ["numReadonlySignerAccounts", getMemoizedU8Decoder()],
+    ["numReadonlyNonSignerAccounts", getMemoizedU8Decoder()]
+  ]);
 }
-var programAddressIndexDescription = __DEV__ ? "The index of the program being called, according to the well-ordered accounts list for this transaction" : "programAddressIndex";
-var accountIndexDescription = __DEV__ ? "The index of an account, according to the well-ordered accounts list for this transaction" : void 0;
-var accountIndicesDescription = __DEV__ ? "An optional list of account indices, according to the well-ordered accounts list for this transaction, in the order in which the program being called expects them" : "accountIndices";
-var dataDescription = __DEV__ ? "An optional buffer of data passed to the instruction" : "data";
 var memoizedGetInstructionEncoder;
 function getInstructionEncoder() {
   if (!memoizedGetInstructionEncoder) {
     memoizedGetInstructionEncoder = codecsCore.mapEncoder(
       codecsDataStructures.getStructEncoder([
-        ["programAddressIndex", codecsNumbers.getU8Encoder({ description: programAddressIndexDescription })],
-        [
-          "accountIndices",
-          codecsDataStructures.getArrayEncoder(codecsNumbers.getU8Encoder({ description: accountIndexDescription }), {
-            description: accountIndicesDescription,
-            size: codecsNumbers.getShortU16Encoder()
-          })
-        ],
-        ["data", codecsDataStructures.getBytesEncoder({ description: dataDescription, size: codecsNumbers.getShortU16Encoder() })]
+        ["programAddressIndex", codecsNumbers.getU8Encoder()],
+        ["accountIndices", codecsDataStructures.getArrayEncoder(codecsNumbers.getU8Encoder(), { size: codecsNumbers.getShortU16Encoder() })],
+        ["data", codecsDataStructures.getBytesEncoder({ size: codecsNumbers.getShortU16Encoder() })]
       ]),
       // Convert an instruction to have all fields defined
       (instruction) => {
@@ -616,15 +723,9 @@ function getInstructionDecoder() {
   if (!memoizedGetInstructionDecoder) {
     memoizedGetInstructionDecoder = codecsCore.mapDecoder(
       codecsDataStructures.getStructDecoder([
-        ["programAddressIndex", codecsNumbers.getU8Decoder({ description: programAddressIndexDescription })],
-        [
-          "accountIndices",
-          codecsDataStructures.getArrayDecoder(codecsNumbers.getU8Decoder({ description: accountIndexDescription }), {
-            description: accountIndicesDescription,
-            size: codecsNumbers.getShortU16Decoder()
-          })
-        ],
-        ["data", codecsDataStructures.getBytesDecoder({ description: dataDescription, size: codecsNumbers.getShortU16Decoder() })]
+        ["programAddressIndex", codecsNumbers.getU8Decoder()],
+        ["accountIndices", codecsDataStructures.getArrayDecoder(codecsNumbers.getU8Decoder(), { size: codecsNumbers.getShortU16Decoder() })],
+        ["data", codecsDataStructures.getBytesDecoder({ size: codecsNumbers.getShortU16Decoder() })]
       ]),
       // Convert an instruction to exclude optional fields if they are empty
       (instruction) => {
@@ -643,47 +744,40 @@ function getInstructionDecoder() {
   return memoizedGetInstructionDecoder;
 }
 var VERSION_FLAG_MASK = 128;
-var BASE_CONFIG = {
-  description: __DEV__ ? "A single byte that encodes the version of the transaction" : "",
-  fixedSize: null,
-  maxSize: 1
-};
-function decode(bytes, offset = 0) {
-  const firstByte = bytes[offset];
-  if ((firstByte & VERSION_FLAG_MASK) === 0) {
-    return ["legacy", offset];
-  } else {
-    const version = firstByte ^ VERSION_FLAG_MASK;
-    return [version, offset + 1];
-  }
-}
-function encode(value) {
-  if (value === "legacy") {
-    return new Uint8Array();
-  }
-  if (value < 0 || value > 127) {
-    throw new Error(`Transaction version must be in the range [0, 127]. \`${value}\` given.`);
-  }
-  return new Uint8Array([value | VERSION_FLAG_MASK]);
+function getTransactionVersionEncoder() {
+  return codecsCore.createEncoder({
+    getSizeFromValue: (value) => value === "legacy" ? 0 : 1,
+    maxSize: 1,
+    write: (value, bytes, offset) => {
+      if (value === "legacy") {
+        return offset;
+      }
+      if (value < 0 || value > 127) {
+        throw new errors.SolanaError(errors.SOLANA_ERROR__TRANSACTION__VERSION_NUMBER_OUT_OF_RANGE, {
+          actualVersion: value
+        });
+      }
+      bytes.set([value | VERSION_FLAG_MASK], offset);
+      return offset + 1;
+    }
+  });
 }
 function getTransactionVersionDecoder() {
-  return {
-    ...BASE_CONFIG,
-    decode
-  };
-}
-function getTransactionVersionEncoder() {
-  return {
-    ...BASE_CONFIG,
-    encode
-  };
+  return codecsCore.createDecoder({
+    maxSize: 1,
+    read: (bytes, offset) => {
+      const firstByte = bytes[offset];
+      if ((firstByte & VERSION_FLAG_MASK) === 0) {
+        return ["legacy", offset];
+      } else {
+        const version = firstByte ^ VERSION_FLAG_MASK;
+        return [version, offset + 1];
+      }
+    }
+  });
 }
 
 // src/serializers/message.ts
-var staticAccountsDescription = __DEV__ ? "A compact-array of static account addresses belonging to this transaction" : "staticAccounts";
-var lifetimeTokenDescription = __DEV__ ? "A 32-byte token that specifies the lifetime of this transaction (eg. a recent blockhash, or a durable nonce)" : "lifetimeToken";
-var instructionsDescription = __DEV__ ? "A compact-array of instructions belonging to this transaction" : "instructions";
-var addressTableLookupsDescription = __DEV__ ? "A compact array of address table lookups belonging to this transaction" : "addressTableLookups";
 function getCompiledMessageLegacyEncoder() {
   return codecsDataStructures.getStructEncoder(getPreludeStructEncoderTuple());
 }
@@ -708,91 +802,48 @@ function getPreludeStructEncoderTuple() {
   return [
     ["version", getTransactionVersionEncoder()],
     ["header", getMessageHeaderEncoder()],
-    [
-      "staticAccounts",
-      codecsDataStructures.getArrayEncoder(addresses.getAddressEncoder(), {
-        description: staticAccountsDescription,
-        size: codecsNumbers.getShortU16Encoder()
-      })
-    ],
-    [
-      "lifetimeToken",
-      codecsStrings.getStringEncoder({
-        description: lifetimeTokenDescription,
-        encoding: codecsStrings.getBase58Encoder(),
-        size: 32
-      })
-    ],
-    [
-      "instructions",
-      codecsDataStructures.getArrayEncoder(getInstructionEncoder(), {
-        description: instructionsDescription,
-        size: codecsNumbers.getShortU16Encoder()
-      })
-    ]
+    ["staticAccounts", codecsDataStructures.getArrayEncoder(addresses.getAddressEncoder(), { size: codecsNumbers.getShortU16Encoder() })],
+    ["lifetimeToken", codecsStrings.getStringEncoder({ encoding: codecsStrings.getBase58Encoder(), size: 32 })],
+    ["instructions", codecsDataStructures.getArrayEncoder(getInstructionEncoder(), { size: codecsNumbers.getShortU16Encoder() })]
   ];
 }
 function getPreludeStructDecoderTuple() {
   return [
     ["version", getTransactionVersionDecoder()],
     ["header", getMessageHeaderDecoder()],
-    [
-      "staticAccounts",
-      codecsDataStructures.getArrayDecoder(addresses.getAddressDecoder(), {
-        description: staticAccountsDescription,
-        size: codecsNumbers.getShortU16Decoder()
-      })
-    ],
-    [
-      "lifetimeToken",
-      codecsStrings.getStringDecoder({
-        description: lifetimeTokenDescription,
-        encoding: codecsStrings.getBase58Decoder(),
-        size: 32
-      })
-    ],
-    [
-      "instructions",
-      codecsDataStructures.getArrayDecoder(getInstructionDecoder(), {
-        description: instructionsDescription,
-        size: codecsNumbers.getShortU16Decoder()
-      })
-    ],
+    ["staticAccounts", codecsDataStructures.getArrayDecoder(addresses.getAddressDecoder(), { size: codecsNumbers.getShortU16Decoder() })],
+    ["lifetimeToken", codecsStrings.getStringDecoder({ encoding: codecsStrings.getBase58Decoder(), size: 32 })],
+    ["instructions", codecsDataStructures.getArrayDecoder(getInstructionDecoder(), { size: codecsNumbers.getShortU16Decoder() })],
     ["addressTableLookups", getAddressTableLookupArrayDecoder()]
   ];
 }
 function getAddressTableLookupArrayEncoder() {
-  return codecsDataStructures.getArrayEncoder(getAddressTableLookupEncoder(), {
-    description: addressTableLookupsDescription,
-    size: codecsNumbers.getShortU16Encoder()
-  });
+  return codecsDataStructures.getArrayEncoder(getAddressTableLookupEncoder(), { size: codecsNumbers.getShortU16Encoder() });
 }
 function getAddressTableLookupArrayDecoder() {
-  return codecsDataStructures.getArrayDecoder(getAddressTableLookupDecoder(), {
-    description: addressTableLookupsDescription,
-    size: codecsNumbers.getShortU16Decoder()
-  });
+  return codecsDataStructures.getArrayDecoder(getAddressTableLookupDecoder(), { size: codecsNumbers.getShortU16Decoder() });
 }
-var messageDescription = __DEV__ ? "The wire format of a Solana transaction message" : "message";
 function getCompiledMessageEncoder() {
-  return {
-    description: messageDescription,
-    encode: (compiledMessage) => {
+  return codecsCore.createEncoder({
+    getSizeFromValue: (compiledMessage) => {
       if (compiledMessage.version === "legacy") {
-        return getCompiledMessageLegacyEncoder().encode(compiledMessage);
+        return getCompiledMessageLegacyEncoder().getSizeFromValue(compiledMessage);
       } else {
-        return getCompiledMessageVersionedEncoder().encode(compiledMessage);
+        return getCompiledMessageVersionedEncoder().getSizeFromValue(compiledMessage);
       }
     },
-    fixedSize: null,
-    maxSize: null
-  };
+    write: (compiledMessage, bytes, offset) => {
+      if (compiledMessage.version === "legacy") {
+        return getCompiledMessageLegacyEncoder().write(compiledMessage, bytes, offset);
+      } else {
+        return getCompiledMessageVersionedEncoder().write(compiledMessage, bytes, offset);
+      }
+    }
+  });
 }
 function getCompiledMessageDecoder() {
   return codecsCore.mapDecoder(
-    codecsDataStructures.getStructDecoder(getPreludeStructDecoderTuple(), {
-      description: messageDescription
-    }),
+    codecsDataStructures.getStructDecoder(getPreludeStructDecoderTuple()),
     ({ addressTableLookups, ...restOfMessage }) => {
       if (restOfMessage.version === "legacy" || !addressTableLookups?.length) {
         return restOfMessage;
@@ -822,168 +873,36 @@ function getCompiledTransaction(transaction) {
     signatures
   };
 }
-function getAccountMetas(message) {
-  const { header } = message;
-  const numWritableSignerAccounts = header.numSignerAccounts - header.numReadonlySignerAccounts;
-  const numWritableNonSignerAccounts = message.staticAccounts.length - header.numSignerAccounts - header.numReadonlyNonSignerAccounts;
-  const accountMetas = [];
-  let accountIndex = 0;
-  for (let i = 0; i < numWritableSignerAccounts; i++) {
-    accountMetas.push({
-      address: message.staticAccounts[accountIndex],
-      role: AccountRole.WRITABLE_SIGNER
-    });
-    accountIndex++;
-  }
-  for (let i = 0; i < header.numReadonlySignerAccounts; i++) {
-    accountMetas.push({
-      address: message.staticAccounts[accountIndex],
-      role: AccountRole.READONLY_SIGNER
-    });
-    accountIndex++;
-  }
-  for (let i = 0; i < numWritableNonSignerAccounts; i++) {
-    accountMetas.push({
-      address: message.staticAccounts[accountIndex],
-      role: AccountRole.WRITABLE
-    });
-    accountIndex++;
-  }
-  for (let i = 0; i < header.numReadonlyNonSignerAccounts; i++) {
-    accountMetas.push({
-      address: message.staticAccounts[accountIndex],
-      role: AccountRole.READONLY
-    });
-    accountIndex++;
-  }
-  return accountMetas;
-}
-function convertInstruction(instruction, accountMetas) {
-  const programAddress = accountMetas[instruction.programAddressIndex]?.address;
-  if (!programAddress) {
-    throw new Error(`Could not find program address at index ${instruction.programAddressIndex}`);
-  }
-  const accounts = instruction.accountIndices?.map((accountIndex) => accountMetas[accountIndex]);
-  const { data } = instruction;
-  return {
-    programAddress,
-    ...accounts && accounts.length ? { accounts } : {},
-    ...data && data.length ? { data } : {}
-  };
-}
-function getLifetimeConstraint(messageLifetimeToken, firstInstruction, lastValidBlockHeight) {
-  if (!firstInstruction || !isAdvanceNonceAccountInstruction(firstInstruction)) {
-    return {
-      blockhash: messageLifetimeToken,
-      lastValidBlockHeight: lastValidBlockHeight ?? 2n ** 64n - 1n
-      // U64 MAX
-    };
-  } else {
-    const nonceAccountAddress = firstInstruction.accounts[0].address;
-    addresses.assertIsAddress(nonceAccountAddress);
-    const nonceAuthorityAddress = firstInstruction.accounts[2].address;
-    addresses.assertIsAddress(nonceAuthorityAddress);
-    return {
-      nonce: messageLifetimeToken,
-      nonceAccountAddress,
-      nonceAuthorityAddress
-    };
-  }
-}
-function convertSignatures(compiledTransaction) {
-  const {
-    compiledMessage: { staticAccounts },
-    signatures
-  } = compiledTransaction;
-  return signatures.reduce((acc, sig, index) => {
-    const allZeros = sig.every((byte) => byte === 0);
-    if (allZeros)
-      return acc;
-    const address = staticAccounts[index];
-    return { ...acc, [address]: sig };
-  }, {});
-}
-function decompileTransaction(compiledTransaction, lastValidBlockHeight) {
-  const { compiledMessage } = compiledTransaction;
-  if ("addressTableLookups" in compiledMessage && compiledMessage.addressTableLookups.length > 0) {
-    throw new Error("Cannot convert transaction with addressTableLookups");
-  }
-  const feePayer = compiledMessage.staticAccounts[0];
-  if (!feePayer)
-    throw new Error("No fee payer set in CompiledTransaction");
-  const accountMetas = getAccountMetas(compiledMessage);
-  const instructions = compiledMessage.instructions.map(
-    (compiledInstruction) => convertInstruction(compiledInstruction, accountMetas)
-  );
-  const firstInstruction = instructions[0];
-  const lifetimeConstraint = getLifetimeConstraint(
-    compiledMessage.lifetimeToken,
-    firstInstruction,
-    lastValidBlockHeight
-  );
-  const signatures = convertSignatures(compiledTransaction);
-  return functional.pipe(
-    createTransaction({ version: compiledMessage.version }),
-    (tx) => setTransactionFeePayer(feePayer, tx),
-    (tx) => instructions.reduce((acc, instruction) => {
-      return appendTransactionInstruction(instruction, acc);
-    }, tx),
-    (tx) => "blockhash" in lifetimeConstraint ? setTransactionLifetimeUsingBlockhash(lifetimeConstraint, tx) : setTransactionLifetimeUsingDurableNonce(lifetimeConstraint, tx),
-    (tx) => compiledTransaction.signatures.length ? { ...tx, signatures } : tx
-  );
-}
 
 // src/serializers/transaction.ts
-var signaturesDescription = __DEV__ ? "A compact array of 64-byte, base-64 encoded Ed25519 signatures" : "signatures";
-var transactionDescription = __DEV__ ? "The wire format of a Solana transaction" : "transaction";
 function getCompiledTransactionEncoder() {
-  return codecsDataStructures.getStructEncoder(
-    [
-      [
-        "signatures",
-        codecsDataStructures.getArrayEncoder(codecsDataStructures.getBytesEncoder({ size: 64 }), {
-          description: signaturesDescription,
-          size: codecsNumbers.getShortU16Encoder()
-        })
-      ],
-      ["compiledMessage", getCompiledMessageEncoder()]
-    ],
-    {
-      description: transactionDescription
-    }
-  );
-}
-function getSignatureDecoder() {
-  return codecsCore.mapDecoder(codecsDataStructures.getBytesDecoder({ size: 64 }), (bytes) => bytes);
+  return codecsDataStructures.getStructEncoder([
+    ["signatures", codecsDataStructures.getArrayEncoder(codecsDataStructures.getBytesEncoder({ size: 64 }), { size: codecsNumbers.getShortU16Encoder() })],
+    ["compiledMessage", getCompiledMessageEncoder()]
+  ]);
 }
 function getCompiledTransactionDecoder() {
-  return codecsDataStructures.getStructDecoder(
+  return codecsDataStructures.getStructDecoder([
     [
-      [
-        "signatures",
-        codecsDataStructures.getArrayDecoder(getSignatureDecoder(), {
-          description: signaturesDescription,
-          size: codecsNumbers.getShortU16Decoder()
-        })
-      ],
-      ["compiledMessage", getCompiledMessageDecoder()]
+      "signatures",
+      codecsDataStructures.getArrayDecoder(codecsDataStructures.getBytesDecoder({ size: 64 }), {
+        size: codecsNumbers.getShortU16Decoder()
+      })
     ],
-    {
-      description: transactionDescription
-    }
-  );
+    ["compiledMessage", getCompiledMessageDecoder()]
+  ]);
 }
 function getTransactionEncoder() {
   return codecsCore.mapEncoder(getCompiledTransactionEncoder(), getCompiledTransaction);
 }
-function getTransactionDecoder(lastValidBlockHeight) {
+function getTransactionDecoder(config) {
   return codecsCore.mapDecoder(
     getCompiledTransactionDecoder(),
-    (compiledTransaction) => decompileTransaction(compiledTransaction, lastValidBlockHeight)
+    (compiledTransaction) => decompileTransaction(compiledTransaction, config)
   );
 }
-function getTransactionCodec(lastValidBlockHeight) {
-  return codecsCore.combineCodec(getTransactionEncoder(), getTransactionDecoder(lastValidBlockHeight));
+function getTransactionCodec(config) {
+  return codecsCore.combineCodec(getTransactionEncoder(), getTransactionDecoder(config));
 }
 var base58Decoder;
 function getSignatureFromTransaction(transaction) {
@@ -991,11 +910,9 @@ function getSignatureFromTransaction(transaction) {
     base58Decoder = codecsStrings.getBase58Decoder();
   const signatureBytes = transaction.signatures[transaction.feePayer];
   if (!signatureBytes) {
-    throw new Error(
-      "Could not determine this transaction's signature. Make sure that the transaction has been signed by its fee payer."
-    );
+    throw new errors.SolanaError(errors.SOLANA_ERROR__TRANSACTION__FEE_PAYER_SIGNATURE_MISSING);
   }
-  const transactionSignature = base58Decoder.decode(signatureBytes)[0];
+  const transactionSignature = base58Decoder.decode(signatureBytes);
   return transactionSignature;
 }
 async function partiallySignTransaction(keyPairs, transaction) {
@@ -1026,34 +943,45 @@ async function signTransaction(keyPairs, transaction) {
 function assertTransactionIsFullySigned(transaction) {
   const signerAddressesFromInstructions = transaction.instructions.flatMap((i) => i.accounts?.filter((a) => isSignerRole(a.role)) ?? []).map((a) => a.address);
   const requiredSigners = /* @__PURE__ */ new Set([transaction.feePayer, ...signerAddressesFromInstructions]);
+  const missingSigs = [];
   requiredSigners.forEach((address) => {
     if (!transaction.signatures[address]) {
-      throw new Error(`Transaction is missing signature for address \`${address}\``);
+      missingSigs.push(address);
     }
   });
+  if (missingSigs.length > 0) {
+    throw new errors.SolanaError(errors.SOLANA_ERROR__TRANSACTION__SIGNATURES_MISSING, {
+      addresses: missingSigs
+    });
+  }
 }
 function getBase64EncodedWireTransaction(transaction) {
   const wireTransactionBytes = getTransactionEncoder().encode(transaction);
-  return codecsStrings.getBase64Decoder().decode(wireTransactionBytes)[0];
+  return codecsStrings.getBase64Decoder().decode(wireTransactionBytes);
 }
 
 exports.appendTransactionInstruction = appendTransactionInstruction;
-exports.assertIsBlockhash = assertIsBlockhash;
+exports.appendTransactionInstructions = appendTransactionInstructions;
 exports.assertIsDurableNonceTransaction = assertIsDurableNonceTransaction;
+exports.assertIsTransactionWithBlockhashLifetime = assertIsTransactionWithBlockhashLifetime;
 exports.assertTransactionIsFullySigned = assertTransactionIsFullySigned;
 exports.compileMessage = compileMessage;
 exports.createTransaction = createTransaction;
+exports.decompileTransaction = decompileTransaction;
 exports.getBase64EncodedWireTransaction = getBase64EncodedWireTransaction;
 exports.getCompiledMessageCodec = getCompiledMessageCodec;
 exports.getCompiledMessageDecoder = getCompiledMessageDecoder;
 exports.getCompiledMessageEncoder = getCompiledMessageEncoder;
+exports.getCompiledTransactionDecoder = getCompiledTransactionDecoder;
 exports.getSignatureFromTransaction = getSignatureFromTransaction;
 exports.getTransactionCodec = getTransactionCodec;
 exports.getTransactionDecoder = getTransactionDecoder;
 exports.getTransactionEncoder = getTransactionEncoder;
+exports.getUnsignedTransaction = getUnsignedTransaction;
 exports.isAdvanceNonceAccountInstruction = isAdvanceNonceAccountInstruction;
 exports.partiallySignTransaction = partiallySignTransaction;
 exports.prependTransactionInstruction = prependTransactionInstruction;
+exports.prependTransactionInstructions = prependTransactionInstructions;
 exports.setTransactionFeePayer = setTransactionFeePayer;
 exports.setTransactionLifetimeUsingBlockhash = setTransactionLifetimeUsingBlockhash;
 exports.setTransactionLifetimeUsingDurableNonce = setTransactionLifetimeUsingDurableNonce;