@solana/signers 2.0.0-experimental.025ef21

package/dist/index.browser.cjs

@@ -0,0 +1,347 @@
+'use strict';
+
+var instructions = require('@solana/instructions');
+var transactions = require('@solana/transactions');
+var addresses = require('@solana/addresses');
+var keys = require('@solana/keys');
+
+// src/deduplicate-signers.ts
+function deduplicateSigners(signers) {
+  const deduplicated = {};
+  signers.forEach((signer) => {
+    if (!deduplicated[signer.address]) {
+      deduplicated[signer.address] = signer;
+    } else if (deduplicated[signer.address] !== signer) {
+      throw new Error(
+        `Multiple distinct signers were identified for address "${signer.address}". Please ensure that you are using the same signer instance for each address.`
+      );
+    }
+  });
+  return Object.values(deduplicated);
+}
+
+// src/account-signer-meta.ts
+function getSignersFromInstruction(instruction) {
+  return deduplicateSigners(
+    (instruction.accounts ?? []).flatMap((account) => "signer" in account ? account.signer : [])
+  );
+}
+function getSignersFromTransaction(transaction) {
+  return deduplicateSigners([
+    ...transaction.feePayerSigner ? [transaction.feePayerSigner] : [],
+    ...transaction.instructions.flatMap(getSignersFromInstruction)
+  ]);
+}
+function addSignersToInstruction(signers, instruction) {
+  if (!instruction.accounts || instruction.accounts.length === 0) {
+    return instruction;
+  }
+  const signerByAddress = new Map(deduplicateSigners(signers).map((signer) => [signer.address, signer]));
+  return Object.freeze({
+    ...instruction,
+    accounts: instruction.accounts.map((account) => {
+      const signer = signerByAddress.get(account.address);
+      if (!instructions.isSignerRole(account.role) || "signer" in account || !signer) {
+        return account;
+      }
+      return Object.freeze({ ...account, signer });
+    })
+  });
+}
+function addSignersToTransaction(signers, transaction) {
+  if (transaction.instructions.length === 0) {
+    return transaction;
+  }
+  return Object.freeze({
+    ...transaction,
+    instructions: transaction.instructions.map((instruction) => addSignersToInstruction(signers, instruction))
+  });
+}
+function setTransactionFeePayerSigner(feePayerSigner, transaction) {
+  if ("feePayer" in transaction && feePayerSigner.address === transaction.feePayer) {
+    if ("feePayerSigner" in transaction)
+      return transaction;
+    const out2 = { ...transaction, feePayerSigner };
+    Object.freeze(out2);
+    return out2;
+  }
+  const out = {
+    ...transactions.getUnsignedTransaction(transaction),
+    feePayer: feePayerSigner.address,
+    feePayerSigner
+  };
+  Object.freeze(out);
+  return out;
+}
+
+// src/message-partial-signer.ts
+function isMessagePartialSigner(value) {
+  return "signMessages" in value && typeof value.signMessages === "function";
+}
+function assertIsMessagePartialSigner(value) {
+  if (!isMessagePartialSigner(value)) {
+    throw new Error("The provided value does not implement the MessagePartialSigner interface");
+  }
+}
+
+// src/transaction-partial-signer.ts
+function isTransactionPartialSigner(value) {
+  return "signTransactions" in value && typeof value.signTransactions === "function";
+}
+function assertIsTransactionPartialSigner(value) {
+  if (!isTransactionPartialSigner(value)) {
+    throw new Error("The provided value does not implement the TransactionPartialSigner interface");
+  }
+}
+
+// src/keypair-signer.ts
+function isKeyPairSigner(value) {
+  return "keyPair" in value && typeof value.keyPair === "object" && isMessagePartialSigner(value) && isTransactionPartialSigner(value);
+}
+function assertIsKeyPairSigner(value) {
+  if (!isKeyPairSigner(value)) {
+    throw new Error("The provided value does not implement the KeyPairSigner interface");
+  }
+}
+async function createSignerFromKeyPair(keyPair) {
+  const address = await addresses.getAddressFromPublicKey(keyPair.publicKey);
+  const out = {
+    address,
+    keyPair,
+    signMessages: (messages) => Promise.all(
+      messages.map(
+        async (message) => Object.freeze({ [address]: await keys.signBytes(keyPair.privateKey, message.content) })
+      )
+    ),
+    signTransactions: (transactions$1) => Promise.all(
+      transactions$1.map(async (transaction) => {
+        const signedTransaction = await transactions.partiallySignTransaction([keyPair], transaction);
+        return Object.freeze({ [address]: signedTransaction.signatures[address] });
+      })
+    )
+  };
+  return Object.freeze(out);
+}
+async function generateKeyPairSigner() {
+  return createSignerFromKeyPair(await keys.generateKeyPair());
+}
+function isMessageModifyingSigner(value) {
+  return addresses.isAddress(value.address) && "modifyAndSignMessages" in value && typeof value.modifyAndSignMessages === "function";
+}
+function assertIsMessageModifyingSigner(value) {
+  if (!isMessageModifyingSigner(value)) {
+    throw new Error("The provided value does not implement the MessageModifyingSigner interface");
+  }
+}
+
+// src/message-signer.ts
+function isMessageSigner(value) {
+  return isMessagePartialSigner(value) || isMessageModifyingSigner(value);
+}
+function assertIsMessageSigner(value) {
+  if (!isMessageSigner(value)) {
+    throw new Error("The provided value does not implement any of the MessageSigner interfaces");
+  }
+}
+
+// src/noop-signer.ts
+function createNoopSigner(address) {
+  const out = {
+    address,
+    signMessages: async (messages) => messages.map(() => Object.freeze({})),
+    signTransactions: async (transactions) => transactions.map(() => Object.freeze({}))
+  };
+  return Object.freeze(out);
+}
+
+// src/transaction-modifying-signer.ts
+function isTransactionModifyingSigner(value) {
+  return "modifyAndSignTransactions" in value && typeof value.modifyAndSignTransactions === "function";
+}
+function assertIsTransactionModifyingSigner(value) {
+  if (!isTransactionModifyingSigner(value)) {
+    throw new Error("The provided value does not implement the TransactionModifyingSigner interface");
+  }
+}
+
+// src/transaction-sending-signer.ts
+function isTransactionSendingSigner(value) {
+  return "signAndSendTransactions" in value && typeof value.signAndSendTransactions === "function";
+}
+function assertIsTransactionSendingSigner(value) {
+  if (!isTransactionSendingSigner(value)) {
+    throw new Error("The provided value does not implement the TransactionSendingSigner interface");
+  }
+}
+
+// src/transaction-signer.ts
+function isTransactionSigner(value) {
+  return isTransactionPartialSigner(value) || isTransactionModifyingSigner(value) || isTransactionSendingSigner(value);
+}
+function assertIsTransactionSigner(value) {
+  if (!isTransactionSigner(value)) {
+    throw new Error("The provided value does not implement any of the TransactionSigner interfaces");
+  }
+}
+
+// src/sign-transaction.ts
+async function partiallySignTransactionWithSigners(transaction, config = {}) {
+  const { partialSigners, modifyingSigners } = categorizeTransactionSigners(
+    deduplicateSigners(getSignersFromTransaction(transaction).filter(isTransactionSigner)),
+    { identifySendingSigner: false }
+  );
+  return signModifyingAndPartialTransactionSigners(transaction, modifyingSigners, partialSigners, config.abortSignal);
+}
+async function signTransactionWithSigners(transaction, config = {}) {
+  const signedTransaction = await partiallySignTransactionWithSigners(transaction, config);
+  transactions.assertTransactionIsFullySigned(signedTransaction);
+  return signedTransaction;
+}
+async function signAndSendTransactionWithSigners(transaction, config = {}) {
+  const abortSignal = config.abortSignal;
+  const { partialSigners, modifyingSigners, sendingSigner } = categorizeTransactionSigners(
+    deduplicateSigners(getSignersFromTransaction(transaction).filter(isTransactionSigner))
+  );
+  abortSignal?.throwIfAborted();
+  const signedTransaction = await signModifyingAndPartialTransactionSigners(
+    transaction,
+    modifyingSigners,
+    partialSigners,
+    abortSignal
+  );
+  if (!sendingSigner) {
+    throw new Error(
+      "No `TransactionSendingSigner` was identified. Please provide a valid `ITransactionWithSingleSendingSigner` transaction."
+    );
+  }
+  abortSignal?.throwIfAborted();
+  const [signature] = await sendingSigner.signAndSendTransactions([signedTransaction], { abortSignal });
+  abortSignal?.throwIfAborted();
+  return signature;
+}
+function categorizeTransactionSigners(signers, config = {}) {
+  const identifySendingSigner = config.identifySendingSigner ?? true;
+  const sendingSigner = identifySendingSigner ? identifyTransactionSendingSigner(signers) : null;
+  const otherSigners = signers.filter(
+    (signer) => signer !== sendingSigner && (isTransactionModifyingSigner(signer) || isTransactionPartialSigner(signer))
+  );
+  const modifyingSigners = identifyTransactionModifyingSigners(otherSigners);
+  const partialSigners = otherSigners.filter(isTransactionPartialSigner).filter((signer) => !modifyingSigners.includes(signer));
+  return Object.freeze({ modifyingSigners, partialSigners, sendingSigner });
+}
+function identifyTransactionSendingSigner(signers) {
+  const sendingSigners = signers.filter(isTransactionSendingSigner);
+  if (sendingSigners.length === 0)
+    return null;
+  const sendingOnlySigners = sendingSigners.filter(
+    (signer) => !isTransactionModifyingSigner(signer) && !isTransactionPartialSigner(signer)
+  );
+  if (sendingOnlySigners.length > 0) {
+    return sendingOnlySigners[0];
+  }
+  return sendingSigners[0];
+}
+function identifyTransactionModifyingSigners(signers) {
+  const modifyingSigners = signers.filter(isTransactionModifyingSigner);
+  if (modifyingSigners.length === 0)
+    return [];
+  const nonPartialSigners = modifyingSigners.filter((signer) => !isTransactionPartialSigner(signer));
+  if (nonPartialSigners.length > 0)
+    return nonPartialSigners;
+  return [modifyingSigners[0]];
+}
+async function signModifyingAndPartialTransactionSigners(transaction, modifyingSigners = [], partialSigners = [], abortSignal) {
+  const modifiedTransaction = await modifyingSigners.reduce(
+    async (transaction2, modifyingSigner) => {
+      abortSignal?.throwIfAborted();
+      const [tx] = await modifyingSigner.modifyAndSignTransactions([await transaction2], { abortSignal });
+      return Object.freeze(tx);
+    },
+    Promise.resolve(transaction)
+  );
+  abortSignal?.throwIfAborted();
+  const signatureDictionaries = await Promise.all(
+    partialSigners.map(async (partialSigner) => {
+      const [signatures] = await partialSigner.signTransactions([modifiedTransaction], { abortSignal });
+      return signatures;
+    })
+  );
+  const signedTransaction = {
+    ...modifiedTransaction,
+    signatures: Object.freeze(
+      signatureDictionaries.reduce((signatures, signatureDictionary) => {
+        return { ...signatures, ...signatureDictionary };
+      }, modifiedTransaction.signatures ?? {})
+    )
+  };
+  return Object.freeze(signedTransaction);
+}
+var o = globalThis.TextEncoder;
+
+// src/signable-message.ts
+function createSignableMessage(content, signatures = {}) {
+  return Object.freeze({
+    content: typeof content === "string" ? new o().encode(content) : content,
+    signatures: Object.freeze({ ...signatures })
+  });
+}
+
+// src/transaction-with-single-sending-signer.ts
+function isTransactionWithSingleSendingSigner(transaction) {
+  try {
+    assertIsTransactionWithSingleSendingSigner(transaction);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function assertIsTransactionWithSingleSendingSigner(transaction) {
+  const signers = getSignersFromTransaction(transaction);
+  const sendingSigners = signers.filter(isTransactionSendingSigner);
+  if (sendingSigners.length === 0) {
+    const error = new Error("No `TransactionSendingSigner` was identified.");
+    error.name = "MissingTransactionSendingSignerError";
+    throw error;
+  }
+  const sendingOnlySigners = sendingSigners.filter(
+    (signer) => !isTransactionPartialSigner(signer) && !isTransactionModifyingSigner(signer)
+  );
+  if (sendingOnlySigners.length > 1) {
+    const error = new Error("More than one `TransactionSendingSigner` was identified.");
+    error.name = "MultipleTransactionSendingSignersError";
+    throw error;
+  }
+}
+
+exports.addSignersToInstruction = addSignersToInstruction;
+exports.addSignersToTransaction = addSignersToTransaction;
+exports.assertIsKeyPairSigner = assertIsKeyPairSigner;
+exports.assertIsMessageModifyingSigner = assertIsMessageModifyingSigner;
+exports.assertIsMessagePartialSigner = assertIsMessagePartialSigner;
+exports.assertIsMessageSigner = assertIsMessageSigner;
+exports.assertIsTransactionModifyingSigner = assertIsTransactionModifyingSigner;
+exports.assertIsTransactionPartialSigner = assertIsTransactionPartialSigner;
+exports.assertIsTransactionSendingSigner = assertIsTransactionSendingSigner;
+exports.assertIsTransactionSigner = assertIsTransactionSigner;
+exports.assertIsTransactionWithSingleSendingSigner = assertIsTransactionWithSingleSendingSigner;
+exports.createNoopSigner = createNoopSigner;
+exports.createSignableMessage = createSignableMessage;
+exports.createSignerFromKeyPair = createSignerFromKeyPair;
+exports.generateKeyPairSigner = generateKeyPairSigner;
+exports.getSignersFromInstruction = getSignersFromInstruction;
+exports.getSignersFromTransaction = getSignersFromTransaction;
+exports.isKeyPairSigner = isKeyPairSigner;
+exports.isMessageModifyingSigner = isMessageModifyingSigner;
+exports.isMessagePartialSigner = isMessagePartialSigner;
+exports.isMessageSigner = isMessageSigner;
+exports.isTransactionModifyingSigner = isTransactionModifyingSigner;
+exports.isTransactionPartialSigner = isTransactionPartialSigner;
+exports.isTransactionSendingSigner = isTransactionSendingSigner;
+exports.isTransactionSigner = isTransactionSigner;
+exports.isTransactionWithSingleSendingSigner = isTransactionWithSingleSendingSigner;
+exports.partiallySignTransactionWithSigners = partiallySignTransactionWithSigners;
+exports.setTransactionFeePayerSigner = setTransactionFeePayerSigner;
+exports.signAndSendTransactionWithSigners = signAndSendTransactionWithSigners;
+exports.signTransactionWithSigners = signTransactionWithSigners;
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.browser.cjs.map

package/dist/index.browser.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/deduplicate-signers.ts","../src/account-signer-meta.ts","../src/add-signers.ts","../src/fee-payer-signer.ts","../src/keypair-signer.ts","../src/message-partial-signer.ts","../src/transaction-partial-signer.ts","../src/message-modifying-signer.ts","../src/message-signer.ts","../src/noop-signer.ts","../src/sign-transaction.ts","../src/transaction-modifying-signer.ts","../src/transaction-sending-signer.ts","../src/transaction-signer.ts","../../text-encoding-impl/src/index.browser.ts","../src/signable-message.ts","../src/transaction-with-single-sending-signer.ts"],"names":["out","transaction","TextDecoder","TextEncoder"],"mappings":"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","sourcesContent":["import { Address } from '@solana/addresses';\n\nimport { MessageSigner } from './message-signer';\nimport { TransactionSigner } from './transaction-signer';\n\n/** Removes all duplicated signers from a provided array by comparing their addresses. */\nexport function deduplicateSigners<TSigner extends MessageSigner | TransactionSigner>(\n    signers: readonly TSigner[],\n): readonly TSigner[] {\n    const deduplicated: Record<Address, TSigner> = {};\n    signers.forEach(signer => {\n        if (!deduplicated[signer.address]) {\n            deduplicated[signer.address] = signer;\n        } else if (deduplicated[signer.address] !== signer) {\n            // TODO: Coded error.\n            throw new Error(\n                `Multiple distinct signers were identified for address \"${signer.address}\". ` +\n                    `Please ensure that you are using the same signer instance for each address.`,\n            );\n        }\n    });\n    return Object.values(deduplicated);\n}\n","import { AccountRole, IAccountLookupMeta, IAccountMeta, IInstruction } from '@solana/instructions';\nimport { BaseTransaction, TransactionVersion } from '@solana/transactions';\n\nimport { deduplicateSigners } from './deduplicate-signers';\nimport { TransactionSigner } from './transaction-signer';\n\n/** An extension of the IAccountMeta type that keeps track of its transaction signer. */\nexport interface IAccountSignerMeta<\n    TAddress extends string = string,\n    TSigner extends TransactionSigner<TAddress> = TransactionSigner<TAddress>,\n> extends IAccountMeta<TAddress> {\n    readonly role: AccountRole.READONLY_SIGNER | AccountRole.WRITABLE_SIGNER;\n    readonly signer: TSigner;\n}\n\ntype IAccountMetaWithSigner<TSigner extends TransactionSigner = TransactionSigner> =\n    | IAccountMeta\n    | IAccountLookupMeta\n    | IAccountSignerMeta<string, TSigner>;\n\n/** A variation of the instruction type that allows IAccountSignerMeta in its account metas. */\nexport type IInstructionWithSigners<\n    TSigner extends TransactionSigner = TransactionSigner,\n    TAccounts extends readonly IAccountMetaWithSigner<TSigner>[] = readonly IAccountMetaWithSigner<TSigner>[],\n> = Pick<IInstruction<string, TAccounts>, 'accounts'>;\n\n/** A variation of the transaction type that allows IAccountSignerMeta in its account metas. */\nexport type ITransactionWithSigners<\n    TSigner extends TransactionSigner = TransactionSigner,\n    TAccounts extends readonly IAccountMetaWithSigner<TSigner>[] = readonly IAccountMetaWithSigner<TSigner>[],\n> = Pick<\n    BaseTransaction<TransactionVersion, IInstruction & IInstructionWithSigners<TSigner, TAccounts>>,\n    'instructions'\n> & { feePayerSigner?: TSigner };\n\n/** Extract all signers from an instruction that may contain IAccountSignerMeta accounts. */\nexport function getSignersFromInstruction<TSigner extends TransactionSigner = TransactionSigner>(\n    instruction: IInstructionWithSigners<TSigner>,\n): readonly TSigner[] {\n    return deduplicateSigners(\n        (instruction.accounts ?? []).flatMap(account => ('signer' in account ? account.signer : [])),\n    );\n}\n\n/** Extract all signers from a transaction that may contain IAccountSignerMeta accounts. */\nexport function getSignersFromTransaction<\n    TSigner extends TransactionSigner = TransactionSigner,\n    TTransaction extends ITransactionWithSigners<TSigner> = ITransactionWithSigners<TSigner>,\n>(transaction: TTransaction): readonly TSigner[] {\n    return deduplicateSigners([\n        ...(transaction.feePayerSigner ? [transaction.feePayerSigner] : []),\n        ...transaction.instructions.flatMap(getSignersFromInstruction),\n    ]);\n}\n","import { IInstruction, isSignerRole } from '@solana/instructions';\nimport { BaseTransaction } from '@solana/transactions';\n\nimport { IAccountSignerMeta, IInstructionWithSigners, ITransactionWithSigners } from './account-signer-meta';\nimport { deduplicateSigners } from './deduplicate-signers';\nimport { TransactionSigner } from './transaction-signer';\n\n/** Attaches the provided signers to the account metas of an instruction when applicable. */\nexport function addSignersToInstruction<TInstruction extends IInstruction>(\n    signers: TransactionSigner[],\n    instruction: TInstruction | (TInstruction & IInstructionWithSigners),\n): TInstruction & IInstructionWithSigners {\n    if (!instruction.accounts || instruction.accounts.length === 0) {\n        return instruction as TInstruction & IInstructionWithSigners;\n    }\n\n    const signerByAddress = new Map(deduplicateSigners(signers).map(signer => [signer.address, signer]));\n    return Object.freeze({\n        ...instruction,\n        accounts: instruction.accounts.map(account => {\n            const signer = signerByAddress.get(account.address);\n            if (!isSignerRole(account.role) || 'signer' in account || !signer) {\n                return account;\n            }\n            return Object.freeze({ ...account, signer } as IAccountSignerMeta);\n        }),\n    });\n}\n\n/** Attaches the provided signers to the account metas of a transaction when applicable. */\nexport function addSignersToTransaction<TTransaction extends BaseTransaction>(\n    signers: TransactionSigner[],\n    transaction: TTransaction | (TTransaction & ITransactionWithSigners),\n): TTransaction & ITransactionWithSigners {\n    if (transaction.instructions.length === 0) {\n        return transaction as TTransaction & ITransactionWithSigners;\n    }\n\n    return Object.freeze({\n        ...transaction,\n        instructions: transaction.instructions.map(instruction => addSignersToInstruction(signers, instruction)),\n    });\n}\n","import { Address } from '@solana/addresses';\nimport {\n    BaseTransaction,\n    getUnsignedTransaction,\n    ITransactionWithFeePayer,\n    ITransactionWithSignatures,\n} from '@solana/transactions';\n\nimport { TransactionSigner } from './transaction-signer';\n\nexport interface ITransactionWithFeePayerSigner<\n    TAddress extends string = string,\n    TSigner extends TransactionSigner<TAddress> = TransactionSigner<TAddress>,\n> {\n    readonly feePayer: Address<TAddress>;\n    readonly feePayerSigner: TSigner;\n}\n\nexport function setTransactionFeePayerSigner<TFeePayerAddress extends string, TTransaction extends BaseTransaction>(\n    feePayerSigner: TransactionSigner<TFeePayerAddress>,\n    transaction:\n        | (TTransaction & ITransactionWithSignatures)\n        | (TTransaction & ITransactionWithFeePayer<string> & ITransactionWithSignatures),\n): Omit<TTransaction, keyof ITransactionWithSignatures> & ITransactionWithFeePayerSigner<TFeePayerAddress>;\n\nexport function setTransactionFeePayerSigner<TFeePayerAddress extends string, TTransaction extends BaseTransaction>(\n    feePayerSigner: TransactionSigner<TFeePayerAddress>,\n    transaction: TTransaction | (TTransaction & ITransactionWithFeePayer<string>),\n): TTransaction & ITransactionWithFeePayerSigner<TFeePayerAddress>;\n\nexport function setTransactionFeePayerSigner<TFeePayerAddress extends string, TTransaction extends BaseTransaction>(\n    feePayerSigner: TransactionSigner<TFeePayerAddress>,\n    transaction:\n        | TTransaction\n        | (TTransaction & ITransactionWithFeePayer<string>)\n        | (TTransaction & ITransactionWithSignatures)\n        | (TTransaction & ITransactionWithFeePayer<string> & ITransactionWithSignatures),\n) {\n    if ('feePayer' in transaction && feePayerSigner.address === transaction.feePayer) {\n        if ('feePayerSigner' in transaction) return transaction;\n        const out = { ...transaction, feePayerSigner };\n        Object.freeze(out);\n        return out;\n    }\n    const out = {\n        ...getUnsignedTransaction(transaction),\n        feePayer: feePayerSigner.address,\n        feePayerSigner,\n    };\n    Object.freeze(out);\n    return out;\n}\n","import { Address, getAddressFromPublicKey } from '@solana/addresses';\nimport { generateKeyPair, signBytes } from '@solana/keys';\nimport { partiallySignTransaction } from '@solana/transactions';\n\nimport { isMessagePartialSigner, MessagePartialSigner } from './message-partial-signer';\nimport { isTransactionPartialSigner, TransactionPartialSigner } from './transaction-partial-signer';\n\n/** Defines a signer capable of signing messages and transactions using a CryptoKeyPair. */\nexport type KeyPairSigner<TAddress extends string = string> = MessagePartialSigner<TAddress> &\n    TransactionPartialSigner<TAddress> & { keyPair: CryptoKeyPair };\n\n/** Checks whether the provided value implements the {@link KeyPairSigner} interface. */\nexport function isKeyPairSigner<TAddress extends string>(value: {\n    address: Address<TAddress>;\n    [key: string]: unknown;\n}): value is KeyPairSigner<TAddress> {\n    return (\n        'keyPair' in value &&\n        typeof value.keyPair === 'object' &&\n        isMessagePartialSigner(value) &&\n        isTransactionPartialSigner(value)\n    );\n}\n\n/** Asserts that the provided value implements the {@link KeyPairSigner} interface. */\nexport function assertIsKeyPairSigner<TAddress extends string>(value: {\n    address: Address<TAddress>;\n    [key: string]: unknown;\n}): asserts value is KeyPairSigner<TAddress> {\n    if (!isKeyPairSigner(value)) {\n        // TODO: Coded error.\n        throw new Error('The provided value does not implement the KeyPairSigner interface');\n    }\n}\n\n/** Creates a KeyPairSigner from the provided Crypto KeyPair. */\nexport async function createSignerFromKeyPair(keyPair: CryptoKeyPair): Promise<KeyPairSigner> {\n    const address = await getAddressFromPublicKey(keyPair.publicKey);\n    const out: KeyPairSigner = {\n        address,\n        keyPair,\n        signMessages: messages =>\n            Promise.all(\n                messages.map(async message =>\n                    Object.freeze({ [address]: await signBytes(keyPair.privateKey, message.content) }),\n                ),\n            ),\n        signTransactions: transactions =>\n            Promise.all(\n                transactions.map(async transaction => {\n                    const signedTransaction = await partiallySignTransaction([keyPair], transaction);\n                    return Object.freeze({ [address]: signedTransaction.signatures[address] });\n                }),\n            ),\n    };\n\n    return Object.freeze(out);\n}\n\n/** Securely generates a signer capable of signing messages and transactions using a Crypto KeyPair. */\nexport async function generateKeyPairSigner(): Promise<KeyPairSigner> {\n    return createSignerFromKeyPair(await generateKeyPair());\n}\n","import { Address } from '@solana/addresses';\n\nimport { SignableMessage } from './signable-message';\nimport { BaseSignerConfig, SignatureDictionary } from './types';\n\nexport type MessagePartialSignerConfig = BaseSignerConfig;\n\n/** Defines a signer capable of signing messages. */\nexport type MessagePartialSigner<TAddress extends string = string> = Readonly<{\n    address: Address<TAddress>;\n    signMessages(\n        messages: readonly SignableMessage[],\n        config?: MessagePartialSignerConfig,\n    ): Promise<readonly SignatureDictionary[]>;\n}>;\n\n/** Checks whether the provided value implements the {@link MessagePartialSigner} interface. */\nexport function isMessagePartialSigner<TAddress extends string>(value: {\n    address: Address<TAddress>;\n    [key: string]: unknown;\n}): value is MessagePartialSigner<TAddress> {\n    return 'signMessages' in value && typeof value.signMessages === 'function';\n}\n\n/** Asserts that the provided value implements the {@link MessagePartialSigner} interface. */\nexport function assertIsMessagePartialSigner<TAddress extends string>(value: {\n    address: Address<TAddress>;\n    [key: string]: unknown;\n}): asserts value is MessagePartialSigner<TAddress> {\n    if (!isMessagePartialSigner(value)) {\n        // TODO: Coded error.\n        throw new Error('The provided value does not implement the MessagePartialSigner interface');\n    }\n}\n","import { Address } from '@solana/addresses';\nimport { CompilableTransaction } from '@solana/transactions';\n\nimport { BaseSignerConfig, SignatureDictionary } from './types';\n\nexport type TransactionPartialSignerConfig = BaseSignerConfig;\n\n/** Defines a signer capable of signing transactions. */\nexport type TransactionPartialSigner<TAddress extends string = string> = Readonly<{\n    address: Address<TAddress>;\n    signTransactions(\n        transactions: readonly CompilableTransaction[],\n        config?: TransactionPartialSignerConfig,\n    ): Promise<readonly SignatureDictionary[]>;\n}>;\n\n/** Checks whether the provided value implements the {@link TransactionPartialSigner} interface. */\nexport function isTransactionPartialSigner<TAddress extends string>(value: {\n    address: Address<TAddress>;\n    [key: string]: unknown;\n}): value is TransactionPartialSigner<TAddress> {\n    return 'signTransactions' in value && typeof value.signTransactions === 'function';\n}\n\n/** Asserts that the provided value implements the {@link TransactionPartialSigner} interface. */\nexport function assertIsTransactionPartialSigner<TAddress extends string>(value: {\n    address: Address<TAddress>;\n    [key: string]: unknown;\n}): asserts value is TransactionPartialSigner<TAddress> {\n    if (!isTransactionPartialSigner(value)) {\n        // TODO: Coded error.\n        throw new Error('The provided value does not implement the TransactionPartialSigner interface');\n    }\n}\n","import { Address, isAddress } from '@solana/addresses';\n\nimport { SignableMessage } from './signable-message';\nimport { BaseSignerConfig } from './types';\n\nexport type MessageModifyingSignerConfig = BaseSignerConfig;\n\n/** Defines a signer capable of signing messages. */\nexport type MessageModifyingSigner<TAddress extends string = string> = Readonly<{\n    address: Address<TAddress>;\n    modifyAndSignMessages(\n        messages: readonly SignableMessage[],\n        config?: MessageModifyingSignerConfig,\n    ): Promise<readonly SignableMessage[]>;\n}>;\n\n/** Checks whether the provided value implements the {@link MessageModifyingSigner} interface. */\nexport function isMessageModifyingSigner<TAddress extends string>(value: {\n    address: Address<TAddress>;\n    [key: string]: unknown;\n}): value is MessageModifyingSigner<TAddress> {\n    return (\n        isAddress(value.address) &&\n        'modifyAndSignMessages' in value &&\n        typeof value.modifyAndSignMessages === 'function'\n    );\n}\n\n/** Asserts that the provided value implements the {@link MessageModifyingSigner} interface. */\nexport function assertIsMessageModifyingSigner<TAddress extends string>(value: {\n    address: Address<TAddress>;\n    [key: string]: unknown;\n}): asserts value is MessageModifyingSigner<TAddress> {\n    if (!isMessageModifyingSigner(value)) {\n        // TODO: Coded error.\n        throw new Error('The provided value does not implement the MessageModifyingSigner interface');\n    }\n}\n","import { Address } from '@solana/addresses';\n\nimport { isMessageModifyingSigner, MessageModifyingSigner } from './message-modifying-signer';\nimport { isMessagePartialSigner, MessagePartialSigner } from './message-partial-signer';\n\n/** Defines a signer capable of signing messages. */\nexport type MessageSigner<TAddress extends string = string> =\n    | MessagePartialSigner<TAddress>\n    | MessageModifyingSigner<TAddress>;\n\n/** Checks whether the provided value implements the {@link MessageSigner} interface. */\nexport function isMessageSigner<TAddress extends string>(value: {\n    address: Address<TAddress>;\n    [key: string]: unknown;\n}): value is MessageSigner<TAddress> {\n    return isMessagePartialSigner(value) || isMessageModifyingSigner(value);\n}\n\n/** Asserts that the provided value implements the {@link MessageSigner} interface. */\nexport function assertIsMessageSigner<TAddress extends string>(value: {\n    address: Address<TAddress>;\n    [key: string]: unknown;\n}): asserts value is MessageSigner<TAddress> {\n    if (!isMessageSigner(value)) {\n        // TODO: Coded error.\n        throw new Error('The provided value does not implement any of the MessageSigner interfaces');\n    }\n}\n","import { Address } from '@solana/addresses';\n\nimport { MessagePartialSigner } from './message-partial-signer';\nimport { TransactionPartialSigner } from './transaction-partial-signer';\n\n/** Defines a no-operation signer that pretends to partially sign messages and transactions. */\nexport type NoopSigner<TAddress extends string = string> = MessagePartialSigner<TAddress> &\n    TransactionPartialSigner<TAddress>;\n\n/** Creates a NoopSigner from the provided Address. */\nexport function createNoopSigner(address: Address): NoopSigner {\n    const out: NoopSigner = {\n        address,\n        signMessages: async messages => messages.map(() => Object.freeze({})),\n        signTransactions: async transactions => transactions.map(() => Object.freeze({})),\n    };\n\n    return Object.freeze(out);\n}\n","import { SignatureBytes } from '@solana/keys';\nimport {\n    assertTransactionIsFullySigned,\n    CompilableTransaction,\n    IFullySignedTransaction,\n    ITransactionWithSignatures,\n} from '@solana/transactions';\n\nimport { getSignersFromTransaction, ITransactionWithSigners } from './account-signer-meta';\nimport { deduplicateSigners } from './deduplicate-signers';\nimport { isTransactionModifyingSigner, TransactionModifyingSigner } from './transaction-modifying-signer';\nimport { isTransactionPartialSigner, TransactionPartialSigner } from './transaction-partial-signer';\nimport { isTransactionSendingSigner, TransactionSendingSigner } from './transaction-sending-signer';\nimport { isTransactionSigner, TransactionSigner } from './transaction-signer';\nimport { ITransactionWithSingleSendingSigner } from './transaction-with-single-sending-signer';\n\ntype CompilableTransactionWithSigners = CompilableTransaction &\n    ITransactionWithSigners &\n    Partial<ITransactionWithSignatures>;\n\n/**\n * Signs a transaction using any signers that may be stored in IAccountSignerMeta instruction accounts\n * as well as any signers provided explicitly to this function.\n * It will ignore TransactionSendingSigners since this function does not send the transaction.\n */\nexport async function partiallySignTransactionWithSigners<\n    TTransaction extends CompilableTransactionWithSigners = CompilableTransactionWithSigners,\n>(\n    transaction: TTransaction,\n    config: { abortSignal?: AbortSignal } = {},\n): Promise<TTransaction & ITransactionWithSignatures> {\n    const { partialSigners, modifyingSigners } = categorizeTransactionSigners(\n        deduplicateSigners(getSignersFromTransaction(transaction).filter(isTransactionSigner)),\n        { identifySendingSigner: false },\n    );\n\n    return signModifyingAndPartialTransactionSigners(transaction, modifyingSigners, partialSigners, config.abortSignal);\n}\n\n/**\n * Signs a transaction using any signers that may be stored in IAccountSignerMeta instruction accounts\n * as well as any signers provided explicitly to this function.\n * It will assert that the transaction is fully signed before returning.\n * It will ignore TransactionSendingSigners since this function does not send the transaction.\n */\nexport async function signTransactionWithSigners<\n    TTransaction extends CompilableTransactionWithSigners = CompilableTransactionWithSigners,\n>(\n    transaction: TTransaction,\n    config: { abortSignal?: AbortSignal } = {},\n): Promise<TTransaction & IFullySignedTransaction> {\n    const signedTransaction = await partiallySignTransactionWithSigners(transaction, config);\n    assertTransactionIsFullySigned(signedTransaction);\n    return signedTransaction;\n}\n\n/**\n * Signs and sends a transaction using any signers that may be stored in IAccountSignerMeta\n * instruction accounts as well as any signers provided explicitly to this function.\n * It will identify a single TransactionSendingSigners to use for sending the transaction, if any.\n * Otherwise, it will send the transaction using the provided fallbackSender.\n */\nexport async function signAndSendTransactionWithSigners<\n    TTransaction extends CompilableTransactionWithSigners &\n        ITransactionWithSingleSendingSigner = CompilableTransactionWithSigners & ITransactionWithSingleSendingSigner,\n>(transaction: TTransaction, config: { abortSignal?: AbortSignal } = {}): Promise<SignatureBytes> {\n    const abortSignal = config.abortSignal;\n    const { partialSigners, modifyingSigners, sendingSigner } = categorizeTransactionSigners(\n        deduplicateSigners(getSignersFromTransaction(transaction).filter(isTransactionSigner)),\n    );\n\n    abortSignal?.throwIfAborted();\n    const signedTransaction = await signModifyingAndPartialTransactionSigners(\n        transaction,\n        modifyingSigners,\n        partialSigners,\n        abortSignal,\n    );\n\n    if (!sendingSigner) {\n        // TODO: Coded error.\n        throw new Error(\n            'No `TransactionSendingSigner` was identified. Please provide a valid `ITransactionWithSingleSendingSigner` transaction.',\n        );\n    }\n\n    abortSignal?.throwIfAborted();\n    const [signature] = await sendingSigner.signAndSendTransactions([signedTransaction], { abortSignal });\n    abortSignal?.throwIfAborted();\n\n    return signature;\n}\n\n/**\n * Identifies each provided TransactionSigner and categorizes them into their respective types.\n * When a signer implements multiple interface, it will try to used to most powerful interface\n * but fallback to the least powerful interface when necessary.\n * For instance, if a signer implements TransactionSendingSigner and TransactionModifyingSigner,\n * it will be categorized as a TransactionSendingSigner if and only if no other signers implement\n * the TransactionSendingSigner interface.\n */\nfunction categorizeTransactionSigners(\n    signers: readonly TransactionSigner[],\n    config: { identifySendingSigner?: boolean } = {},\n): Readonly<{\n    modifyingSigners: readonly TransactionModifyingSigner[];\n    partialSigners: readonly TransactionPartialSigner[];\n    sendingSigner: TransactionSendingSigner | null;\n}> {\n    // Identify the unique sending signer that should be used.\n    const identifySendingSigner = config.identifySendingSigner ?? true;\n    const sendingSigner = identifySendingSigner ? identifyTransactionSendingSigner(signers) : null;\n\n    // Now, focus on the other signers.\n    // I.e. the modifying or partial signers that are not the identified sending signer.\n    // Note that any other sending only signers will be discarded.\n    const otherSigners = signers.filter(\n        (signer): signer is TransactionModifyingSigner | TransactionPartialSigner =>\n            signer !== sendingSigner && (isTransactionModifyingSigner(signer) || isTransactionPartialSigner(signer)),\n    );\n\n    // Identify the modifying signers from the other signers.\n    const modifyingSigners = identifyTransactionModifyingSigners(otherSigners);\n\n    // Use any remaining signers as partial signers.\n    const partialSigners = otherSigners\n        .filter(isTransactionPartialSigner)\n        .filter(signer => !(modifyingSigners as typeof otherSigners).includes(signer));\n\n    return Object.freeze({ modifyingSigners, partialSigners, sendingSigner });\n}\n\n/** Identifies the best signer to use as a TransactionSendingSigner, if any */\nfunction identifyTransactionSendingSigner(signers: readonly TransactionSigner[]): TransactionSendingSigner | null {\n    // Ensure there are any TransactionSendingSigners in the first place.\n    const sendingSigners = signers.filter(isTransactionSendingSigner);\n    if (sendingSigners.length === 0) return null;\n\n    // Prefer sending signers that do not offer other interfaces.\n    const sendingOnlySigners = sendingSigners.filter(\n        signer => !isTransactionModifyingSigner(signer) && !isTransactionPartialSigner(signer),\n    );\n    if (sendingOnlySigners.length > 0) {\n        return sendingOnlySigners[0];\n    }\n\n    // Otherwise, choose any sending signer.\n    return sendingSigners[0];\n}\n\n/** Identifies the best signers to use as TransactionModifyingSigners, if any */\nfunction identifyTransactionModifyingSigners(\n    signers: readonly (TransactionModifyingSigner | TransactionPartialSigner)[],\n): readonly TransactionModifyingSigner[] {\n    // Ensure there are any TransactionModifyingSigner in the first place.\n    const modifyingSigners = signers.filter(isTransactionModifyingSigner);\n    if (modifyingSigners.length === 0) return [];\n\n    // Prefer modifying signers that do not offer partial signing.\n    const nonPartialSigners = modifyingSigners.filter(signer => !isTransactionPartialSigner(signer));\n    if (nonPartialSigners.length > 0) return nonPartialSigners;\n\n    // Otherwise, choose only one modifying signer (whichever).\n    return [modifyingSigners[0]];\n}\n\n/**\n * Signs a transaction using the provided TransactionModifyingSigners\n * sequentially followed by the TransactionPartialSigners in parallel.\n */\nasync function signModifyingAndPartialTransactionSigners<\n    TTransaction extends CompilableTransactionWithSigners = CompilableTransactionWithSigners,\n>(\n    transaction: TTransaction,\n    modifyingSigners: readonly TransactionModifyingSigner[] = [],\n    partialSigners: readonly TransactionPartialSigner[] = [],\n    abortSignal?: AbortSignal,\n): Promise<TTransaction & ITransactionWithSignatures> {\n    // Handle modifying signers sequentially.\n    const modifiedTransaction = await modifyingSigners.reduce(\n        async (transaction, modifyingSigner) => {\n            abortSignal?.throwIfAborted();\n            const [tx] = await modifyingSigner.modifyAndSignTransactions([await transaction], { abortSignal });\n            return Object.freeze(tx);\n        },\n        Promise.resolve(transaction) as Promise<TTransaction>,\n    );\n\n    // Handle partial signers in parallel.\n    abortSignal?.throwIfAborted();\n    const signatureDictionaries = await Promise.all(\n        partialSigners.map(async partialSigner => {\n            const [signatures] = await partialSigner.signTransactions([modifiedTransaction], { abortSignal });\n            return signatures;\n        }),\n    );\n    const signedTransaction: TTransaction & ITransactionWithSignatures = {\n        ...modifiedTransaction,\n        signatures: Object.freeze(\n            signatureDictionaries.reduce((signatures, signatureDictionary) => {\n                return { ...signatures, ...signatureDictionary };\n            }, modifiedTransaction.signatures ?? {}),\n        ),\n    };\n\n    return Object.freeze(signedTransaction);\n}\n","import { Address } from '@solana/addresses';\nimport { CompilableTransaction } from '@solana/transactions';\n\nimport { BaseSignerConfig } from './types';\n\nexport type TransactionModifyingSignerConfig = BaseSignerConfig;\n\n/** Defines a signer capable of signing transactions. */\nexport type TransactionModifyingSigner<TAddress extends string = string> = Readonly<{\n    address: Address<TAddress>;\n    modifyAndSignTransactions<TTransaction extends CompilableTransaction>(\n        transactions: readonly TTransaction[],\n        config?: TransactionModifyingSignerConfig,\n    ): Promise<readonly TTransaction[]>;\n}>;\n\n/** Checks whether the provided value implements the {@link TransactionModifyingSigner} interface. */\nexport function isTransactionModifyingSigner<TAddress extends string>(value: {\n    address: Address<TAddress>;\n    [key: string]: unknown;\n}): value is TransactionModifyingSigner<TAddress> {\n    return 'modifyAndSignTransactions' in value && typeof value.modifyAndSignTransactions === 'function';\n}\n\n/** Asserts that the provided value implements the {@link TransactionModifyingSigner} interface. */\nexport function assertIsTransactionModifyingSigner<TAddress extends string>(value: {\n    address: Address<TAddress>;\n    [key: string]: unknown;\n}): asserts value is TransactionModifyingSigner<TAddress> {\n    if (!isTransactionModifyingSigner(value)) {\n        // TODO: Coded error.\n        throw new Error('The provided value does not implement the TransactionModifyingSigner interface');\n    }\n}\n","import { Address } from '@solana/addresses';\nimport { SignatureBytes } from '@solana/keys';\nimport { CompilableTransaction } from '@solana/transactions';\n\nimport { BaseSignerConfig } from './types';\n\nexport type TransactionSendingSignerConfig = BaseSignerConfig;\n\n/** Defines a signer capable of signing and sending transactions simultaneously. */\nexport type TransactionSendingSigner<TAddress extends string = string> = Readonly<{\n    address: Address<TAddress>;\n    signAndSendTransactions(\n        transactions: readonly CompilableTransaction[],\n        config?: TransactionSendingSignerConfig,\n    ): Promise<readonly SignatureBytes[]>;\n}>;\n\n/** Checks whether the provided value implements the {@link TransactionSendingSigner} interface. */\nexport function isTransactionSendingSigner<TAddress extends string>(value: {\n    address: Address<TAddress>;\n    [key: string]: unknown;\n}): value is TransactionSendingSigner<TAddress> {\n    return 'signAndSendTransactions' in value && typeof value.signAndSendTransactions === 'function';\n}\n\n/** Asserts that the provided value implements the {@link TransactionSendingSigner} interface. */\nexport function assertIsTransactionSendingSigner<TAddress extends string>(value: {\n    address: Address<TAddress>;\n    [key: string]: unknown;\n}): asserts value is TransactionSendingSigner<TAddress> {\n    if (!isTransactionSendingSigner(value)) {\n        // TODO: Coded error.\n        throw new Error('The provided value does not implement the TransactionSendingSigner interface');\n    }\n}\n","import { Address } from '@solana/addresses';\n\nimport { isTransactionModifyingSigner, TransactionModifyingSigner } from './transaction-modifying-signer';\nimport { isTransactionPartialSigner, TransactionPartialSigner } from './transaction-partial-signer';\nimport { isTransactionSendingSigner, TransactionSendingSigner } from './transaction-sending-signer';\n\n/** Defines a signer capable of signing transactions. */\nexport type TransactionSigner<TAddress extends string = string> =\n    | TransactionPartialSigner<TAddress>\n    | TransactionModifyingSigner<TAddress>\n    | TransactionSendingSigner<TAddress>;\n\n/** Checks whether the provided value implements the {@link TransactionSigner} interface. */\nexport function isTransactionSigner<TAddress extends string>(value: {\n    address: Address<TAddress>;\n    [key: string]: unknown;\n}): value is TransactionSigner<TAddress> {\n    return (\n        isTransactionPartialSigner(value) || isTransactionModifyingSigner(value) || isTransactionSendingSigner(value)\n    );\n}\n\n/** Asserts that the provided value implements the {@link TransactionSigner} interface. */\nexport function assertIsTransactionSigner<TAddress extends string>(value: {\n    address: Address<TAddress>;\n    [key: string]: unknown;\n}): asserts value is TransactionSigner<TAddress> {\n    if (!isTransactionSigner(value)) {\n        // TODO: Coded error.\n        throw new Error('The provided value does not implement any of the TransactionSigner interfaces');\n    }\n}\n","export const TextDecoder = globalThis.TextDecoder;\nexport const TextEncoder = globalThis.TextEncoder;\n","import { TextEncoder } from 'text-encoding-impl';\n\nimport { SignatureDictionary } from './types';\n\n/** Defines a message that needs signing and its current set of signatures if any. */\nexport type SignableMessage = Readonly<{\n    content: Uint8Array;\n    signatures: SignatureDictionary;\n}>;\n\n/**\n * Creates a signable message from a provided content.\n * If a string is provided, it will be UTF-8 encoded.\n */\nexport function createSignableMessage(\n    content: string | Uint8Array,\n    signatures: SignatureDictionary = {},\n): SignableMessage {\n    return Object.freeze({\n        content: typeof content === 'string' ? new TextEncoder().encode(content) : content,\n        signatures: Object.freeze({ ...signatures }),\n    });\n}\n","import { CompilableTransaction } from '@solana/transactions';\n\nimport { getSignersFromTransaction, ITransactionWithSigners } from './account-signer-meta';\nimport { isTransactionModifyingSigner } from './transaction-modifying-signer';\nimport { isTransactionPartialSigner } from './transaction-partial-signer';\nimport { isTransactionSendingSigner } from './transaction-sending-signer';\n\n/** Defines a transaction with exactly one {@link TransactionSendingSigner}. */\nexport type ITransactionWithSingleSendingSigner = ITransactionWithSigners & {\n    readonly __transactionWithSingleSendingSigner: unique symbol;\n};\n\n/** Checks whether the provided transaction has exactly one {@link TransactionSendingSigner}. */\nexport function isTransactionWithSingleSendingSigner<TTransaction extends CompilableTransaction>(\n    transaction: TTransaction,\n): transaction is TTransaction & ITransactionWithSingleSendingSigner {\n    try {\n        assertIsTransactionWithSingleSendingSigner(transaction);\n        return true;\n    } catch {\n        return false;\n    }\n}\n\n/** Asserts that the provided transaction has exactly one {@link TransactionSendingSigner}. */\nexport function assertIsTransactionWithSingleSendingSigner<TTransaction extends CompilableTransaction>(\n    transaction: TTransaction,\n): asserts transaction is TTransaction & ITransactionWithSingleSendingSigner {\n    const signers = getSignersFromTransaction(transaction);\n    const sendingSigners = signers.filter(isTransactionSendingSigner);\n\n    if (sendingSigners.length === 0) {\n        // TODO: Coded error.\n        const error = new Error('No `TransactionSendingSigner` was identified.');\n        error.name = 'MissingTransactionSendingSignerError';\n        throw error;\n    }\n\n    // When identifying if there are multiple sending signers, we only need to check for\n    // sending signers that do not implement other transaction signer interfaces as\n    // they will be used as these other signer interfaces in case of a conflict.\n    const sendingOnlySigners = sendingSigners.filter(\n        signer => !isTransactionPartialSigner(signer) && !isTransactionModifyingSigner(signer),\n    );\n\n    if (sendingOnlySigners.length > 1) {\n        // TODO: Coded error.\n        const error = new Error('More than one `TransactionSendingSigner` was identified.');\n        error.name = 'MultipleTransactionSendingSignersError';\n        throw error;\n    }\n}\n"]}