@solana/transactions 2.0.0-experimental.ef09aec → 2.0.0-experimental.ef2569b

package/dist/index.node.js

@@ -1,13 +1,12 @@
 import { getBase58Encoder, getBase58Decoder, getBase64Decoder, getStringEncoder, getStringDecoder } from '@solana/codecs-strings';
 import { getAddressFromPublicKey, getAddressComparator, getAddressEncoder, getAddressDecoder, assertIsAddress } from '@solana/addresses';
-import { mapDecoder, combineCodec, mapEncoder } from '@solana/codecs-core';
+import { createEncoder, mapDecoder, combineCodec, mapEncoder, createDecoder } from '@solana/codecs-core';
 import { getStructDecoder, getStructEncoder, getArrayEncoder, getArrayDecoder, getBytesEncoder, getBytesDecoder } from '@solana/codecs-data-structures';
 import { getShortU16Encoder, getShortU16Decoder, getU8Encoder, getU8Decoder } from '@solana/codecs-numbers';
 import { pipe } from '@solana/functional';
 import { signBytes } from '@solana/keys';
 
-// ../build-scripts/env-shim.ts
-var __DEV__ = /* @__PURE__ */ (() => process["env"].NODE_ENV === "development")();
+// src/blockhash.ts
 
 // src/unsigned-transaction.ts
 function getUnsignedTransaction(transaction) {
@@ -47,6 +46,22 @@ function assertIsBlockhash(putativeBlockhash) {
     });
   }
 }
