@solana/transactions 2.0.0-experimental.2bae733 → 2.0.0-experimental.2f6fdd4

package/dist/index.development.js

@@ -9,78 +9,6 @@ this.globalThis.solanaWeb3 = (function (exports) {
     return value;
   };
 
-  // src/create-transaction.ts
-  function createTransaction({
-    version
-  }) {
-    const out = {
-      instructions: [],
-      version
-    };
-    Object.freeze(out);
-    return out;
-  }
-
-  // src/fee-payer.ts
-  function setTransactionFeePayer(feePayer, transaction) {
-    if ("feePayer" in transaction && feePayer === transaction.feePayer) {
-      return transaction;
-    }
-    let out;
-    if ("signatures" in transaction) {
-      const {
-        signatures: _,
-        // eslint-disable-line @typescript-eslint/no-unused-vars
-        ...unsignedTransaction
-      } = transaction;
-      out = {
-        ...unsignedTransaction,
-        feePayer
-      };
-    } else {
-      out = {
-        ...transaction,
-        feePayer
-      };
-    }
-    Object.freeze(out);
-    return out;
-  }
-
-  // src/instructions.ts
-  function replaceInstructions(transaction, nextInstructions) {
-    let out;
-    if ("signatures" in transaction) {
-      const {
-        signatures: _,
-        // eslint-disable-line @typescript-eslint/no-unused-vars
-        ...unsignedTransaction
-      } = transaction;
-      out = {
-        ...unsignedTransaction,
-        instructions: nextInstructions
-      };
-    } else {
-      out = {
-        ...transaction,
-        instructions: nextInstructions
-      };
-    }
-    return out;
-  }
-  function appendTransactionInstruction(instruction, transaction) {
-    const nextInstructions = [...transaction.instructions, instruction];
-    const out = replaceInstructions(transaction, nextInstructions);
-    Object.freeze(out);
-    return out;
-  }
-  function prependTransactionInstruction(instruction, transaction) {
-    const nextInstructions = [instruction, ...transaction.instructions];
-    const out = replaceInstructions(transaction, nextInstructions);
-    Object.freeze(out);
-    return out;
-  }
-
   // ../../node_modules/.pnpm/@metaplex-foundation+umi-serializers-core@0.8.2/node_modules/@metaplex-foundation/umi-serializers-core/dist/esm/bytes.mjs
   var mergeBytes = (bytesArr) => {
     const totalLength = bytesArr.reduce((total, arr) => total + arr.length, 0);
@@ -360,7 +288,7 @@ this.globalThis.solanaWeb3 = (function (exports) {
     }
   });
 
-  // ../../node_modules/.pnpm/@metaplex-foundation+umi-serializers@0.8.2/node_modules/@metaplex-foundation/umi-serializers/dist/esm/errors.mjs
+  // ../../node_modules/.pnpm/@metaplex-foundation+umi-serializers@0.8.5/node_modules/@metaplex-foundation/umi-serializers/dist/esm/errors.mjs
   var InvalidNumberOfItemsError = class extends Error {
     constructor(serializer, expected, actual) {
       super(`Expected [${serializer}] to have ${expected} items, got ${actual}.`);
@@ -380,12 +308,12 @@ this.globalThis.solanaWeb3 = (function (exports) {
     }
   };
 
-  // ../../node_modules/.pnpm/@metaplex-foundation+umi-serializers@0.8.2/node_modules/@metaplex-foundation/umi-serializers/dist/esm/sumSerializerSizes.mjs
+  // ../../node_modules/.pnpm/@metaplex-foundation+umi-serializers@0.8.5/node_modules/@metaplex-foundation/umi-serializers/dist/esm/sumSerializerSizes.mjs
   function sumSerializerSizes(sizes) {
     return sizes.reduce((all, size) => all === null || size === null ? null : all + size, 0);
   }
 
-  // ../../node_modules/.pnpm/@metaplex-foundation+umi-serializers@0.8.2/node_modules/@metaplex-foundation/umi-serializers/dist/esm/utils.mjs
+  // ../../node_modules/.pnpm/@metaplex-foundation+umi-serializers@0.8.5/node_modules/@metaplex-foundation/umi-serializers/dist/esm/utils.mjs
   function getResolvedSize(size, childrenSizes, bytes2, offset) {
     if (typeof size === "number") {
       return [size, offset];
@@ -421,7 +349,7 @@ this.globalThis.solanaWeb3 = (function (exports) {
     return typeof size === "object" ? size.serialize(realSize) : new Uint8Array();
   }
 
-  // ../../node_modules/.pnpm/@metaplex-foundation+umi-serializers@0.8.2/node_modules/@metaplex-foundation/umi-serializers/dist/esm/array.mjs
+  // ../../node_modules/.pnpm/@metaplex-foundation+umi-serializers@0.8.5/node_modules/@metaplex-foundation/umi-serializers/dist/esm/array.mjs
   function array(item, options = {}) {
     const size = options.size ?? u32();
     if (size === "remainder" && item.fixedSize === null) {
@@ -454,7 +382,7 @@ this.globalThis.solanaWeb3 = (function (exports) {
     };
   }
 
-  // ../../node_modules/.pnpm/@metaplex-foundation+umi-serializers@0.8.2/node_modules/@metaplex-foundation/umi-serializers/dist/esm/bytes.mjs
+  // ../../node_modules/.pnpm/@metaplex-foundation+umi-serializers@0.8.5/node_modules/@metaplex-foundation/umi-serializers/dist/esm/bytes.mjs
   function bytes(options = {}) {
     const size = options.size ?? "variable";
     const description = options.description ?? `bytes(${getSizeDescription(size)})`;
@@ -501,7 +429,7 @@ this.globalThis.solanaWeb3 = (function (exports) {
     };
   }
 
-  // ../../node_modules/.pnpm/@metaplex-foundation+umi-serializers@0.8.2/node_modules/@metaplex-foundation/umi-serializers/dist/esm/string.mjs
+  // ../../node_modules/.pnpm/@metaplex-foundation+umi-serializers@0.8.5/node_modules/@metaplex-foundation/umi-serializers/dist/esm/string.mjs
   function string(options = {}) {
     const size = options.size ?? u32();
     const encoding = options.encoding ?? utf8;
@@ -542,7 +470,7 @@ this.globalThis.solanaWeb3 = (function (exports) {
     };
   }
 
-  // ../../node_modules/.pnpm/@metaplex-foundation+umi-serializers@0.8.2/node_modules/@metaplex-foundation/umi-serializers/dist/esm/struct.mjs
+  // ../../node_modules/.pnpm/@metaplex-foundation+umi-serializers@0.8.5/node_modules/@metaplex-foundation/umi-serializers/dist/esm/struct.mjs
   function struct(fields, options = {}) {
     const fieldDescriptions = fields.map(([name, serializer]) => `${String(name)}: ${serializer.description}`).join(", ");
     return {
@@ -564,23 +492,180 @@ this.globalThis.solanaWeb3 = (function (exports) {
       }
     };
   }
-  function getBase58EncodedAddressCodec(config) {
-    return string({
-      description: config?.description ?? ("A 32-byte account address" ),
-      encoding: base58,
-      size: 32
-    });
+
+  // src/unsigned-transaction.ts
+  function getUnsignedTransaction(transaction) {
+    if ("signatures" in transaction) {
+      const {
+        signatures: _,
+        // eslint-disable-line @typescript-eslint/no-unused-vars
+        ...unsignedTransaction
+      } = transaction;
+      return unsignedTransaction;
+    } else {
+      return transaction;
+    }
   }
-  function getBase58EncodedAddressComparator() {
-    return new Intl.Collator("en", {
-      caseFirst: "lower",
-      ignorePunctuation: false,
-      localeMatcher: "best fit",
-      numeric: false,
-      sensitivity: "variant",
-      usage: "sort"
-    }).compare;
+
+  // src/blockhash.ts
+  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 bytes2 = base58.serialize(putativeBlockhash);
+      const numBytes = bytes2.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
+      });
+    }
+  }
+  function setTransactionLifetimeUsingBlockhash(blockhashLifetimeConstraint, transaction) {
+    if ("lifetimeConstraint" in transaction && transaction.lifetimeConstraint.blockhash === blockhashLifetimeConstraint.blockhash && transaction.lifetimeConstraint.lastValidBlockHeight === blockhashLifetimeConstraint.lastValidBlockHeight) {
+      return transaction;
+    }
+    const out = {
+      ...getUnsignedTransaction(transaction),
+      lifetimeConstraint: blockhashLifetimeConstraint
+    };
+    Object.freeze(out);
+    return out;
+  }
+
+  // src/create-transaction.ts
+  function createTransaction({
+    version
+  }) {
+    const out = {
+      instructions: [],
+      version
+    };
+    Object.freeze(out);
+    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;
+  }
+
+  // src/durable-nonce.ts
+  var RECENT_BLOCKHASHES_SYSVAR_ADDRESS = "SysvarRecentB1ockHashes11111111111111111111";
+  var SYSTEM_PROGRAM_ADDRESS = "11111111111111111111111111111111";
+  function assertIsDurableNonceTransaction(transaction) {
+    if (!isDurableNonceTransaction(transaction)) {
+      throw new Error("Transaction is not a durable nonce transaction");
+    }
+  }
+  function createAdvanceNonceAccountInstruction(nonceAccountAddress, nonceAuthorityAddress) {
+    return {
+      accounts: [
+        { address: nonceAccountAddress, role: AccountRole.WRITABLE },
+        {
+          address: RECENT_BLOCKHASHES_SYSVAR_ADDRESS,
+          role: AccountRole.READONLY
+        },
+        { address: nonceAuthorityAddress, role: AccountRole.READONLY_SIGNER }
+      ],
+      data: new Uint8Array([4, 0, 0, 0]),
+      programAddress: SYSTEM_PROGRAM_ADDRESS
+    };
+  }
+  function isAdvanceNonceAccountInstruction(instruction) {
+    return instruction.programAddress === SYSTEM_PROGRAM_ADDRESS && // Test for `AdvanceNonceAccount` instruction data
+    instruction.data != null && isAdvanceNonceAccountInstructionData(instruction.data) && // Test for exactly 3 accounts
+    instruction.accounts?.length === 3 && // First account is nonce account address
+    instruction.accounts[0].address != null && instruction.accounts[0].role === AccountRole.WRITABLE && // Second account is recent blockhashes sysvar
+    instruction.accounts[1].address === RECENT_BLOCKHASHES_SYSVAR_ADDRESS && instruction.accounts[1].role === AccountRole.READONLY && // Third account is nonce authority account
+    instruction.accounts[2].address != null && instruction.accounts[2].role === AccountRole.READONLY_SIGNER;
   }
+  function isAdvanceNonceAccountInstructionData(data) {
+    return data.byteLength === 4 && data[0] === 4 && data[1] === 0 && data[2] === 0 && data[3] === 0;
+  }
+  function isDurableNonceTransaction(transaction) {
+    return "lifetimeConstraint" in transaction && typeof transaction.lifetimeConstraint.nonce === "string" && transaction.instructions[0] != null && isAdvanceNonceAccountInstruction(transaction.instructions[0]);
+  }
+  function setTransactionLifetimeUsingDurableNonce({
+    nonce,
+    nonceAccountAddress,
+    nonceAuthorityAddress
+  }, transaction) {
+    const isAlreadyDurableNonceTransaction = isDurableNonceTransaction(transaction);
+    if (isAlreadyDurableNonceTransaction && transaction.lifetimeConstraint.nonce === nonce && transaction.instructions[0].accounts[0].address === nonceAccountAddress && transaction.instructions[0].accounts[2].address === nonceAuthorityAddress) {
+      return transaction;
+    }
+    const out = {
+      ...getUnsignedTransaction(transaction),
+      instructions: [
+        createAdvanceNonceAccountInstruction(nonceAccountAddress, nonceAuthorityAddress),
+        ...isAlreadyDurableNonceTransaction ? transaction.instructions.slice(1) : transaction.instructions
+      ],
+      lifetimeConstraint: {
+        nonce
+      }
+    };
+    Object.freeze(out);
+    return out;
+  }
+
+  // src/fee-payer.ts
+  function setTransactionFeePayer(feePayer, transaction) {
+    if ("feePayer" in transaction && feePayer === transaction.feePayer) {
+      return transaction;
+    }
+    const out = {
+      ...getUnsignedTransaction(transaction),
+      feePayer
+    };
+    Object.freeze(out);
+    return out;
+  }
+
+  // src/instructions.ts
+  function appendTransactionInstruction(instruction, transaction) {
+    const out = {
+      ...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;
+  }
+
+  // ../assertions/dist/index.browser.js
   function assertIsSecureContext() {
     if (!globalThis.isSecureContext) {
       throw new Error(
@@ -600,7 +685,24 @@ this.globalThis.solanaWeb3 = (function (exports) {
       throw new Error("No signing implementation could be found");
     }
   }
-  async function getBase58EncodedAddressFromPublicKey(publicKey) {
+  function getBase58EncodedAddressCodec(config) {
+    return string({
+      description: config?.description ?? ("A 32-byte account address" ),
+      encoding: base58,
+      size: 32
+    });
+  }
+  function getBase58EncodedAddressComparator() {
+    return new Intl.Collator("en", {
+      caseFirst: "lower",
+      ignorePunctuation: false,
+      localeMatcher: "best fit",
+      numeric: false,
+      sensitivity: "variant",
+      usage: "sort"
+    }).compare;
+  }
+  async function getAddressFromPublicKey(publicKey) {
     await assertKeyExporterIsAvailable();
     if (publicKey.type !== "public" || publicKey.algorithm.name !== "Ed25519") {
       throw new Error("The `CryptoKey` must be an `Ed25519` public key");
@@ -609,35 +711,14 @@ this.globalThis.solanaWeb3 = (function (exports) {
     const [base58EncodedAddress] = getBase58EncodedAddressCodec().deserialize(new Uint8Array(publicKeyBytes));
     return base58EncodedAddress;
   }
+
+  // ../keys/dist/index.browser.js
   async function signBytes(key, data) {
     await assertSigningCapabilityIsAvailable();
     const signedData = await crypto.subtle.sign("Ed25519", key, data);
     return new Uint8Array(signedData);
   }
 
-  // ../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;
-  }
-
   // src/accounts.ts
   function upsert(addressMap, address, update) {
     addressMap[address] = update(addressMap[address] ?? { role: AccountRole.READONLY });
@@ -993,7 +1074,7 @@ this.globalThis.solanaWeb3 = (function (exports) {
           )
         ],
         [
-          "addressIndices",
+          "accountIndices",
           array(
             u8({
               description: "The index of an account, according to the well-ordered accounts list for this transaction" 
@@ -1013,23 +1094,23 @@ this.globalThis.solanaWeb3 = (function (exports) {
         ]
       ]),
       (value) => {
-        if (value.addressIndices !== void 0 && value.data !== void 0) {
+        if (value.accountIndices !== void 0 && value.data !== void 0) {
           return value;
         }
         return {
           ...value,
-          addressIndices: value.addressIndices ?? [],
+          accountIndices: value.accountIndices ?? [],
           data: value.data ?? new Uint8Array(0)
         };
       },
       (value) => {
-        if (value.addressIndices.length && value.data.byteLength) {
+        if (value.accountIndices.length && value.data.byteLength) {
           return value;
         }
-        const { addressIndices, data, ...rest } = value;
+        const { accountIndices, data, ...rest } = value;
         return {
           ...rest,
-          ...addressIndices.length ? { addressIndices } : null,
+          ...accountIndices.length ? { accountIndices } : null,
           ...data.byteLength ? { data } : null
         };
       }
@@ -1160,7 +1241,7 @@ this.globalThis.solanaWeb3 = (function (exports) {
   async function signTransaction(keyPair, transaction) {
     const compiledMessage = compileMessage(transaction);
     const [signerPublicKey, signature] = await Promise.all([
-      getBase58EncodedAddressFromPublicKey(keyPair.publicKey),
+      getAddressFromPublicKey(keyPair.publicKey),
       getCompiledMessageSignature(compiledMessage, keyPair.privateKey)
     ]);
     const nextSignatures = {
@@ -1175,10 +1256,68 @@ this.globalThis.solanaWeb3 = (function (exports) {
     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: "The wire format of a Solana transaction" ,
+    fixedSize: null,
+    maxSize: null
+  };
+  function serialize3(transaction) {
+    const compiledTransaction = getCompiledTransaction(transaction);
+    return struct([
+      [
+        "signatures",
+        array(bytes({ size: 64 }), {
+          ...{ description: "A compact array of 64-byte, base-64 encoded Ed25519 signatures" } ,
+          size: 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.assertIsDurableNonceTransaction = assertIsDurableNonceTransaction;
   exports.createTransaction = createTransaction;
+  exports.getBase64EncodedWireTransaction = getBase64EncodedWireTransaction;
   exports.prependTransactionInstruction = prependTransactionInstruction;
   exports.setTransactionFeePayer = setTransactionFeePayer;
+  exports.setTransactionLifetimeUsingBlockhash = setTransactionLifetimeUsingBlockhash;
+  exports.setTransactionLifetimeUsingDurableNonce = setTransactionLifetimeUsingDurableNonce;
   exports.signTransaction = signTransaction;
 
   return exports;