@solana/transactions 2.0.0-experimental.d1e0dc6 → 2.0.0-experimental.f07dced

package/dist/index.browser.cjs

@@ -1,5 +1,31 @@
 'use strict';
 
+var umiSerializers = require('@metaplex-foundation/umi-serializers');
+var keys = require('@solana/keys');
+
+// ../build-scripts/env-shim.ts
+var __DEV__ = /* @__PURE__ */ (() => process["env"].NODE_ENV === "development")();
+function assertIsBlockhash(putativeBlockhash) {
+  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 bytes3 = umiSerializers.base58.serialize(putativeBlockhash);
+    const numBytes = bytes3.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
+    });
+  }
+}
+
 // src/create-transaction.ts
 function createTransaction({
   version
@@ -72,9 +98,615 @@ function prependTransactionInstruction(instruction, transaction) {
   return out;
 }
 
+// ../instructions/dist/index.browser.js
+var AccountRole = /* @__PURE__ */ ((AccountRole2) => {
+  AccountRole2[AccountRole2["WRITABLE_SIGNER"] = /* 3 */
+  3] = "WRITABLE_SIGNER";
+  AccountRole2[AccountRole2["READONLY_SIGNER"] = /* 2 */
+  2] = "READONLY_SIGNER";
+  AccountRole2[AccountRole2["WRITABLE"] = /* 1 */
+  1] = "WRITABLE";
+  AccountRole2[AccountRole2["READONLY"] = /* 0 */
+  0] = "READONLY";
+  return AccountRole2;
+})(AccountRole || {});
+var IS_WRITABLE_BITMASK = 1;
+function isSignerRole(role) {
+  return role >= 2;
+}
+function isWritableRole(role) {
+  return (role & IS_WRITABLE_BITMASK) !== 0;
+}
+function mergeRoles(roleA, roleB) {
+  return roleA | roleB;
+}
+function upsert(addressMap, address, update) {
+  addressMap[address] = update(addressMap[address] ?? { role: AccountRole.READONLY });
+}
+var TYPE = Symbol("AddressMapTypeProperty");
+function getAddressMapFromInstructions(feePayer, instructions) {
+  const addressMap = {
+    [feePayer]: { [TYPE]: 0 /* FEE_PAYER */, role: AccountRole.WRITABLE_SIGNER }
+  };
+  const addressesOfInvokedPrograms = /* @__PURE__ */ new Set();
+  for (const instruction of instructions) {
+    upsert(addressMap, instruction.programAddress, (entry) => {
+      addressesOfInvokedPrograms.add(instruction.programAddress);
+      if (TYPE in entry) {
+        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.`
+              );
+            default:
+              throw new Error(
+                `This transaction includes an address (\`${instruction.programAddress}\`) which is both invoked and marked writable. Program addresses may not be writable.`
+              );
+          }
+        }
+        if (entry[TYPE] === 2 /* STATIC */) {
+          return entry;
+        }
+      }
+      return { [TYPE]: 2 /* STATIC */, role: AccountRole.READONLY };
+    });
+    let addressComparator;
+    if (!instruction.accounts) {
+      continue;
+    }
+    for (const account of instruction.accounts) {
+      upsert(addressMap, account.address, (entry) => {
+        const {
+          // eslint-disable-next-line @typescript-eslint/no-unused-vars
+          address: _,
+          ...accountMeta
+        } = account;
+        if (TYPE in entry) {
+          switch (entry[TYPE]) {
+            case 0 /* FEE_PAYER */:
+              return entry;
+            case 1 /* LOOKUP_TABLE */: {
+              const nextRole = mergeRoles(entry.role, accountMeta.role);
+              if ("lookupTableAddress" in accountMeta) {
+                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 = keys.getBase58EncodedAddressComparator()))(
+                    accountMeta.lookupTableAddress,
+                    entry.lookupTableAddress
+                  ) < 0
+                );
+                if (shouldReplaceEntry) {
+                  return {
+                    [TYPE]: 1 /* LOOKUP_TABLE */,
+                    ...accountMeta,
+                    role: nextRole
+                  };
+                }
+              } else if (isSignerRole(accountMeta.role)) {
+                return {
+                  [TYPE]: 2 /* STATIC */,
+                  role: nextRole
+                };
+              }
+              if (entry.role !== nextRole) {
+                return {
+                  ...entry,
+                  role: nextRole
+                };
+              } else {
+                return entry;
+              }
+            }
+            case 2 /* STATIC */: {
+              const nextRole = mergeRoles(entry.role, accountMeta.role);
+              if (
+                // Check to see if this address represents a program that is invoked
+                // in this transaction.
+                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.`
+                  );
+                }
+                if (entry.role !== nextRole) {
+                  return {
+                    ...entry,
+                    role: nextRole
+                  };
+                } else {
+                  return entry;
+                }
+              } else if ("lookupTableAddress" in accountMeta && // Static accounts can be 'upgraded' to lookup table accounts as
+              // long as they are not require to sign the transaction.
+              !isSignerRole(entry.role)) {
+                return {
+                  ...accountMeta,
+                  [TYPE]: 1 /* LOOKUP_TABLE */,
+                  role: nextRole
+                };
+              } else {
+                if (entry.role !== nextRole) {
+                  return {
+                    ...entry,
+                    role: nextRole
+                  };
+                } else {
+                  return entry;
+                }
+              }
+            }
+          }
+        }
+        if ("lookupTableAddress" in accountMeta) {
+          return {
+            ...accountMeta,
+            [TYPE]: 1 /* LOOKUP_TABLE */
+          };
+        } else {
+          return {
+            ...accountMeta,
+            [TYPE]: 2 /* STATIC */
+          };
+        }
+      });
+    }
+  }
+  return addressMap;
+}
+function getOrderedAccountsFromAddressMap(addressMap) {
+  let addressComparator;
+  const orderedAccounts = Object.entries(addressMap).sort(([leftAddress, leftEntry], [rightAddress, rightEntry]) => {
+    if (leftEntry[TYPE] !== rightEntry[TYPE]) {
+      if (leftEntry[TYPE] === 0 /* FEE_PAYER */) {
+        return -1;
+      } else if (rightEntry[TYPE] === 0 /* FEE_PAYER */) {
+        return 1;
+      } else if (leftEntry[TYPE] === 2 /* STATIC */) {
+        return -1;
+      } else if (rightEntry[TYPE] === 2 /* STATIC */) {
+        return 1;
+      }
+    }
+    const leftIsSigner = isSignerRole(leftEntry.role);
+    if (leftIsSigner !== isSignerRole(rightEntry.role)) {
+      return leftIsSigner ? -1 : 1;
+    }
+    const leftIsWritable = isWritableRole(leftEntry.role);
+    if (leftIsWritable !== isWritableRole(rightEntry.role)) {
+      return leftIsWritable ? -1 : 1;
+    }
+    addressComparator || (addressComparator = keys.getBase58EncodedAddressComparator());
+    if (leftEntry[TYPE] === 1 /* LOOKUP_TABLE */ && rightEntry[TYPE] === 1 /* LOOKUP_TABLE */ && leftEntry.lookupTableAddress !== rightEntry.lookupTableAddress) {
+      return addressComparator(leftEntry.lookupTableAddress, rightEntry.lookupTableAddress);
+    } else {
+      return addressComparator(leftAddress, rightAddress);
+    }
+  }).map(([address, addressMeta]) => ({
+    address,
+    ...addressMeta
+  }));
+  return orderedAccounts;
+}
+function getCompiledAddressTableLookups(orderedAccounts) {
+  var _a;
+  const index = {};
+  for (const account of orderedAccounts) {
+    if (!("lookupTableAddress" in account)) {
+      continue;
+    }
+    const entry = index[_a = account.lookupTableAddress] || (index[_a] = {
+      readableIndices: [],
+      writableIndices: []
+    });
+    if (account.role === AccountRole.WRITABLE) {
+      entry.writableIndices.push(account.addressIndex);
+    } else {
+      entry.readableIndices.push(account.addressIndex);
+    }
+  }
+  return Object.keys(index).sort(keys.getBase58EncodedAddressComparator()).map((lookupTableAddress) => ({
+    lookupTableAddress,
+    ...index[lookupTableAddress]
+  }));
+}
+
+// src/compile-header.ts
+function getCompiledMessageHeader(orderedAccounts) {
+  let numReadonlyNonSignerAccounts = 0;
+  let numReadonlySignerAccounts = 0;
+  let numSignerAccounts = 0;
+  for (const account of orderedAccounts) {
+    if ("lookupTableAddress" in account) {
+      break;
+    }
+    const accountIsWritable = isWritableRole(account.role);
+    if (isSignerRole(account.role)) {
+      numSignerAccounts++;
+      if (!accountIsWritable) {
+        numReadonlySignerAccounts++;
+      }
+    } else if (!accountIsWritable) {
+      numReadonlyNonSignerAccounts++;
+    }
+  }
+  return {
+    numReadonlyNonSignerAccounts,
+    numReadonlySignerAccounts,
+    numSignerAccounts
+  };
+}
+
+// src/compile-instructions.ts
+function getAccountIndex(orderedAccounts) {
+  const out = {};
+  for (const [index, account] of orderedAccounts.entries()) {
+    out[account.address] = index;
+  }
+  return out;
+}
+function getCompiledInstructions(instructions, orderedAccounts) {
+  const accountIndex = getAccountIndex(orderedAccounts);
+  return instructions.map(({ accounts, data, programAddress }) => {
+    return {
+      programAddressIndex: accountIndex[programAddress],
+      ...accounts ? { accountIndices: accounts.map(({ address }) => accountIndex[address]) } : null,
+      ...data ? { data } : null
+    };
+  });
+}
+
+// src/compile-lifetime-token.ts
+function getCompiledLifetimeToken(lifetimeConstraint) {
+  if ("nonce" in lifetimeConstraint) {
+    return lifetimeConstraint.nonce;
+  }
+  return lifetimeConstraint.blockhash;
+}
+
+// src/compile-static-accounts.ts
+function getCompiledStaticAccounts(orderedAccounts) {
+  const firstLookupTableAccountIndex = orderedAccounts.findIndex((account) => "lookupTableAddress" in account);
+  const orderedStaticAccounts = firstLookupTableAccountIndex === -1 ? orderedAccounts : orderedAccounts.slice(0, firstLookupTableAccountIndex);
+  return orderedStaticAccounts.map(({ address }) => address);
+}
+
+// src/message.ts
+function compileMessage(transaction) {
+  const addressMap = getAddressMapFromInstructions(transaction.feePayer, transaction.instructions);
+  const orderedAccounts = getOrderedAccountsFromAddressMap(addressMap);
+  return {
+    ...transaction.version !== "legacy" ? { addressTableLookups: getCompiledAddressTableLookups(orderedAccounts) } : null,
+    header: getCompiledMessageHeader(orderedAccounts),
+    instructions: getCompiledInstructions(transaction.instructions, orderedAccounts),
+    lifetimeToken: getCompiledLifetimeToken(transaction.lifetimeConstraint),
+    staticAccounts: getCompiledStaticAccounts(orderedAccounts),
+    version: transaction.version
+  };
+}
+function getAddressTableLookupCodec() {
+  return umiSerializers.struct(
+    [
+      [
+        "lookupTableAddress",
+        keys.getBase58EncodedAddressCodec(
+          __DEV__ ? {
+            description: "The address of the address lookup table account from which instruction addresses should be looked up"
+          } : void 0
+        )
+      ],
+      [
+        "writableIndices",
+        umiSerializers.array(umiSerializers.u8(), {
+          ...__DEV__ ? {
+            description: "The indices of the accounts in the lookup table that should be loaded as writeable"
+          } : null,
+          size: umiSerializers.shortU16()
+        })
+      ],
+      [
+        "readableIndices",
+        umiSerializers.array(umiSerializers.u8(), {
+          ...__DEV__ ? {
+            description: "The indices of the accounts in the lookup table that should be loaded as read-only"
+          } : void 0,
+          size: umiSerializers.shortU16()
+        })
+      ]
+    ],
+    __DEV__ ? {
+      description: "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"
+    } : void 0
+  );
+}
+function getMessageHeaderCodec() {
+  return umiSerializers.struct(
+    [
+      [
+        "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
+        )
+      ]
+    ],
+    __DEV__ ? {
+      description: "The transaction message header containing counts of the signer, readonly-signer, and readonly-nonsigner account addresses"
+    } : void 0
+  );
+}
+function getInstructionCodec() {
+  return umiSerializers.mapSerializer(
+    umiSerializers.struct([
+      [
+        "programAddressIndex",
+        umiSerializers.u8(
+          __DEV__ ? {
+            description: "The index of the program being called, according to the well-ordered accounts list for this transaction"
+          } : void 0
+        )
+      ],
+      [
+        "addressIndices",
+        umiSerializers.array(
+          umiSerializers.u8({
+            description: __DEV__ ? "The index of an account, according to the well-ordered accounts list for this transaction" : ""
+          }),
+          {
+            description: __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" : "",
+            size: umiSerializers.shortU16()
+          }
+        )
+      ],
+      [
+        "data",
+        umiSerializers.bytes({
+          description: __DEV__ ? "An optional buffer of data passed to the instruction" : "",
+          size: umiSerializers.shortU16()
+        })
+      ]
+    ]),
+    (value) => {
+      if (value.addressIndices !== void 0 && value.data !== void 0) {
+        return value;
+      }
+      return {
+        ...value,
+        addressIndices: value.addressIndices ?? [],
+        data: value.data ?? new Uint8Array(0)
+      };
+    },
+    (value) => {
+      if (value.addressIndices.length && value.data.byteLength) {
+        return value;
+      }
+      const { addressIndices, data, ...rest } = value;
+      return {
+        ...rest,
+        ...addressIndices.length ? { addressIndices } : null,
+        ...data.byteLength ? { data } : null
+      };
+    }
+  );
+}
+
+// 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) {
+  const firstByte = bytes3[offset];
+  if ((firstByte & VERSION_FLAG_MASK) === 0) {
+    return ["legacy", offset];
+  } else {
+    const version = firstByte ^ VERSION_FLAG_MASK;
+    return [version, offset + 1];
+  }
+}
+function serialize(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 getTransactionVersionCodec() {
+  return {
+    ...BASE_CONFIG,
+    deserialize,
+    serialize
+  };
+}
+
+// src/serializers/message.ts
+var BASE_CONFIG2 = {
+  description: __DEV__ ? "The wire format of a Solana transaction message" : "",
+  fixedSize: null,
+  maxSize: null
+};
+function serialize2(compiledMessage) {
+  if (compiledMessage.version === "legacy") {
+    return umiSerializers.struct(getPreludeStructSerializerTuple()).serialize(compiledMessage);
+  } else {
+    return umiSerializers.mapSerializer(
+      umiSerializers.struct([
+        ...getPreludeStructSerializerTuple(),
+        ["addressTableLookups", getAddressTableLookupsSerializer()]
+      ]),
+      (value) => {
+        if (value.version === "legacy") {
+          return value;
+        }
+        return {
+          ...value,
+          addressTableLookups: value.addressTableLookups ?? []
+        };
+      }
+    ).serialize(compiledMessage);
+  }
+}
+function getPreludeStructSerializerTuple() {
+  return [
+    ["version", getTransactionVersionCodec()],
+    ["header", getMessageHeaderCodec()],
+    [
+      "staticAccounts",
+      umiSerializers.array(keys.getBase58EncodedAddressCodec(), {
+        description: __DEV__ ? "A compact-array of static account addresses belonging to this transaction" : "",
+        size: umiSerializers.shortU16()
+      })
+    ],
+    [
+      "lifetimeToken",
+      umiSerializers.string({
+        description: __DEV__ ? "A 32-byte token that specifies the lifetime of this transaction (eg. a recent blockhash, or a durable nonce)" : "",
+        encoding: umiSerializers.base58,
+        size: 32
+      })
+    ],
+    [
+      "instructions",
+      umiSerializers.array(getInstructionCodec(), {
+        description: __DEV__ ? "A compact-array of instructions belonging to this transaction" : "",
+        size: umiSerializers.shortU16()
+      })
+    ]
+  ];
+}
+function getAddressTableLookupsSerializer() {
+  return umiSerializers.array(getAddressTableLookupCodec(), {
+    ...__DEV__ ? { description: "A compact array of address table lookups belonging to this transaction" } : null,
+    size: umiSerializers.shortU16()
+  });
+}
+function getCompiledMessageEncoder() {
+  return {
+    ...BASE_CONFIG2,
+    deserialize: getUnimplementedDecoder("CompiledMessage"),
+    serialize: serialize2
+  };
+}
+
+// src/signatures.ts
+async function getCompiledMessageSignature(message, secretKey) {
+  const wireMessageBytes = getCompiledMessageEncoder().serialize(message);
+  const signature = await keys.signBytes(secretKey, wireMessageBytes);
+  return signature;
+}
+async function signTransaction(keyPair, transaction) {
+  const compiledMessage = compileMessage(transaction);
+  const [signerPublicKey, signature] = await Promise.all([
+    keys.getBase58EncodedAddressFromPublicKey(keyPair.publicKey),
+    getCompiledMessageSignature(compiledMessage, keyPair.privateKey)
+  ]);
+  const nextSignatures = {
+    ..."signatures" in transaction ? transaction.signatures : null,
+    ...{ [signerPublicKey]: signature }
+  };
+  const out = {
+    ...transaction,
+    signatures: nextSignatures
+  };
+  Object.freeze(out);
+  return out;
+}
+
+// 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);
+  {
+    return btoa(String.fromCharCode(...wireTransactionBytes));
+  }
+}
+
 exports.appendTransactionInstruction = appendTransactionInstruction;
+exports.assertIsBlockhash = assertIsBlockhash;
 exports.createTransaction = createTransaction;
+exports.getBase64EncodedWireTransaction = getBase64EncodedWireTransaction;
 exports.prependTransactionInstruction = prependTransactionInstruction;
 exports.setTransactionFeePayer = setTransactionFeePayer;
+exports.signTransaction = signTransaction;
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=index.browser.cjs.map