+function isTransactionWithBlockhashLifetime(transaction) {
+  const lifetimeConstraintShapeMatches = "lifetimeConstraint" in transaction && typeof transaction.lifetimeConstraint.blockhash === "string" && typeof transaction.lifetimeConstraint.lastValidBlockHeight === "bigint";
+  if (!lifetimeConstraintShapeMatches)
+    return false;
+  try {
+    assertIsBlockhash(transaction.lifetimeConstraint.blockhash);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function assertIsTransactionWithBlockhashLifetime(transaction) {
+  if (!isTransactionWithBlockhashLifetime(transaction)) {
+    throw new Error("Transaction does not have a blockhash lifetime");
+  }
+}
 function setTransactionLifetimeUsingBlockhash(blockhashLifetimeConstraint, transaction) {
   if ("lifetimeConstraint" in transaction && transaction.lifetimeConstraint.blockhash === blockhashLifetimeConstraint.blockhash && transaction.lifetimeConstraint.lastValidBlockHeight === blockhashLifetimeConstraint.lastValidBlockHeight) {
     return transaction;
@@ -465,59 +480,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 = getStructEncoder(
+    memoizedAddressTableLookupEncoder = getStructEncoder([
+      ["lookupTableAddress", getAddressEncoder()],
       [
-        ["lookupTableAddress", getAddressEncoder({ description: lookupTableAddressDescription })],
-        [
-          "writableIndices",
-          getArrayEncoder(getU8Encoder(), {
-            description: writableIndicesDescription,
-            size: getShortU16Encoder()
-          })
-        ],
-        [
-          "readableIndices",
-          getArrayEncoder(getU8Encoder(), {
-            description: readableIndicesDescription,
-            size: getShortU16Encoder()
-          })
-        ]
+        "writableIndices",
+        getArrayEncoder(getU8Encoder(), { size: getShortU16Encoder() })
       ],
-      { description: addressTableLookupDescription }
-    );
+      [
+        "readableIndices",
+        getArrayEncoder(getU8Encoder(), { size: getShortU16Encoder() })
+      ]
+    ]);
   }
   return memoizedAddressTableLookupEncoder;
 }
 var memoizedAddressTableLookupDecoder;
 function getAddressTableLookupDecoder() {
   if (!memoizedAddressTableLookupDecoder) {
-    memoizedAddressTableLookupDecoder = getStructDecoder(
-      [
-        ["lookupTableAddress", getAddressDecoder({ description: lookupTableAddressDescription })],
-        [
-          "writableIndices",
-          getArrayDecoder(getU8Decoder(), {
-            description: writableIndicesDescription,
-            size: getShortU16Decoder()
-          })
-        ],
-        [
-          "readableIndices",
-          getArrayDecoder(getU8Decoder(), {
-            description: readableIndicesDescription,
-            size: getShortU16Decoder()
-          })
-        ]
-      ],
-      { description: addressTableLookupDescription }
-    );
+    memoizedAddressTableLookupDecoder = getStructDecoder([
+      ["lookupTableAddress", getAddressDecoder()],
+      ["writableIndices", getArrayDecoder(getU8Decoder(), { size: getShortU16Decoder() })],
+      ["readableIndices", getArrayDecoder(getU8Decoder(), { size: getShortU16Decoder() })]
+    ]);
   }
   return memoizedAddressTableLookupDecoder;
 }
@@ -527,72 +514,34 @@ function getMemoizedU8Encoder() {
     memoizedU8Encoder = getU8Encoder();
   return memoizedU8Encoder;
 }
-function getMemoizedU8EncoderDescription(description) {
-  const encoder = getMemoizedU8Encoder();
-  return {
-    ...encoder,
-    description: description ?? encoder.description
-  };
-}
 var memoizedU8Decoder;
 function getMemoizedU8Decoder() {
   if (!memoizedU8Decoder)
     memoizedU8Decoder = 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 getStructEncoder(
-    [
-      ["numSignerAccounts", getMemoizedU8EncoderDescription(numSignerAccountsDescription)],
-      ["numReadonlySignerAccounts", getMemoizedU8EncoderDescription(numReadonlySignerAccountsDescription)],
-      ["numReadonlyNonSignerAccounts", getMemoizedU8EncoderDescription(numReadonlyNonSignerAccountsDescription)]
-    ],
-    {
-      description: messageHeaderDescription
-    }
-  );
+  return getStructEncoder([
+    ["numSignerAccounts", getMemoizedU8Encoder()],
+    ["numReadonlySignerAccounts", getMemoizedU8Encoder()],
+    ["numReadonlyNonSignerAccounts", getMemoizedU8Encoder()]
+  ]);
 }
 function getMessageHeaderDecoder() {
-  return getStructDecoder(
-    [
-      ["numSignerAccounts", getMemoizedU8DecoderDescription(numSignerAccountsDescription)],
-      ["numReadonlySignerAccounts", getMemoizedU8DecoderDescription(numReadonlySignerAccountsDescription)],
-      ["numReadonlyNonSignerAccounts", getMemoizedU8DecoderDescription(numReadonlyNonSignerAccountsDescription)]
-    ],
-    {
-      description: messageHeaderDescription
-    }
-  );
+  return 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 = mapEncoder(
       getStructEncoder([
-        ["programAddressIndex", getU8Encoder({ description: programAddressIndexDescription })],
-        [
-          "accountIndices",
-          getArrayEncoder(getU8Encoder({ description: accountIndexDescription }), {
-            description: accountIndicesDescription,
-            size: getShortU16Encoder()
-          })
-        ],
-        ["data", getBytesEncoder({ description: dataDescription, size: getShortU16Encoder() })]
+        ["programAddressIndex", getU8Encoder()],
+        ["accountIndices", getArrayEncoder(getU8Encoder(), { size: getShortU16Encoder() })],
+        ["data", getBytesEncoder({ size: getShortU16Encoder() })]
       ]),
       // Convert an instruction to have all fields defined
       (instruction) => {
@@ -614,15 +563,9 @@ function getInstructionDecoder() {
   if (!memoizedGetInstructionDecoder) {
     memoizedGetInstructionDecoder = mapDecoder(
       getStructDecoder([
-        ["programAddressIndex", getU8Decoder({ description: programAddressIndexDescription })],
-        [
-          "accountIndices",
-          getArrayDecoder(getU8Decoder({ description: accountIndexDescription }), {
-            description: accountIndicesDescription,
-            size: getShortU16Decoder()
-          })
-        ],
-        ["data", getBytesDecoder({ description: dataDescription, size: getShortU16Decoder() })]
+        ["programAddressIndex", getU8Decoder()],
+        ["accountIndices", getArrayDecoder(getU8Decoder(), { size: getShortU16Decoder() })],
+        ["data", getBytesDecoder({ size: getShortU16Decoder() })]
       ]),
       // Convert an instruction to exclude optional fields if they are empty
       (instruction) => {
@@ -641,47 +584,38 @@ 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 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 Error(`Transaction version must be in the range [0, 127]. \`${value}\` given.`);
+      }
+      bytes.set([value | VERSION_FLAG_MASK], offset);
+      return offset + 1;
+    }
+  });
 }
 function getTransactionVersionDecoder() {
-  return {
-    ...BASE_CONFIG,
-    decode
-  };
-}
-function getTransactionVersionEncoder() {
-  return {
-    ...BASE_CONFIG,
-    encode
-  };
+  return 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 getStructEncoder(getPreludeStructEncoderTuple());
 }
@@ -706,98 +640,52 @@ function getPreludeStructEncoderTuple() {
   return [
     ["version", getTransactionVersionEncoder()],
     ["header", getMessageHeaderEncoder()],
-    [
-      "staticAccounts",
-      getArrayEncoder(getAddressEncoder(), {
-        description: staticAccountsDescription,
-        size: getShortU16Encoder()
-      })
-    ],
-    [
-      "lifetimeToken",
-      getStringEncoder({
-        description: lifetimeTokenDescription,
-        encoding: getBase58Encoder(),
-        size: 32
-      })
-    ],
-    [
-      "instructions",
-      getArrayEncoder(getInstructionEncoder(), {
-        description: instructionsDescription,
-        size: getShortU16Encoder()
-      })
-    ]
+    ["staticAccounts", getArrayEncoder(getAddressEncoder(), { size: getShortU16Encoder() })],
+    ["lifetimeToken", getStringEncoder({ encoding: getBase58Encoder(), size: 32 })],
+    ["instructions", getArrayEncoder(getInstructionEncoder(), { size: getShortU16Encoder() })]
   ];
 }
 function getPreludeStructDecoderTuple() {
   return [
     ["version", getTransactionVersionDecoder()],
     ["header", getMessageHeaderDecoder()],
-    [
-      "staticAccounts",
-      getArrayDecoder(getAddressDecoder(), {
-        description: staticAccountsDescription,
-        size: getShortU16Decoder()
-      })
-    ],
-    [
-      "lifetimeToken",
-      getStringDecoder({
-        description: lifetimeTokenDescription,
-        encoding: getBase58Decoder(),
-        size: 32
-      })
-    ],
-    [
-      "instructions",
-      getArrayDecoder(getInstructionDecoder(), {
-        description: instructionsDescription,
-        size: getShortU16Decoder()
-      })
-    ],
+    ["staticAccounts", getArrayDecoder(getAddressDecoder(), { size: getShortU16Decoder() })],
+    ["lifetimeToken", getStringDecoder({ encoding: getBase58Decoder(), size: 32 })],
+    ["instructions", getArrayDecoder(getInstructionDecoder(), { size: getShortU16Decoder() })],
     ["addressTableLookups", getAddressTableLookupArrayDecoder()]
   ];
 }
 function getAddressTableLookupArrayEncoder() {
-  return getArrayEncoder(getAddressTableLookupEncoder(), {
-    description: addressTableLookupsDescription,
-    size: getShortU16Encoder()
-  });
+  return getArrayEncoder(getAddressTableLookupEncoder(), { size: getShortU16Encoder() });
 }
 function getAddressTableLookupArrayDecoder() {
-  return getArrayDecoder(getAddressTableLookupDecoder(), {
-    description: addressTableLookupsDescription,
-    size: getShortU16Decoder()
-  });
+  return getArrayDecoder(getAddressTableLookupDecoder(), { size: getShortU16Decoder() });
 }
-var messageDescription = __DEV__ ? "The wire format of a Solana transaction message" : "message";
 function getCompiledMessageEncoder() {
-  return {
-    description: messageDescription,
-    encode: (compiledMessage) => {
+  return 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 mapDecoder(
-    getStructDecoder(getPreludeStructDecoderTuple(), {
-      description: messageDescription
-    }),
-    ({ addressTableLookups, ...restOfMessage }) => {
-      if (restOfMessage.version === "legacy" || !addressTableLookups?.length) {
-        return restOfMessage;
-      }
-      return { ...restOfMessage, addressTableLookups };
+  return mapDecoder(getStructDecoder(getPreludeStructDecoderTuple()), ({ addressTableLookups, ...restOfMessage }) => {
+    if (restOfMessage.version === "legacy" || !addressTableLookups?.length) {
+      return restOfMessage;
     }
-  );
+    return { ...restOfMessage, addressTableLookups };
+  });
 }
 function getCompiledMessageCodec() {
   return combineCodec(getCompiledMessageEncoder(), getCompiledMessageDecoder());
@@ -932,44 +820,22 @@ function decompileTransaction(compiledTransaction, lastValidBlockHeight) {
 }
 
 // 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 getStructEncoder(
-    [
-      [
-        "signatures",
-        getArrayEncoder(getBytesEncoder({ size: 64 }), {
-          description: signaturesDescription,
-          size: getShortU16Encoder()
-        })
-      ],
-      ["compiledMessage", getCompiledMessageEncoder()]
-    ],
-    {
-      description: transactionDescription
-    }
-  );
-}
-function getSignatureDecoder() {
-  return mapDecoder(getBytesDecoder({ size: 64 }), (bytes) => bytes);
+  return getStructEncoder([
+    ["signatures", getArrayEncoder(getBytesEncoder({ size: 64 }), { size: getShortU16Encoder() })],
+    ["compiledMessage", getCompiledMessageEncoder()]
+  ]);
 }
 function getCompiledTransactionDecoder() {
-  return getStructDecoder(
+  return getStructDecoder([
     [
-      [
-        "signatures",
-        getArrayDecoder(getSignatureDecoder(), {
-          description: signaturesDescription,
-          size: getShortU16Decoder()
-        })
-      ],
-      ["compiledMessage", getCompiledMessageDecoder()]
+      "signatures",
+      getArrayDecoder(getBytesDecoder({ size: 64 }), {
+        size: getShortU16Decoder()
+      })
     ],
-    {
-      description: transactionDescription
-    }
-  );
+    ["compiledMessage", getCompiledMessageDecoder()]
+  ]);
 }
 function getTransactionEncoder() {
   return mapEncoder(getCompiledTransactionEncoder(), getCompiledTransaction);
@@ -993,7 +859,7 @@ function getSignatureFromTransaction(transaction) {
       "Could not determine this transaction's signature. Make sure that the transaction has been signed by its fee payer."
     );
   }
-  const transactionSignature = base58Decoder.decode(signatureBytes)[0];
+  const transactionSignature = base58Decoder.decode(signatureBytes);
   return transactionSignature;
 }
 async function partiallySignTransaction(keyPairs, transaction) {
@@ -1032,9 +898,9 @@ function assertTransactionIsFullySigned(transaction) {
 }
 function getBase64EncodedWireTransaction(transaction) {
   const wireTransactionBytes = getTransactionEncoder().encode(transaction);
-  return getBase64Decoder().decode(wireTransactionBytes)[0];
+  return getBase64Decoder().decode(wireTransactionBytes);
 }
 
-export { appendTransactionInstruction, assertIsBlockhash, assertIsDurableNonceTransaction, assertTransactionIsFullySigned, compileMessage, createTransaction, getBase64EncodedWireTransaction, getCompiledMessageCodec, getCompiledMessageDecoder, getCompiledMessageEncoder, getSignatureFromTransaction, getTransactionCodec, getTransactionDecoder, getTransactionEncoder, isAdvanceNonceAccountInstruction, partiallySignTransaction, prependTransactionInstruction, setTransactionFeePayer, setTransactionLifetimeUsingBlockhash, setTransactionLifetimeUsingDurableNonce, signTransaction };
+export { appendTransactionInstruction, assertIsBlockhash, assertIsDurableNonceTransaction, assertIsTransactionWithBlockhashLifetime, assertTransactionIsFullySigned, compileMessage, createTransaction, getBase64EncodedWireTransaction, getCompiledMessageCodec, getCompiledMessageDecoder, getCompiledMessageEncoder, getSignatureFromTransaction, getTransactionCodec, getTransactionDecoder, getTransactionEncoder, isAdvanceNonceAccountInstruction, partiallySignTransaction, prependTransactionInstruction, setTransactionFeePayer, setTransactionLifetimeUsingBlockhash, setTransactionLifetimeUsingDurableNonce, signTransaction };
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=index.node.js.map