@solana/transactions 2.0.0-experimental.10bfcd8 → 2.0.0-experimental.13ef878

package/dist/index.development.js

@@ -2,39 +2,257 @@ this.globalThis = this.globalThis || {};
 this.globalThis.solanaWeb3 = (function (exports) {
   'use strict';
 
-  var __defProp = Object.defineProperty;
-  var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-  var __publicField = (obj, key, value) => {
-    __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-    return value;
+  // ../codecs-core/dist/index.browser.js
+  function assertByteArrayIsNotEmptyForCodec(codecDescription, bytes, offset = 0) {
+    if (bytes.length - offset <= 0) {
+      throw new Error(`Codec [${codecDescription}] cannot decode empty byte arrays.`);
+    }
+  }
+  function assertByteArrayHasEnoughBytesForCodec(codecDescription, expected, bytes, offset = 0) {
+    const bytesLength = bytes.length - offset;
+    if (bytesLength < expected) {
+      throw new Error(`Codec [${codecDescription}] expected ${expected} bytes, got ${bytesLength}.`);
+    }
+  }
+  var mergeBytes = (byteArrays) => {
+    const nonEmptyByteArrays = byteArrays.filter((arr) => arr.length);
+    if (nonEmptyByteArrays.length === 0) {
+      return byteArrays.length ? byteArrays[0] : new Uint8Array();
+    }
+    if (nonEmptyByteArrays.length === 1) {
+      return nonEmptyByteArrays[0];
+    }
+    const totalLength = nonEmptyByteArrays.reduce((total, arr) => total + arr.length, 0);
+    const result = new Uint8Array(totalLength);
+    let offset = 0;
+    nonEmptyByteArrays.forEach((arr) => {
+      result.set(arr, offset);
+      offset += arr.length;
+    });
+    return result;
+  };
+  var padBytes = (bytes, length) => {
+    if (bytes.length >= length)
+      return bytes;
+    const paddedBytes = new Uint8Array(length).fill(0);
+    paddedBytes.set(bytes);
+    return paddedBytes;
   };
+  var fixBytes = (bytes, length) => padBytes(bytes.length <= length ? bytes : bytes.slice(0, length), length);
+  function combineCodec(encoder, decoder, description) {
+    if (encoder.fixedSize !== decoder.fixedSize) {
+      throw new Error(
+        `Encoder and decoder must have the same fixed size, got [${encoder.fixedSize}] and [${decoder.fixedSize}].`
+      );
+    }
+    if (encoder.maxSize !== decoder.maxSize) {
+      throw new Error(
+        `Encoder and decoder must have the same max size, got [${encoder.maxSize}] and [${decoder.maxSize}].`
+      );
+    }
+    if (description === void 0 && encoder.description !== decoder.description) {
+      throw new Error(
+        `Encoder and decoder must have the same description, got [${encoder.description}] and [${decoder.description}]. Pass a custom description as a third argument if you want to override the description and bypass this error.`
+      );
+    }
+    return {
+      decode: decoder.decode,
+      description: description ?? encoder.description,
+      encode: encoder.encode,
+      fixedSize: encoder.fixedSize,
+      maxSize: encoder.maxSize
+    };
+  }
+  function fixCodecHelper(data, fixedBytes, description) {
+    return {
+      description: description ?? `fixed(${fixedBytes}, ${data.description})`,
+      fixedSize: fixedBytes,
+      maxSize: fixedBytes
+    };
+  }
+  function fixEncoder(encoder, fixedBytes, description) {
+    return {
+      ...fixCodecHelper(encoder, fixedBytes, description),
+      encode: (value) => fixBytes(encoder.encode(value), fixedBytes)
+    };
+  }
+  function fixDecoder(decoder, fixedBytes, description) {
+    return {
+      ...fixCodecHelper(decoder, fixedBytes, description),
+      decode: (bytes, offset = 0) => {
+        assertByteArrayHasEnoughBytesForCodec("fixCodec", fixedBytes, bytes, offset);
+        if (offset > 0 || bytes.length > fixedBytes) {
+          bytes = bytes.slice(offset, offset + fixedBytes);
+        }
+        if (decoder.fixedSize !== null) {
+          bytes = fixBytes(bytes, decoder.fixedSize);
+        }
+        const [value] = decoder.decode(bytes, 0);
+        return [value, offset + fixedBytes];
+      }
+    };
+  }
+  function mapEncoder(encoder, unmap) {
+    return {
+      description: encoder.description,
+      encode: (value) => encoder.encode(unmap(value)),
+      fixedSize: encoder.fixedSize,
+      maxSize: encoder.maxSize
+    };
+  }
+  function mapDecoder(decoder, map) {
+    return {
+      decode: (bytes, offset = 0) => {
+        const [value, length] = decoder.decode(bytes, offset);
+        return [map(value, bytes, offset), length];
+      },
+      description: decoder.description,
+      fixedSize: decoder.fixedSize,
+      maxSize: decoder.maxSize
+    };
+  }
 
-  // ../../node_modules/.pnpm/@metaplex-foundation+umi-serializers-encodings@0.8.9/node_modules/@metaplex-foundation/umi-serializers-encodings/dist/esm/errors.mjs
-  var InvalidBaseStringError = class extends Error {
-    constructor(value, base, cause) {
-      const message = `Expected a string of base ${base}, got [${value}].`;
-      super(message);
-      __publicField(this, "name", "InvalidBaseStringError");
-      this.cause = cause;
+  // ../codecs-numbers/dist/index.browser.js
+  function assertNumberIsBetweenForCodec(codecDescription, min, max, value) {
+    if (value < min || value > max) {
+      throw new Error(
+        `Codec [${codecDescription}] expected number to be in the range [${min}, ${max}], got ${value}.`
+      );
     }
-  };
+  }
+  function sharedNumberFactory(input) {
+    let littleEndian;
+    let defaultDescription = input.name;
+    if (input.size > 1) {
+      littleEndian = !("endian" in input.options) || input.options.endian === 0;
+      defaultDescription += littleEndian ? "(le)" : "(be)";
+    }
+    return {
+      description: input.options.description ?? defaultDescription,
+      fixedSize: input.size,
+      littleEndian,
+      maxSize: input.size
+    };
+  }
+  function numberEncoderFactory(input) {
+    const codecData = sharedNumberFactory(input);
+    return {
+      description: codecData.description,
+      encode(value) {
+        if (input.range) {
+          assertNumberIsBetweenForCodec(input.name, input.range[0], input.range[1], value);
+        }
+        const arrayBuffer = new ArrayBuffer(input.size);
+        input.set(new DataView(arrayBuffer), value, codecData.littleEndian);
+        return new Uint8Array(arrayBuffer);
+      },
+      fixedSize: codecData.fixedSize,
+      maxSize: codecData.maxSize
+    };
+  }
+  function numberDecoderFactory(input) {
+    const codecData = sharedNumberFactory(input);
+    return {
+      decode(bytes, offset = 0) {
+        assertByteArrayIsNotEmptyForCodec(codecData.description, bytes, offset);
+        assertByteArrayHasEnoughBytesForCodec(codecData.description, input.size, bytes, offset);
+        const view = new DataView(toArrayBuffer(bytes, offset, input.size));
+        return [input.get(view, codecData.littleEndian), offset + input.size];
+      },
+      description: codecData.description,
+      fixedSize: codecData.fixedSize,
+      maxSize: codecData.maxSize
+    };
+  }
+  function toArrayBuffer(bytes, offset, length) {
+    const bytesOffset = bytes.byteOffset + (offset ?? 0);
+    const bytesLength = length ?? bytes.byteLength;
+    return bytes.buffer.slice(bytesOffset, bytesOffset + bytesLength);
+  }
+  var getShortU16Encoder = (options = {}) => ({
+    description: options.description ?? "shortU16",
+    encode: (value) => {
+      assertNumberIsBetweenForCodec("shortU16", 0, 65535, value);
+      const bytes = [0];
+      for (let ii = 0; ; ii += 1) {
+        const alignedValue = value >> ii * 7;
+        if (alignedValue === 0) {
+          break;
+        }
+        const nextSevenBits = 127 & alignedValue;
+        bytes[ii] = nextSevenBits;
+        if (ii > 0) {
+          bytes[ii - 1] |= 128;
+        }
+      }
+      return new Uint8Array(bytes);
+    },
+    fixedSize: null,
+    maxSize: 3
+  });
+  var getShortU16Decoder = (options = {}) => ({
+    decode: (bytes, offset = 0) => {
+      let value = 0;
+      let byteCount = 0;
+      while (++byteCount) {
+        const byteIndex = byteCount - 1;
+        const currentByte = bytes[offset + byteIndex];
+        const nextSevenBits = 127 & currentByte;
+        value |= nextSevenBits << byteIndex * 7;
+        if ((currentByte & 128) === 0) {
+          break;
+        }
+      }
+      return [value, offset + byteCount];
+    },
+    description: options.description ?? "shortU16",
+    fixedSize: null,
+    maxSize: 3
+  });
+  var getU32Encoder = (options = {}) => numberEncoderFactory({
+    name: "u32",
+    options,
+    range: [0, Number("0xffffffff")],
+    set: (view, value, le) => view.setUint32(0, value, le),
+    size: 4
+  });
+  var getU32Decoder = (options = {}) => numberDecoderFactory({
+    get: (view, le) => view.getUint32(0, le),
+    name: "u32",
+    options,
+    size: 4
+  });
+  var getU8Encoder = (options = {}) => numberEncoderFactory({
+    name: "u8",
+    options,
+    range: [0, Number("0xff")],
+    set: (view, value) => view.setUint8(0, value),
+    size: 1
+  });
+  var getU8Decoder = (options = {}) => numberDecoderFactory({
+    get: (view) => view.getUint8(0),
+    name: "u8",
+    options,
+    size: 1
+  });
 
-  // ../../node_modules/.pnpm/@metaplex-foundation+umi-serializers-encodings@0.8.9/node_modules/@metaplex-foundation/umi-serializers-encodings/dist/esm/baseX.mjs
-  var baseX = (alphabet) => {
-    const base = alphabet.length;
+  // ../codecs-strings/dist/index.browser.js
+  function assertValidBaseString(alphabet4, testValue, givenValue = testValue) {
+    if (!testValue.match(new RegExp(`^[${alphabet4}]*$`))) {
+      throw new Error(`Expected a string of base ${alphabet4.length}, got [${givenValue}].`);
+    }
+  }
+  var getBaseXEncoder = (alphabet4) => {
+    const base = alphabet4.length;
     const baseBigInt = BigInt(base);
     return {
       description: `base${base}`,
-      fixedSize: null,
-      maxSize: null,
-      serialize(value) {
-        if (!value.match(new RegExp(`^[${alphabet}]*$`))) {
-          throw new InvalidBaseStringError(value, base);
-        }
+      encode(value) {
+        assertValidBaseString(alphabet4, value);
         if (value === "")
           return new Uint8Array();
         const chars = [...value];
-        let trailIndex = chars.findIndex((c) => c !== alphabet[0]);
+        let trailIndex = chars.findIndex((c) => c !== alphabet4[0]);
         trailIndex = trailIndex === -1 ? chars.length : trailIndex;
         const leadingZeroes = Array(trailIndex).fill(0);
         if (trailIndex === chars.length)
@@ -43,7 +261,7 @@ this.globalThis.solanaWeb3 = (function (exports) {
         let base10Number = 0n;
         let baseXPower = 1n;
         for (let i = tailChars.length - 1; i >= 0; i -= 1) {
-          base10Number += baseXPower * BigInt(alphabet.indexOf(tailChars[i]));
+          base10Number += baseXPower * BigInt(alphabet4.indexOf(tailChars[i]));
           baseXPower *= baseBigInt;
         }
         const tailBytes = [];
@@ -53,28 +271,117 @@ this.globalThis.solanaWeb3 = (function (exports) {
         }
         return Uint8Array.from(leadingZeroes.concat(tailBytes));
       },
-      deserialize(buffer, offset = 0) {
-        if (buffer.length === 0)
+      fixedSize: null,
+      maxSize: null
+    };
+  };
+  var getBaseXDecoder = (alphabet4) => {
+    const base = alphabet4.length;
+    const baseBigInt = BigInt(base);
+    return {
+      decode(rawBytes, offset = 0) {
+        const bytes = offset === 0 ? rawBytes : rawBytes.slice(offset);
+        if (bytes.length === 0)
           return ["", 0];
-        const bytes = buffer.slice(offset);
         let trailIndex = bytes.findIndex((n) => n !== 0);
         trailIndex = trailIndex === -1 ? bytes.length : trailIndex;
-        const leadingZeroes = alphabet[0].repeat(trailIndex);
+        const leadingZeroes = alphabet4[0].repeat(trailIndex);
         if (trailIndex === bytes.length)
-          return [leadingZeroes, buffer.length];
+          return [leadingZeroes, rawBytes.length];
         let base10Number = bytes.slice(trailIndex).reduce((sum, byte) => sum * 256n + BigInt(byte), 0n);
         const tailChars = [];
         while (base10Number > 0n) {
-          tailChars.unshift(alphabet[Number(base10Number % baseBigInt)]);
+          tailChars.unshift(alphabet4[Number(base10Number % baseBigInt)]);
           base10Number /= baseBigInt;
         }
-        return [leadingZeroes + tailChars.join(""), buffer.length];
-      }
+        return [leadingZeroes + tailChars.join(""), rawBytes.length];
+      },
+      description: `base${base}`,
+      fixedSize: null,
+      maxSize: null
     };
   };
-
-  // ../../node_modules/.pnpm/@metaplex-foundation+umi-serializers-encodings@0.8.9/node_modules/@metaplex-foundation/umi-serializers-encodings/dist/esm/base58.mjs
-  var base58 = baseX("123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz");
+  var alphabet2 = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+  var getBase58Encoder = () => getBaseXEncoder(alphabet2);
+  var getBase58Decoder = () => getBaseXDecoder(alphabet2);
+  var removeNullCharacters = (value) => (
+    // eslint-disable-next-line no-control-regex
+    value.replace(/\u0000/g, "")
+  );
+  var e = globalThis.TextDecoder;
+  var o = globalThis.TextEncoder;
+  var getUtf8Encoder = () => {
+    let textEncoder;
+    return {
+      description: "utf8",
+      encode: (value) => new Uint8Array((textEncoder || (textEncoder = new o())).encode(value)),
+      fixedSize: null,
+      maxSize: null
+    };
+  };
+  var getUtf8Decoder = () => {
+    let textDecoder;
+    return {
+      decode(bytes, offset = 0) {
+        const value = (textDecoder || (textDecoder = new e())).decode(bytes.slice(offset));
+        return [removeNullCharacters(value), bytes.length];
+      },
+      description: "utf8",
+      fixedSize: null,
+      maxSize: null
+    };
+  };
+  var getStringEncoder = (options = {}) => {
+    const size = options.size ?? getU32Encoder();
+    const encoding = options.encoding ?? getUtf8Encoder();
+    const description = options.description ?? `string(${encoding.description}; ${getSizeDescription(size)})`;
+    if (size === "variable") {
+      return { ...encoding, description };
+    }
+    if (typeof size === "number") {
+      return fixEncoder(encoding, size, description);
+    }
+    return {
+      description,
+      encode: (value) => {
+        const contentBytes = encoding.encode(value);
+        const lengthBytes = size.encode(contentBytes.length);
+        return mergeBytes([lengthBytes, contentBytes]);
+      },
+      fixedSize: null,
+      maxSize: null
+    };
+  };
+  var getStringDecoder = (options = {}) => {
+    const size = options.size ?? getU32Decoder();
+    const encoding = options.encoding ?? getUtf8Decoder();
+    const description = options.description ?? `string(${encoding.description}; ${getSizeDescription(size)})`;
+    if (size === "variable") {
+      return { ...encoding, description };
+    }
+    if (typeof size === "number") {
+      return fixDecoder(encoding, size, description);
+    }
+    return {
+      decode: (bytes, offset = 0) => {
+        assertByteArrayIsNotEmptyForCodec("string", bytes, offset);
+        const [lengthBigInt, lengthOffset] = size.decode(bytes, offset);
+        const length = Number(lengthBigInt);
+        offset = lengthOffset;
+        const contentBytes = bytes.slice(offset, offset + length);
+        assertByteArrayHasEnoughBytesForCodec("string", length, contentBytes);
+        const [value, contentOffset] = encoding.decode(contentBytes);
+        offset += contentOffset;
+        return [value, offset];
+      },
+      description,
+      fixedSize: null,
+      maxSize: null
+    };
+  };
+  function getSizeDescription(size) {
+    return typeof size === "object" ? size.description : `${size}`;
+  }
 
   // src/unsigned-transaction.ts
   function getUnsignedTransaction(transaction) {
@@ -91,7 +398,10 @@ this.globalThis.solanaWeb3 = (function (exports) {
   }
 
   // src/blockhash.ts
+  var base58Encoder;
   function assertIsBlockhash(putativeBlockhash) {
+    if (!base58Encoder)
+      base58Encoder = getBase58Encoder();
     try {
       if (
         // Lowest value (32 bytes of zeroes)
@@ -100,7 +410,7 @@ this.globalThis.solanaWeb3 = (function (exports) {
       ) {
         throw new Error("Expected input string to decode to a byte array of length 32.");
       }
-      const bytes = base58.serialize(putativeBlockhash);
+      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}`);
@@ -253,251 +563,17 @@ this.globalThis.solanaWeb3 = (function (exports) {
       ...getUnsignedTransaction(transaction),
       instructions: [...transaction.instructions, instruction]
     };
-    Object.freeze(out);
-    return out;
-  }
-  function prependTransactionInstruction(instruction, transaction) {
-    const out = {
-      ...getUnsignedTransaction(transaction),
-      instructions: [instruction, ...transaction.instructions]
-    };
-    Object.freeze(out);
-    return out;
-  }
-
-  // ../codecs-core/dist/index.browser.js
-  function assertByteArrayIsNotEmptyForCodec(codecDescription, bytes, offset = 0) {
-    if (bytes.length - offset <= 0) {
-      throw new Error(`Codec [${codecDescription}] cannot decode empty byte arrays.`);
-    }
-  }
-  function assertByteArrayHasEnoughBytesForCodec(codecDescription, expected, bytes, offset = 0) {
-    const bytesLength = bytes.length - offset;
-    if (bytesLength < expected) {
-      throw new Error(`Codec [${codecDescription}] expected ${expected} bytes, got ${bytesLength}.`);
-    }
-  }
-  var mergeBytes = (byteArrays) => {
-    const nonEmptyByteArrays = byteArrays.filter((arr) => arr.length);
-    if (nonEmptyByteArrays.length === 0) {
-      return byteArrays.length ? byteArrays[0] : new Uint8Array();
-    }
-    if (nonEmptyByteArrays.length === 1) {
-      return nonEmptyByteArrays[0];
-    }
-    const totalLength = nonEmptyByteArrays.reduce((total, arr) => total + arr.length, 0);
-    const result = new Uint8Array(totalLength);
-    let offset = 0;
-    nonEmptyByteArrays.forEach((arr) => {
-      result.set(arr, offset);
-      offset += arr.length;
-    });
-    return result;
-  };
-  var padBytes = (bytes, length) => {
-    if (bytes.length >= length)
-      return bytes;
-    const paddedBytes = new Uint8Array(length).fill(0);
-    paddedBytes.set(bytes);
-    return paddedBytes;
-  };
-  var fixBytes = (bytes, length) => padBytes(bytes.length <= length ? bytes : bytes.slice(0, length), length);
-  function combineCodec(encoder, decoder, description) {
-    if (encoder.fixedSize !== decoder.fixedSize) {
-      throw new Error(
-        `Encoder and decoder must have the same fixed size, got [${encoder.fixedSize}] and [${decoder.fixedSize}].`
-      );
-    }
-    if (encoder.maxSize !== decoder.maxSize) {
-      throw new Error(
-        `Encoder and decoder must have the same max size, got [${encoder.maxSize}] and [${decoder.maxSize}].`
-      );
-    }
-    if (description === void 0 && encoder.description !== decoder.description) {
-      throw new Error(
-        `Encoder and decoder must have the same description, got [${encoder.description}] and [${decoder.description}]. Pass a custom description as a third argument if you want to override the description and bypass this error.`
-      );
-    }
-    return {
-      decode: decoder.decode,
-      description: description ?? encoder.description,
-      encode: encoder.encode,
-      fixedSize: encoder.fixedSize,
-      maxSize: encoder.maxSize
-    };
-  }
-  function fixCodecHelper(data, fixedBytes, description) {
-    return {
-      description: description ?? `fixed(${fixedBytes}, ${data.description})`,
-      fixedSize: fixedBytes,
-      maxSize: fixedBytes
-    };
-  }
-  function fixEncoder(encoder, fixedBytes, description) {
-    return {
-      ...fixCodecHelper(encoder, fixedBytes, description),
-      encode: (value) => fixBytes(encoder.encode(value), fixedBytes)
-    };
-  }
-  function fixDecoder(decoder, fixedBytes, description) {
-    return {
-      ...fixCodecHelper(decoder, fixedBytes, description),
-      decode: (bytes, offset = 0) => {
-        assertByteArrayHasEnoughBytesForCodec("fixCodec", fixedBytes, bytes, offset);
-        if (offset > 0 || bytes.length > fixedBytes) {
-          bytes = bytes.slice(offset, offset + fixedBytes);
-        }
-        if (decoder.fixedSize !== null) {
-          bytes = fixBytes(bytes, decoder.fixedSize);
-        }
-        const [value] = decoder.decode(bytes, 0);
-        return [value, offset + fixedBytes];
-      }
-    };
-  }
-  function mapEncoder(encoder, unmap) {
-    return {
-      description: encoder.description,
-      encode: (value) => encoder.encode(unmap(value)),
-      fixedSize: encoder.fixedSize,
-      maxSize: encoder.maxSize
-    };
-  }
-  function mapDecoder(decoder, map) {
-    return {
-      decode: (bytes, offset = 0) => {
-        const [value, length] = decoder.decode(bytes, offset);
-        return [map(value, bytes, offset), length];
-      },
-      description: decoder.description,
-      fixedSize: decoder.fixedSize,
-      maxSize: decoder.maxSize
-    };
-  }
-
-  // ../codecs-numbers/dist/index.browser.js
-  function assertNumberIsBetweenForCodec(codecDescription, min, max, value) {
-    if (value < min || value > max) {
-      throw new Error(
-        `Codec [${codecDescription}] expected number to be in the range [${min}, ${max}], got ${value}.`
-      );
-    }
-  }
-  function sharedNumberFactory(input) {
-    let littleEndian;
-    let defaultDescription = input.name;
-    if (input.size > 1) {
-      littleEndian = !("endian" in input.options) || input.options.endian === 0;
-      defaultDescription += littleEndian ? "(le)" : "(be)";
-    }
-    return {
-      description: input.options.description ?? defaultDescription,
-      fixedSize: input.size,
-      littleEndian,
-      maxSize: input.size
-    };
-  }
-  function numberEncoderFactory(input) {
-    const codecData = sharedNumberFactory(input);
-    return {
-      description: codecData.description,
-      encode(value) {
-        if (input.range) {
-          assertNumberIsBetweenForCodec(input.name, input.range[0], input.range[1], value);
-        }
-        const arrayBuffer = new ArrayBuffer(input.size);
-        input.set(new DataView(arrayBuffer), value, codecData.littleEndian);
-        return new Uint8Array(arrayBuffer);
-      },
-      fixedSize: codecData.fixedSize,
-      maxSize: codecData.maxSize
-    };
+    Object.freeze(out);
+    return out;
   }
-  function numberDecoderFactory(input) {
-    const codecData = sharedNumberFactory(input);
-    return {
-      decode(bytes, offset = 0) {
-        assertByteArrayIsNotEmptyForCodec(codecData.description, bytes, offset);
-        assertByteArrayHasEnoughBytesForCodec(codecData.description, input.size, bytes, offset);
-        const view = new DataView(toArrayBuffer(bytes, offset, input.size));
-        return [input.get(view, codecData.littleEndian), offset + input.size];
-      },
-      description: codecData.description,
-      fixedSize: codecData.fixedSize,
-      maxSize: codecData.maxSize
+  function prependTransactionInstruction(instruction, transaction) {
+    const out = {
+      ...getUnsignedTransaction(transaction),
+      instructions: [instruction, ...transaction.instructions]
     };
+    Object.freeze(out);
+    return out;
   }
-  function toArrayBuffer(bytes, offset, length) {
-    const bytesOffset = bytes.byteOffset + (offset ?? 0);
-    const bytesLength = length ?? bytes.byteLength;
-    return bytes.buffer.slice(bytesOffset, bytesOffset + bytesLength);
-  }
-  var getShortU16Encoder = (options = {}) => ({
-    description: options.description ?? "shortU16",
-    encode: (value) => {
-      assertNumberIsBetweenForCodec("shortU16", 0, 65535, value);
-      const bytes = [0];
-      for (let ii = 0; ; ii += 1) {
-        const alignedValue = value >> ii * 7;
-        if (alignedValue === 0) {
-          break;
-        }
-        const nextSevenBits = 127 & alignedValue;
-        bytes[ii] = nextSevenBits;
-        if (ii > 0) {
-          bytes[ii - 1] |= 128;
-        }
-      }
-      return new Uint8Array(bytes);
-    },
-    fixedSize: null,
-    maxSize: 3
-  });
-  var getShortU16Decoder = (options = {}) => ({
-    decode: (bytes, offset = 0) => {
-      let value = 0;
-      let byteCount = 0;
-      while (++byteCount) {
-        const byteIndex = byteCount - 1;
-        const currentByte = bytes[offset + byteIndex];
-        const nextSevenBits = 127 & currentByte;
-        value |= nextSevenBits << byteIndex * 7;
-        if ((currentByte & 128) === 0) {
-          break;
-        }
-      }
-      return [value, offset + byteCount];
-    },
-    description: options.description ?? "shortU16",
-    fixedSize: null,
-    maxSize: 3
-  });
-  var getU32Encoder = (options = {}) => numberEncoderFactory({
-    name: "u32",
-    options,
-    range: [0, Number("0xffffffff")],
-    set: (view, value, le) => view.setUint32(0, value, le),
-    size: 4
-  });
-  var getU32Decoder = (options = {}) => numberDecoderFactory({
-    get: (view, le) => view.getUint32(0, le),
-    name: "u32",
-    options,
-    size: 4
-  });
-  var getU8Encoder = (options = {}) => numberEncoderFactory({
-    name: "u8",
-    options,
-    range: [0, Number("0xff")],
-    set: (view, value) => view.setUint8(0, value),
-    size: 1
-  });
-  var getU8Decoder = (options = {}) => numberDecoderFactory({
-    get: (view) => view.getUint8(0),
-    name: "u8",
-    options,
-    size: 1
-  });
 
   // ../codecs-data-structures/dist/index.browser.js
   function sumCodecSizes(sizes) {
@@ -677,153 +753,6 @@ this.globalThis.solanaWeb3 = (function (exports) {
     };
   }
 
-  // ../codecs-strings/dist/index.browser.js
-  function assertValidBaseString(alphabet4, testValue, givenValue = testValue) {
-    if (!testValue.match(new RegExp(`^[${alphabet4}]*$`))) {
-      throw new Error(`Expected a string of base ${alphabet4.length}, got [${givenValue}].`);
-    }
-  }
-  var getBaseXEncoder = (alphabet4) => {
-    const base = alphabet4.length;
-    const baseBigInt = BigInt(base);
-    return {
-      description: `base${base}`,
-      encode(value) {
-        assertValidBaseString(alphabet4, value);
-        if (value === "")
-          return new Uint8Array();
-        const chars = [...value];
-        let trailIndex = chars.findIndex((c) => c !== alphabet4[0]);
-        trailIndex = trailIndex === -1 ? chars.length : trailIndex;
-        const leadingZeroes = Array(trailIndex).fill(0);
-        if (trailIndex === chars.length)
-          return Uint8Array.from(leadingZeroes);
-        const tailChars = chars.slice(trailIndex);
-        let base10Number = 0n;
-        let baseXPower = 1n;
-        for (let i = tailChars.length - 1; i >= 0; i -= 1) {
-          base10Number += baseXPower * BigInt(alphabet4.indexOf(tailChars[i]));
-          baseXPower *= baseBigInt;
-        }
-        const tailBytes = [];
-        while (base10Number > 0n) {
-          tailBytes.unshift(Number(base10Number % 256n));
-          base10Number /= 256n;
-        }
-        return Uint8Array.from(leadingZeroes.concat(tailBytes));
-      },
-      fixedSize: null,
-      maxSize: null
-    };
-  };
-  var getBaseXDecoder = (alphabet4) => {
-    const base = alphabet4.length;
-    const baseBigInt = BigInt(base);
-    return {
-      decode(rawBytes, offset = 0) {
-        const bytes = offset === 0 ? rawBytes : rawBytes.slice(offset);
-        if (bytes.length === 0)
-          return ["", 0];
-        let trailIndex = bytes.findIndex((n) => n !== 0);
-        trailIndex = trailIndex === -1 ? bytes.length : trailIndex;
-        const leadingZeroes = alphabet4[0].repeat(trailIndex);
-        if (trailIndex === bytes.length)
-          return [leadingZeroes, rawBytes.length];
-        let base10Number = bytes.slice(trailIndex).reduce((sum, byte) => sum * 256n + BigInt(byte), 0n);
-        const tailChars = [];
-        while (base10Number > 0n) {
-          tailChars.unshift(alphabet4[Number(base10Number % baseBigInt)]);
-          base10Number /= baseBigInt;
-        }
-        return [leadingZeroes + tailChars.join(""), rawBytes.length];
-      },
-      description: `base${base}`,
-      fixedSize: null,
-      maxSize: null
-    };
-  };
-  var alphabet2 = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
-  var getBase58Encoder = () => getBaseXEncoder(alphabet2);
-  var getBase58Decoder = () => getBaseXDecoder(alphabet2);
-  var removeNullCharacters = (value) => (
-    // eslint-disable-next-line no-control-regex
-    value.replace(/\u0000/g, "")
-  );
-  var e = globalThis.TextDecoder;
-  var o = globalThis.TextEncoder;
-  var getUtf8Encoder = () => {
-    let textEncoder;
-    return {
-      description: "utf8",
-      encode: (value) => new Uint8Array((textEncoder || (textEncoder = new o())).encode(value)),
-      fixedSize: null,
-      maxSize: null
-    };
-  };
-  var getUtf8Decoder = () => {
-    let textDecoder;
-    return {
-      decode(bytes, offset = 0) {
-        const value = (textDecoder || (textDecoder = new e())).decode(bytes.slice(offset));
-        return [removeNullCharacters(value), bytes.length];
-      },
-      description: "utf8",
-      fixedSize: null,
-      maxSize: null
-    };
-  };
-  var getStringEncoder = (options = {}) => {
-    const size = options.size ?? getU32Encoder();
-    const encoding = options.encoding ?? getUtf8Encoder();
-    const description = options.description ?? `string(${encoding.description}; ${getSizeDescription(size)})`;
-    if (size === "variable") {
-      return { ...encoding, description };
-    }
-    if (typeof size === "number") {
-      return fixEncoder(encoding, size, description);
-    }
-    return {
-      description,
-      encode: (value) => {
-        const contentBytes = encoding.encode(value);
-        const lengthBytes = size.encode(contentBytes.length);
-        return mergeBytes([lengthBytes, contentBytes]);
-      },
-      fixedSize: null,
-      maxSize: null
-    };
-  };
-  var getStringDecoder = (options = {}) => {
-    const size = options.size ?? getU32Decoder();
-    const encoding = options.encoding ?? getUtf8Decoder();
-    const description = options.description ?? `string(${encoding.description}; ${getSizeDescription(size)})`;
-    if (size === "variable") {
-      return { ...encoding, description };
-    }
-    if (typeof size === "number") {
-      return fixDecoder(encoding, size, description);
-    }
-    return {
-      decode: (bytes, offset = 0) => {
-        assertByteArrayIsNotEmptyForCodec("string", bytes, offset);
-        const [lengthBigInt, lengthOffset] = size.decode(bytes, offset);
-        const length = Number(lengthBigInt);
-        offset = lengthOffset;
-        const contentBytes = bytes.slice(offset, offset + length);
-        assertByteArrayHasEnoughBytesForCodec("string", length, contentBytes);
-        const [value, contentOffset] = encoding.decode(contentBytes);
-        offset += contentOffset;
-        return [value, offset];
-      },
-      description,
-      fixedSize: null,
-      maxSize: null
-    };
-  };
-  function getSizeDescription(size) {
-    return typeof size === "object" ? size.description : `${size}`;
-  }
-
   // ../assertions/dist/index.browser.js
   function assertIsSecureContext() {
     if (!globalThis.isSecureContext) {
@@ -858,35 +787,35 @@ this.globalThis.solanaWeb3 = (function (exports) {
       memoizedBase58Decoder = getBase58Decoder();
     return memoizedBase58Decoder;
   }
-  function assertIsAddress(putativeBase58EncodedAddress) {
+  function assertIsAddress(putativeAddress) {
     try {
       if (
         // Lowest address (32 bytes of zeroes)
-        putativeBase58EncodedAddress.length < 32 || // Highest address (32 bytes of 255)
-        putativeBase58EncodedAddress.length > 44
+        putativeAddress.length < 32 || // Highest address (32 bytes of 255)
+        putativeAddress.length > 44
       ) {
         throw new Error("Expected input string to decode to a byte array of length 32.");
       }
-      const base58Encoder = getMemoizedBase58Encoder();
-      const bytes = base58Encoder.encode(putativeBase58EncodedAddress);
+      const base58Encoder2 = getMemoizedBase58Encoder();
+      const bytes = base58Encoder2.encode(putativeAddress);
       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 (e2) {
-      throw new Error(`\`${putativeBase58EncodedAddress}\` is not a base-58 encoded address`, {
+      throw new Error(`\`${putativeAddress}\` is not a base-58 encoded address`, {
         cause: e2
       });
     }
   }
-  function address(putativeBase58EncodedAddress) {
-    assertIsAddress(putativeBase58EncodedAddress);
-    return putativeBase58EncodedAddress;
+  function address(putativeAddress) {
+    assertIsAddress(putativeAddress);
+    return putativeAddress;
   }
   function getAddressEncoder(config) {
     return mapEncoder(
       getStringEncoder({
-        description: config?.description ?? "Base58EncodedAddress",
+        description: config?.description ?? "Address",
         encoding: getMemoizedBase58Encoder(),
         size: 32
       }),
@@ -895,7 +824,7 @@ this.globalThis.solanaWeb3 = (function (exports) {
   }
   function getAddressDecoder(config) {
     return getStringDecoder({
-      description: config?.description ?? "Base58EncodedAddress",
+      description: config?.description ?? "Address",
       encoding: getMemoizedBase58Decoder(),
       size: 32
     });
@@ -1728,52 +1657,20 @@ this.globalThis.solanaWeb3 = (function (exports) {
   }
 
   // src/signatures.ts
-  function assertIsTransactionSignature(putativeTransactionSignature) {
-    try {
-      if (
-        // Lowest value (64 bytes of zeroes)
-        putativeTransactionSignature.length < 64 || // Highest value (64 bytes of 255)
-        putativeTransactionSignature.length > 88
-      ) {
-        throw new Error("Expected input string to decode to a byte array of length 64.");
-      }
-      const bytes = base58.serialize(putativeTransactionSignature);
-      const numBytes = bytes.byteLength;
-      if (numBytes !== 64) {
-        throw new Error(`Expected input string to decode to a byte array of length 64. Actual length: ${numBytes}`);
-      }
-    } catch (e2) {
-      throw new Error(`\`${putativeTransactionSignature}\` is not a transaction signature`, {
-        cause: e2
-      });
-    }
-  }
-  function isTransactionSignature(putativeTransactionSignature) {
-    if (
-      // Lowest value (64 bytes of zeroes)
-      putativeTransactionSignature.length < 64 || // Highest value (64 bytes of 255)
-      putativeTransactionSignature.length > 88
-    ) {
-      return false;
-    }
-    const bytes = base58.serialize(putativeTransactionSignature);
-    const numBytes = bytes.byteLength;
-    if (numBytes !== 64) {
-      return false;
-    }
-    return true;
-  }
+  var base58Decoder;
   function getSignatureFromTransaction(transaction) {
+    if (!base58Decoder)
+      base58Decoder = 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."
       );
     }
-    const transactionSignature2 = base58.deserialize(signatureBytes)[0];
-    return transactionSignature2;
+    const transactionSignature = base58Decoder.decode(signatureBytes)[0];
+    return transactionSignature;
   }
-  async function signTransaction(keyPairs, transaction) {
+  async function partiallySignTransaction(keyPairs, transaction) {
     const compiledMessage = compileMessage(transaction);
     const nextSignatures = "signatures" in transaction ? { ...transaction.signatures } : {};
     const wireMessageBytes = getCompiledMessageEncoder().encode(compiledMessage);
@@ -1792,9 +1689,11 @@ this.globalThis.solanaWeb3 = (function (exports) {
     Object.freeze(out);
     return out;
   }
-  function transactionSignature(putativeTransactionSignature) {
-    assertIsTransactionSignature(putativeTransactionSignature);
-    return putativeTransactionSignature;
+  async function signTransaction(keyPairs, transaction) {
+    const out = await partiallySignTransaction(keyPairs, transaction);
+    assertTransactionIsFullySigned(out);
+    Object.freeze(out);
+    return out;
   }
   function assertTransactionIsFullySigned(transaction) {
     const signerAddressesFromInstructions = transaction.instructions.flatMap((i) => i.accounts?.filter((a) => isSignerRole(a.role)) ?? []).map((a) => a.address);
@@ -1817,7 +1716,6 @@ this.globalThis.solanaWeb3 = (function (exports) {
   exports.appendTransactionInstruction = appendTransactionInstruction;
   exports.assertIsBlockhash = assertIsBlockhash;
   exports.assertIsDurableNonceTransaction = assertIsDurableNonceTransaction;
-  exports.assertIsTransactionSignature = assertIsTransactionSignature;
   exports.assertTransactionIsFullySigned = assertTransactionIsFullySigned;
   exports.createTransaction = createTransaction;
   exports.getBase64EncodedWireTransaction = getBase64EncodedWireTransaction;
@@ -1826,13 +1724,12 @@ this.globalThis.solanaWeb3 = (function (exports) {
   exports.getTransactionDecoder = getTransactionDecoder;
   exports.getTransactionEncoder = getTransactionEncoder;
   exports.isAdvanceNonceAccountInstruction = isAdvanceNonceAccountInstruction;
-  exports.isTransactionSignature = isTransactionSignature;
+  exports.partiallySignTransaction = partiallySignTransaction;
   exports.prependTransactionInstruction = prependTransactionInstruction;
   exports.setTransactionFeePayer = setTransactionFeePayer;
   exports.setTransactionLifetimeUsingBlockhash = setTransactionLifetimeUsingBlockhash;
   exports.setTransactionLifetimeUsingDurableNonce = setTransactionLifetimeUsingDurableNonce;
   exports.signTransaction = signTransaction;
-  exports.transactionSignature = transactionSignature;
 
   return exports;