@solana/transactions 2.0.0-experimental.7da1908 → 2.0.0-experimental.819a6f7

package/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2018 Solana Labs, Inc
+Copyright (c) 2023 Solana Labs, Inc
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

package/dist/index.browser.cjs

@@ -2,6 +2,9 @@
 
 var umiSerializers = require('@metaplex-foundation/umi-serializers');
 var addresses = require('@solana/addresses');
+var codecsDataStructures = require('@solana/codecs-data-structures');
+var codecsNumbers = require('@solana/codecs-numbers');
+var codecsCore = require('@solana/codecs-core');
 var keys = require('@solana/keys');
 
 // ../build-scripts/env-shim.ts
@@ -230,7 +233,7 @@ function getAddressMapFromInstructions(feePayer, instructions) {
                 const shouldReplaceEntry = (
                   // Consider using the new LOOKUP_TABLE if its address is different...
                   entry.lookupTableAddress !== accountMeta.lookupTableAddress && // ...and sorts before the existing one.
-                  (addressComparator || (addressComparator = addresses.getBase58EncodedAddressComparator()))(
+                  (addressComparator || (addressComparator = addresses.getAddressComparator()))(
                     accountMeta.lookupTableAddress,
                     entry.lookupTableAddress
                   ) < 0
@@ -336,7 +339,7 @@ function getOrderedAccountsFromAddressMap(addressMap) {
     if (leftIsWritable !== isWritableRole(rightEntry.role)) {
       return leftIsWritable ? -1 : 1;
     }
-    addressComparator || (addressComparator = addresses.getBase58EncodedAddressComparator());
+    addressComparator || (addressComparator = addresses.getAddressComparator());
     if (leftEntry[TYPE] === 1 /* LOOKUP_TABLE */ && rightEntry[TYPE] === 1 /* LOOKUP_TABLE */ && leftEntry.lookupTableAddress !== rightEntry.lookupTableAddress) {
       return addressComparator(leftEntry.lookupTableAddress, rightEntry.lookupTableAddress);
     } else {
@@ -365,7 +368,7 @@ function getCompiledAddressTableLookups(orderedAccounts) {
       entry.readableIndices.push(account.addressIndex);
     }
   }
-  return Object.keys(index).sort(addresses.getBase58EncodedAddressComparator()).map((lookupTableAddress) => ({
+  return Object.keys(index).sort(addresses.getAddressComparator()).map((lookupTableAddress) => ({
     lookupTableAddress,
     ...index[lookupTableAddress]
   }));
@@ -444,12 +447,40 @@ function compileMessage(transaction) {
     version: transaction.version
   };
 }
+
+// src/compile-transaction.ts
+function getCompiledTransaction(transaction) {
+  const compiledMessage = compileMessage(transaction);
+  let signatures;
+  if ("signatures" in transaction) {
+    signatures = [];
+    for (let ii = 0; ii < compiledMessage.header.numSignerAccounts; ii++) {
+      signatures[ii] = transaction.signatures[compiledMessage.staticAccounts[ii]] ?? new Uint8Array(Array(64).fill(0));
+    }
+  } else {
+    signatures = Array(compiledMessage.header.numSignerAccounts).fill(new Uint8Array(Array(64).fill(0)));
+  }
+  return {
+    compiledMessage,
+    signatures
+  };
+}
+function addressSerializerCompat(compat) {
+  const codec = addresses.getAddressCodec();
+  return {
+    description: compat?.description ?? codec.description,
+    deserialize: codec.decode,
+    fixedSize: codec.fixedSize,
+    maxSize: codec.maxSize,
+    serialize: codec.encode
+  };
+}
 function getAddressTableLookupCodec() {
   return umiSerializers.struct(
     [
       [
         "lookupTableAddress",
-        addresses.getBase58EncodedAddressCodec(
+        addressSerializerCompat(
           __DEV__ ? {
             description: "The address of the address lookup table account from which instruction addresses should be looked up"
           } : void 0
@@ -479,37 +510,33 @@ function getAddressTableLookupCodec() {
     } : void 0
   );
 }
+var memoizedU8Codec;
+function getMemoizedU8Codec() {
+  if (!memoizedU8Codec)
+    memoizedU8Codec = codecsNumbers.getU8Codec();
+  return memoizedU8Codec;
+}
+function getMemoizedU8CodecDescription(description) {
+  const codec = getMemoizedU8Codec();
+  return {
+    ...codec,
+    description: description ?? codec.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 getMessageHeaderCodec() {
-  return umiSerializers.struct(
+  return codecsDataStructures.getStructCodec(
     [
-      [
-        "numSignerAccounts",
-        umiSerializers.u8(
-          __DEV__ ? {
-            description: "The expected number of addresses in the static address list belonging to accounts that are required to sign this transaction"
-          } : void 0
-        )
-      ],
-      [
-        "numReadonlySignerAccounts",
-        umiSerializers.u8(
-          __DEV__ ? {
-            description: "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
-        )
-      ],
-      [
-        "numReadonlyNonSignerAccounts",
-        umiSerializers.u8(
-          __DEV__ ? {
-            description: "The expected number of addresses in the static address list belonging to accounts that are neither signers, nor writable"
-          } : void 0
-        )
-      ]
+      ["numSignerAccounts", getMemoizedU8CodecDescription(numSignerAccountsDescription)],
+      ["numReadonlySignerAccounts", getMemoizedU8CodecDescription(numReadonlySignerAccountsDescription)],
+      ["numReadonlyNonSignerAccounts", getMemoizedU8CodecDescription(numReadonlyNonSignerAccountsDescription)]
     ],
-    __DEV__ ? {
-      description: "The transaction message header containing counts of the signer, readonly-signer, and readonly-nonsigner account addresses"
-    } : void 0
+    {
+      description: messageHeaderDescription
+    }
   );
 }
 function getInstructionCodec() {
@@ -566,28 +593,13 @@ function getInstructionCodec() {
     }
   );
 }
-
-// src/serializers/unimplemented.ts
-function getError(type, name) {
-  const functionSuffix = name + type[0].toUpperCase() + type.slice(1);
-  return new Error(
-    `No ${type} exists for ${name}. Use \`get${functionSuffix}()\` if you need a ${type}, and \`get${name}Codec()\` if you need to both encode and decode ${name}`
-  );
-}
-function getUnimplementedDecoder(name) {
-  return () => {
-    throw getError("decoder", name);
-  };
-}
-
-// src/serializers/transaction-version.ts
 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 deserialize(bytes3, offset = 0) {
+function decode(bytes3, offset = 0) {
   const firstByte = bytes3[offset];
   if ((firstByte & VERSION_FLAG_MASK) === 0) {
     return ["legacy", offset];
@@ -596,7 +608,7 @@ function deserialize(bytes3, offset = 0) {
     return [version, offset + 1];
   }
 }
-function serialize(value) {
+function encode(value) {
   if (value === "legacy") {
     return new Uint8Array();
   }
@@ -605,11 +617,32 @@ function serialize(value) {
   }
   return new Uint8Array([value | VERSION_FLAG_MASK]);
 }
-function getTransactionVersionCodec() {
+function getTransactionVersionDecoder() {
   return {
     ...BASE_CONFIG,
-    deserialize,
-    serialize
+    decode
+  };
+}
+function getTransactionVersionEncoder() {
+  return {
+    ...BASE_CONFIG,
+    encode
+  };
+}
+function getTransactionVersionCodec() {
+  return codecsCore.combineCodec(getTransactionVersionEncoder(), getTransactionVersionDecoder());
+}
+
+// src/serializers/unimplemented.ts
+function getError(type, name) {
+  const functionSuffix = name + type[0].toUpperCase() + type.slice(1);
+  return new Error(
+    `No ${type} exists for ${name}. Use \`get${functionSuffix}()\` if you need a ${type}, and \`get${name}Codec()\` if you need to both encode and decode ${name}`
+  );
+}
+function getUnimplementedDecoder(name) {
+  return () => {
+    throw getError("decoder", name);
   };
 }
 
@@ -619,7 +652,7 @@ var BASE_CONFIG2 = {
   fixedSize: null,
   maxSize: null
 };
-function serialize2(compiledMessage) {
+function serialize(compiledMessage) {
   if (compiledMessage.version === "legacy") {
     return umiSerializers.struct(getPreludeStructSerializerTuple()).serialize(compiledMessage);
   } else {
@@ -640,13 +673,22 @@ function serialize2(compiledMessage) {
     ).serialize(compiledMessage);
   }
 }
+function toSerializer(codec) {
+  return {
+    description: codec.description,
+    deserialize: codec.decode,
+    fixedSize: codec.fixedSize,
+    maxSize: codec.maxSize,
+    serialize: codec.encode
+  };
+}
 function getPreludeStructSerializerTuple() {
   return [
-    ["version", getTransactionVersionCodec()],
-    ["header", getMessageHeaderCodec()],
+    ["version", toSerializer(getTransactionVersionCodec())],
+    ["header", toSerializer(getMessageHeaderCodec())],
     [
       "staticAccounts",
-      umiSerializers.array(addresses.getBase58EncodedAddressCodec(), {
+      umiSerializers.array(toSerializer(addresses.getAddressCodec()), {
         description: __DEV__ ? "A compact-array of static account addresses belonging to this transaction" : "",
         size: umiSerializers.shortU16()
       })
@@ -678,11 +720,36 @@ function getCompiledMessageEncoder() {
   return {
     ...BASE_CONFIG2,
     deserialize: getUnimplementedDecoder("CompiledMessage"),
-    serialize: serialize2
+    serialize
   };
 }
 
-// src/signatures.ts
+// src/serializers/transaction.ts
+var BASE_CONFIG3 = {
+  description: __DEV__ ? "The wire format of a Solana transaction" : "",
+  fixedSize: null,
+  maxSize: null
+};
+function serialize2(transaction) {
+  const compiledTransaction = getCompiledTransaction(transaction);
+  return umiSerializers.struct([
+    [
+      "signatures",
+      umiSerializers.array(umiSerializers.bytes({ size: 64 }), {
+        ...__DEV__ ? { description: "A compact array of 64-byte, base-64 encoded Ed25519 signatures" } : null,
+        size: umiSerializers.shortU16()
+      })
+    ],
+    ["compiledMessage", getCompiledMessageEncoder()]
+  ]).serialize(compiledTransaction);
+}
+function getTransactionEncoder() {
+  return {
+    ...BASE_CONFIG3,
+    deserialize: getUnimplementedDecoder("CompiledMessage"),
+    serialize: serialize2
+  };
+}
 function assertIsTransactionSignature(putativeTransactionSignature) {
   try {
     if (
@@ -758,51 +825,6 @@ function transactionSignature(putativeTransactionSignature) {
   return putativeTransactionSignature;
 }
 
-// src/compile-transaction.ts
-function getCompiledTransaction(transaction) {
-  const compiledMessage = compileMessage(transaction);
-  let signatures;
-  if ("signatures" in transaction) {
-    signatures = [];
-    for (let ii = 0; ii < compiledMessage.header.numSignerAccounts; ii++) {
-      signatures[ii] = transaction.signatures[compiledMessage.staticAccounts[ii]] ?? new Uint8Array(Array(64).fill(0));
-    }
-  } else {
-    signatures = Array(compiledMessage.header.numSignerAccounts).fill(new Uint8Array(Array(64).fill(0)));
-  }
-  return {
-    compiledMessage,
-    signatures
-  };
-}
-
-// src/serializers/transaction.ts
-var BASE_CONFIG3 = {
-  description: __DEV__ ? "The wire format of a Solana transaction" : "",
-  fixedSize: null,
-  maxSize: null
-};
-function serialize3(transaction) {
-  const compiledTransaction = getCompiledTransaction(transaction);
-  return umiSerializers.struct([
-    [
-      "signatures",
-      umiSerializers.array(umiSerializers.bytes({ size: 64 }), {
-        ...__DEV__ ? { description: "A compact array of 64-byte, base-64 encoded Ed25519 signatures" } : null,
-        size: umiSerializers.shortU16()
-      })
-    ],
-    ["compiledMessage", getCompiledMessageEncoder()]
-  ]).serialize(compiledTransaction);
-}
-function getTransactionEncoder() {
-  return {
-    ...BASE_CONFIG3,
-    deserialize: getUnimplementedDecoder("CompiledMessage"),
-    serialize: serialize3
-  };
-}
-
 // src/wire-transaction.ts
 function getBase64EncodedWireTransaction(transaction) {
   const wireTransactionBytes = getTransactionEncoder().serialize(transaction);
@@ -818,6 +840,7 @@ exports.assertIsTransactionSignature = assertIsTransactionSignature;
 exports.createTransaction = createTransaction;
 exports.getBase64EncodedWireTransaction = getBase64EncodedWireTransaction;
 exports.getSignatureFromTransaction = getSignatureFromTransaction;
+exports.getTransactionEncoder = getTransactionEncoder;
 exports.isTransactionSignature = isTransactionSignature;
 exports.prependTransactionInstruction = prependTransactionInstruction;
 exports.setTransactionFeePayer = setTransactionFeePayer;