@unio-aggregator/unio-tx-sender 1.0.0

package/README.md

@@ -0,0 +1,28 @@
+# Unio Aggregator Transaction Sender Library
+
+A TypeScript package for building and sending Solana transactions with support for priority fees and Jito tips.
+
+## Key Features
+
+- Main entry point `sendTransaction()` handles transaction building, signing, and confirmation
+- Built-in support for priority fees and Jito MEV tips
+- Configurable compute unit margin multiplier to ensure sufficient compute budget
+
+## Example
+
+```ts
+import {createKeyPairFromBytes, createSolanaRpc, createSignerFromKeyPair} from "@solana/kit";
+import {sendTransaction} from "@unio-aggregator/unio-tx-sender";
+
+const kp = await createKeyPairFromBytes(new Uint8Array([1, 2, 3, 4, ...]));
+const signer = await createSignerFromKeyPair(kp);
+
+// Initialize RPC connection
+export const rpc = createSolanaRpc("https://api.mainnet-beta.solana.com");
+
+const txHash = await sendTransaction(
+  rpc,
+  [instruction1, instruction2],
+  keypairSigner
+);
+```

package/dist/index.cjs

@@ -0,0 +1,273 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  DEFAULT_COMPUTE_UNIT_MARGIN_MULTIPLIER: () => DEFAULT_COMPUTE_UNIT_MARGIN_MULTIPLIER,
+  DEFAULT_TRANSACTION_CONFIG: () => DEFAULT_TRANSACTION_CONFIG,
+  buildTransaction: () => buildTransaction,
+  sendSignedTransaction: () => sendSignedTransaction,
+  sendTransaction: () => sendTransaction
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/buildTransaction.ts
+var import_kit3 = require("@solana/kit");
+var import_address_lookup_table = require("@solana-program/address-lookup-table");
+
+// src/computeBudget.ts
+var import_kit = require("@solana/kit");
+var import_compute_budget = require("@solana-program/compute-budget");
+
+// src/config.ts
+var DEFAULT_COMPUTE_UNIT_MARGIN_MULTIPLIER = 1.15;
+var DEFAULT_TRANSACTION_CONFIG = {
+  priorityFee: {
+    type: "none",
+    priorityFeePercentile: "50"
+  },
+  jito: {
+    type: "none",
+    priorityFeePercentile: "50"
+  },
+  computeUnitMarginMultiplier: DEFAULT_COMPUTE_UNIT_MARGIN_MULTIPLIER,
+  jitoBlockEngineUrl: "https://bundles.jito.wtf"
+};
+
+// src/computeBudget.ts
+async function processComputeBudgetForTxMessage(rpc, message, computeUnits, config) {
+  const priorityFee = config.priorityFee;
+  const computeUnitMarginMultiplier = config.computeUnitMarginMultiplier;
+  let priorityFeeMicroLamports = 0n;
+  if (priorityFee.type === "exact") {
+    priorityFeeMicroLamports = priorityFee.amountLamports * 1000000n / BigInt(computeUnits);
+  } else if (priorityFee.type === "dynamic") {
+    const estimatedPriorityFee = await calculateDynamicPriorityFees(
+      rpc,
+      message.instructions,
+      priorityFee.priorityFeePercentile ?? "50"
+    );
+    if (!priorityFee.maxCapLamports) {
+      priorityFeeMicroLamports = estimatedPriorityFee;
+    } else {
+      const maxCapMicroLamports = priorityFee.maxCapLamports * 1000000n / BigInt(computeUnits);
+      priorityFeeMicroLamports = maxCapMicroLamports > estimatedPriorityFee ? estimatedPriorityFee : maxCapMicroLamports;
+    }
+  }
+  if (priorityFeeMicroLamports > 0) {
+    message = (0, import_kit.prependTransactionMessageInstruction)(
+      (0, import_compute_budget.getSetComputeUnitPriceInstruction)({
+        microLamports: priorityFeeMicroLamports
+      }),
+      message
+    );
+  }
+  message = (0, import_kit.prependTransactionMessageInstruction)(
+    (0, import_compute_budget.getSetComputeUnitLimitInstruction)({
+      units: Math.ceil(computeUnits * (computeUnitMarginMultiplier ?? DEFAULT_COMPUTE_UNIT_MARGIN_MULTIPLIER))
+    }),
+    message
+  );
+  return message;
+}
+function getWritableAccounts(ixs) {
+  const writable = /* @__PURE__ */ new Set();
+  ixs.forEach((ix) => {
+    if (ix.accounts) {
+      ix.accounts.forEach((acc) => {
+        if ((0, import_kit.isWritableRole)(acc.role)) writable.add(acc.address);
+      });
+    }
+  });
+  return Array.from(writable);
+}
+async function calculateDynamicPriorityFees(rpc, instructions, percentile) {
+  const writableAccounts = getWritableAccounts(instructions);
+  const recent = await rpc.getRecentPrioritizationFees(writableAccounts).send();
+  const nonZero = recent.filter((pf) => pf.prioritizationFee > 0).map((pf) => pf.prioritizationFee);
+  const sorted = nonZero.sort((a, b) => Number(a - b));
+  return sorted[Math.floor(sorted.length * (parseInt(percentile) / 100))] || BigInt(0);
+}
+
+// src/jito.ts
+var import_kit2 = require("@solana/kit");
+var import_system = require("@solana-program/system");
+async function processJitoTipForTxMessage(message, signer, config) {
+  let jitoTipLamports = BigInt(0);
+  const jito = config.jito;
+  if (jito.type === "exact") {
+    jitoTipLamports = jito.amountLamports;
+  } else if (jito.type === "dynamic") {
+    jitoTipLamports = await recentJitoTip(config);
+  }
+  if (jitoTipLamports > 0) {
+    return (0, import_kit2.prependTransactionMessageInstruction)(
+      (0, import_system.getTransferSolInstruction)({
+        source: signer,
+        destination: getJitoTipAddress(),
+        amount: jitoTipLamports
+      }),
+      message
+    );
+  } else {
+    return message;
+  }
+}
+async function recentJitoTip(config) {
+  const response = await fetch(`${config.jitoBlockEngineUrl}/api/v1/bundles/tip_floor`);
+  if (!response.ok) {
+    return BigInt(0);
+  }
+  const data = await response.json().then((res) => res[0]);
+  const percentileToKey = {
+    "25": "landed_tips_25th_percentile",
+    "50": "landed_tips_50th_percentile",
+    "75": "landed_tips_75th_percentile",
+    "95": "landed_tips_95th_percentile",
+    "99": "landed_tips_99th_percentile",
+    "50ema": "ema_landed_tips_50th_percentile"
+  };
+  const key = percentileToKey[config.priorityFee.priorityFeePercentile ?? "50"];
+  if (!key || !data[key]) {
+    return BigInt(0);
+  }
+  return (0, import_kit2.lamports)(BigInt(Math.floor(Number(data[key]) * 10 ** 9))).valueOf();
+}
+var jitoTipAddresses = [
+  "96gYZGLnJYVFmbjzopPSU6QiEV5fGqZNyN9nmNhvrZU5",
+  "HFqU5x63VTqvQss8hp11i4wVV8bD44PvwucfZ2bU7gRe",
+  "Cw8CFyM9FkoMi7K7Crf6HNQqf4uEMzpKw6QNghXLvLkY",
+  "ADaUMid9yfUytqMBgopwjb2DTLSokTSzL1zt6iGPaS49",
+  "DfXygSm4jCyNCybVYYK6DwvWqjKee8pbDmJGcLWNDXjh",
+  "ADuUkR4vqLUMWXxW9gh6D6L8pMSawimctcNZ5pGwDcEt",
+  "DttWaMuVvTiduZRnguLF7jNxTgiMBZ1hyAumKUiL2KRL",
+  "3AVi9Tg9Uo68tJfuvoKvqKNWKkC5wPdSSdeBnizKZ6jT"
+];
+function getJitoTipAddress() {
+  return (0, import_kit2.address)(jitoTipAddresses[Math.floor(Math.random() * jitoTipAddresses.length)]);
+}
+
+// src/buildTransaction.ts
+async function buildTransaction(rpc, config, instructions, feePayer, lookupTableAddresses) {
+  return buildTransactionMessage(
+    rpc,
+    config,
+    instructions,
+    !("address" in feePayer) ? (0, import_kit3.createNoopSigner)(feePayer) : feePayer,
+    lookupTableAddresses
+  );
+}
+async function buildTransactionMessage(rpc, config, instructions, signer, lookupTableAddresses) {
+  let message = await prepareTransactionMessage(instructions, rpc, signer);
+  if (lookupTableAddresses?.length) {
+    const lookupTableAccounts = await (0, import_address_lookup_table.fetchAllMaybeAddressLookupTable)(rpc, lookupTableAddresses);
+    const tables = lookupTableAccounts.reduce(
+      (prev, account) => {
+        if (account.exists) {
+          (0, import_kit3.assertAccountDecoded)(account);
+          prev[account.address] = account.data.addresses;
+        }
+        return prev;
+      },
+      {}
+    );
+    message = (0, import_kit3.compressTransactionMessageUsingAddressLookupTables)(message, tables);
+  }
+  const messageWithExtraInstructions = await addPriorityInstructions(rpc, message, signer, config);
+  return (0, import_kit3.signTransactionMessageWithSigners)(messageWithExtraInstructions);
+}
+async function prepareTransactionMessage(instructions, rpc, signer) {
+  const { value: blockhash } = await rpc.getLatestBlockhash({
+    commitment: "confirmed"
+  }).send();
+  return (0, import_kit3.pipe)(
+    (0, import_kit3.createTransactionMessage)({ version: 0 }),
+    (tx) => (0, import_kit3.setTransactionMessageLifetimeUsingBlockhash)(blockhash, tx),
+    (tx) => (0, import_kit3.setTransactionMessageFeePayerSigner)(signer, tx),
+    (tx) => (0, import_kit3.appendTransactionMessageInstructions)(instructions, tx)
+  );
+}
+async function addPriorityInstructions(rpc, message, signer, config) {
+  if (config.jito.type !== "none") {
+    message = await processJitoTipForTxMessage(message, signer, config);
+  }
+  let computeUnits = 14e5;
+  try {
+    computeUnits = await getComputeUnitsForTxMessage(rpc, message);
+  } catch {
+    console.warn("Transaction simulation failed, using 1,400,000 compute units");
+  }
+  return processComputeBudgetForTxMessage(rpc, message, computeUnits, config);
+}
+async function getComputeUnitsForTxMessage(rpc, txMessage) {
+  return await (0, import_kit3.estimateComputeUnitLimitFactory)({ rpc })(txMessage);
+}
+
+// src/sendTransaction.ts
+var import_kit4 = require("@solana/kit");
+async function sendTransaction(rpc, instructions, payer, config, lookupTableAddresses, commitment = "confirmed") {
+  const tx = await buildTransaction(
+    rpc,
+    config ?? DEFAULT_TRANSACTION_CONFIG,
+    instructions,
+    payer,
+    lookupTableAddresses
+  );
+  return sendSignedTransaction(rpc, tx, commitment);
+}
+async function sendSignedTransaction(rpc, transaction, commitment = "confirmed") {
+  const txSignature = getTxSignature(transaction);
+  const encodedTransaction = (0, import_kit4.getBase64EncodedWireTransaction)(transaction);
+  const simResult = await rpc.simulateTransaction(encodedTransaction, {
+    encoding: "base64"
+  }).send();
+  if (simResult.value.err) {
+    throw new Error(`Transaction simulation failed`, { cause: simResult.value });
+  }
+  const expiryTime = Date.now() + 6e4;
+  while (Date.now() < expiryTime) {
+    await rpc.sendTransaction(encodedTransaction, {
+      maxRetries: BigInt(0),
+      skipPreflight: true,
+      encoding: "base64"
+    }).send();
+    const { value } = await rpc.getSignatureStatuses([txSignature]).send();
+    const status = value[0];
+    if (status?.confirmationStatus === commitment) {
+      if (status.err) {
+        throw new Error(`Transaction failed`, { cause: status.err });
+      }
+      return txSignature;
+    }
+  }
+  throw new Error("Transaction expired");
+}
+function getTxSignature(transaction) {
+  const [signature] = Object.values(transaction.signatures);
+  return (0, import_kit4.getBase58Decoder)().decode(signature);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_COMPUTE_UNIT_MARGIN_MULTIPLIER,
+  DEFAULT_TRANSACTION_CONFIG,
+  buildTransaction,
+  sendSignedTransaction,
+  sendTransaction
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/buildTransaction.ts","../src/computeBudget.ts","../src/config.ts","../src/jito.ts","../src/sendTransaction.ts"],"sourcesContent":["export * from \"./buildTransaction\";\nexport * from \"./config\";\nexport * from \"./sendTransaction\";\n","import {\n  Address,\n  appendTransactionMessageInstructions,\n  assertAccountDecoded,\n  compressTransactionMessageUsingAddressLookupTables,\n  createNoopSigner,\n  createTransactionMessage,\n  estimateComputeUnitLimitFactory,\n  Instruction,\n  pipe,\n  Rpc,\n  SendableTransaction,\n  setTransactionMessageFeePayerSigner,\n  setTransactionMessageLifetimeUsingBlockhash,\n  signTransactionMessageWithSigners,\n  SolanaRpcApi,\n  Transaction,\n  TransactionMessage,\n  TransactionMessageWithFeePayer,\n  TransactionSigner,\n  TransactionWithLifetime,\n} from \"@solana/kit\";\nimport { fetchAllMaybeAddressLookupTable } from \"@solana-program/address-lookup-table\";\n\nimport { processComputeBudgetForTxMessage } from \"./computeBudget.ts\";\nimport { TransactionConfig } from \"./config\";\nimport { processJitoTipForTxMessage } from \"./jito.ts\";\n\n/**\n * Builds and signs a transaction from the given instructions and configuration.\n *\n * @param {Rpc<SolanaRpcApi>} rpc - Solana Rpc client.\n * @param {TransactionConfig} config - The transaction config.\n * @param {Instruction[]} instructions - Array of instructions to include in the transaction\n * @param {TransactionSigner} feePayer - The signer that will pay for the transaction\n * @param {(Address | string)[]} [lookupTableAddresses] - Optional array of address lookup table addresses to compress the transaction\n *\n * @returns {Promise<Readonly<SendableTransaction & Transaction & TransactionWithLifetime>>} A signed and encoded transaction\n *\n * @example\n * const instructions = [createATAix, createTransferSolInstruction];\n * const feePayer = wallet.publicKey;\n * const message = await buildTransaction(\n *   rpc,\n *   instructions,\n *   feePayer,\n * );\n */\nexport async function buildTransaction(\n  rpc: Rpc<SolanaRpcApi>,\n  config: TransactionConfig,\n  instructions: Instruction[],\n  feePayer: TransactionSigner | Address,\n  lookupTableAddresses?: Address[],\n): Promise<Readonly<SendableTransaction & Transaction & TransactionWithLifetime>> {\n  return buildTransactionMessage(\n    rpc,\n    config,\n    instructions,\n    !(\"address\" in feePayer) ? createNoopSigner(feePayer) : feePayer,\n    lookupTableAddresses,\n  );\n}\n\nasync function buildTransactionMessage(\n  rpc: Rpc<SolanaRpcApi>,\n  config: TransactionConfig,\n  instructions: Instruction[],\n  signer: TransactionSigner,\n  lookupTableAddresses?: Address[],\n) {\n  let message = await prepareTransactionMessage(instructions, rpc, signer);\n\n  if (lookupTableAddresses?.length) {\n    const lookupTableAccounts = await fetchAllMaybeAddressLookupTable(rpc, lookupTableAddresses);\n    const tables = lookupTableAccounts.reduce(\n      (prev, account) => {\n        if (account.exists) {\n          assertAccountDecoded(account);\n          prev[account.address] = account.data.addresses;\n        }\n        return prev;\n      },\n      {} as { [address: Address]: Address[] },\n    );\n    message = compressTransactionMessageUsingAddressLookupTables(message, tables);\n  }\n\n  const messageWithExtraInstructions = await addPriorityInstructions(rpc, message, signer, config);\n\n  return signTransactionMessageWithSigners(messageWithExtraInstructions);\n}\n\nasync function prepareTransactionMessage(\n  instructions: Instruction[],\n  rpc: Rpc<SolanaRpcApi>,\n  signer: TransactionSigner,\n) {\n  const { value: blockhash } = await rpc\n    .getLatestBlockhash({\n      commitment: \"confirmed\",\n    })\n    .send();\n\n  return pipe(\n    createTransactionMessage({ version: 0 }),\n    tx => setTransactionMessageLifetimeUsingBlockhash(blockhash, tx),\n    tx => setTransactionMessageFeePayerSigner(signer, tx),\n    tx => appendTransactionMessageInstructions(instructions, tx),\n  );\n}\n\nasync function addPriorityInstructions(\n  rpc: Rpc<SolanaRpcApi>,\n  message: TransactionMessage & TransactionMessageWithFeePayer,\n  signer: TransactionSigner,\n  config: TransactionConfig,\n): Promise<TransactionMessage & TransactionMessageWithFeePayer> {\n  if (config.jito.type !== \"none\") {\n    message = await processJitoTipForTxMessage(message, signer, config);\n  }\n\n  let computeUnits = 1_400_000;\n\n  try {\n    computeUnits = await getComputeUnitsForTxMessage(rpc, message);\n  } catch {\n    console.warn(\"Transaction simulation failed, using 1,400,000 compute units\");\n  }\n\n  return processComputeBudgetForTxMessage(rpc, message, computeUnits, config);\n}\n\nasync function getComputeUnitsForTxMessage(\n  rpc: Rpc<SolanaRpcApi>,\n  txMessage: TransactionMessage & TransactionMessageWithFeePayer,\n) {\n  return await estimateComputeUnitLimitFactory({ rpc })(txMessage);\n}\n","import {\n  Address,\n  Instruction,\n  Rpc,\n  SolanaRpcApi,\n  TransactionMessage,\n  TransactionMessageWithFeePayer,\n} from \"@solana/kit\";\nimport { isWritableRole, prependTransactionMessageInstruction } from \"@solana/kit\";\nimport { getSetComputeUnitLimitInstruction, getSetComputeUnitPriceInstruction } from \"@solana-program/compute-budget\";\n\nimport type { Percentile, TransactionConfig } from \"./config\";\nimport { DEFAULT_COMPUTE_UNIT_MARGIN_MULTIPLIER } from \"./config\";\n\nexport async function processComputeBudgetForTxMessage(\n  rpc: Rpc<SolanaRpcApi>,\n  message: TransactionMessage & TransactionMessageWithFeePayer,\n  computeUnits: number,\n  config: TransactionConfig,\n) {\n  const priorityFee = config.priorityFee;\n  const computeUnitMarginMultiplier = config.computeUnitMarginMultiplier;\n  let priorityFeeMicroLamports = 0n;\n\n  if (priorityFee.type === \"exact\") {\n    priorityFeeMicroLamports = (priorityFee.amountLamports * 1_000_000n) / BigInt(computeUnits);\n  } else if (priorityFee.type === \"dynamic\") {\n    const estimatedPriorityFee = await calculateDynamicPriorityFees(\n      rpc,\n      message.instructions,\n      priorityFee.priorityFeePercentile ?? \"50\",\n    );\n\n    if (!priorityFee.maxCapLamports) {\n      priorityFeeMicroLamports = estimatedPriorityFee;\n    } else {\n      const maxCapMicroLamports = (priorityFee.maxCapLamports * 1_000_000n) / BigInt(computeUnits);\n\n      priorityFeeMicroLamports =\n        maxCapMicroLamports > estimatedPriorityFee ? estimatedPriorityFee : maxCapMicroLamports;\n    }\n  }\n\n  if (priorityFeeMicroLamports > 0) {\n    message = prependTransactionMessageInstruction(\n      getSetComputeUnitPriceInstruction({\n        microLamports: priorityFeeMicroLamports,\n      }),\n      message,\n    );\n  }\n\n  message = prependTransactionMessageInstruction(\n    getSetComputeUnitLimitInstruction({\n      units: Math.ceil(computeUnits * (computeUnitMarginMultiplier ?? DEFAULT_COMPUTE_UNIT_MARGIN_MULTIPLIER)),\n    }),\n    message,\n  );\n\n  return message;\n}\n\nfunction getWritableAccounts(ixs: readonly Instruction[]) {\n  const writable = new Set<Address>();\n  ixs.forEach(ix => {\n    if (ix.accounts) {\n      ix.accounts.forEach(acc => {\n        if (isWritableRole(acc.role)) writable.add(acc.address);\n      });\n    }\n  });\n  return Array.from(writable);\n}\n\nasync function calculateDynamicPriorityFees(\n  rpc: Rpc<SolanaRpcApi>,\n  instructions: readonly Instruction[],\n  percentile: Percentile,\n) {\n  const writableAccounts = getWritableAccounts(instructions);\n  const recent = await rpc.getRecentPrioritizationFees(writableAccounts).send();\n  const nonZero = recent.filter(pf => pf.prioritizationFee > 0).map(pf => pf.prioritizationFee);\n  const sorted = nonZero.sort((a, b) => Number(a - b));\n  return sorted[Math.floor(sorted.length * (parseInt(percentile) / 100))] || BigInt(0);\n}\n","/**\n * Default compute unit margin multiplier used to ensure sufficient compute budget.\n */\nexport const DEFAULT_COMPUTE_UNIT_MARGIN_MULTIPLIER = 1.15;\n\n/**\n * Default prioritization settings, including priority fees and Jito tips.\n */\nexport const DEFAULT_TRANSACTION_CONFIG: TransactionConfig = {\n  priorityFee: {\n    type: \"none\",\n    priorityFeePercentile: \"50\",\n  },\n  jito: {\n    type: \"none\",\n    priorityFeePercentile: \"50\",\n  },\n  computeUnitMarginMultiplier: DEFAULT_COMPUTE_UNIT_MARGIN_MULTIPLIER,\n  jitoBlockEngineUrl: \"https://bundles.jito.wtf\",\n};\n\n/*\nasync function getChainIdFromGenesisHash(rpc: Rpc<SolanaRpcApi>): Promise<ChainId> {\n  // not all rpc endpoints support getGenesisHash\n  try {\n    const genesisHash = await rpc.getGenesisHash().send();\n    const genesisHashToChainId: Record<string, ChainId> = {\n      \"5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d\": \"solana\",\n      EAQLJCV2mh23BsK2P9oYpV5CHVLDNHTxYss3URrNmg3s: \"eclipse\",\n      EtWTRABZaYq6iMfeYKouRu166VU2xqa1wcaWoxPkrZBG: \"solana-devnet\",\n      CX4huckiV9QNAkKNVKi5Tj8nxzBive5kQimd94viMKsU: \"eclipse-testnet\",\n    };\n    return genesisHashToChainId[genesisHash] || \"unknown\";\n  } catch (error) {\n    console.warn(\"Error getting chain ID from genesis hash\", error);\n    return \"unknown\";\n  }\n}\n */\n\ntype FeeSetting =\n  | {\n      type: \"dynamic\";\n      maxCapLamports?: bigint;\n    }\n  | {\n      type: \"exact\";\n      amountLamports: bigint;\n    }\n  | {\n      type: \"none\";\n    };\n\n/**\n * Configuration for transaction fees, including Jito and priority fee settings.\n */\nexport type JitoFeeSetting = FeeSetting & {\n  priorityFeePercentile?: Percentile | \"50ema\";\n};\n\nexport type PriorityFeeSetting = FeeSetting & {\n  priorityFeePercentile?: Percentile;\n};\n\nexport type TransactionConfig = {\n  jito: JitoFeeSetting;\n  priorityFee: PriorityFeeSetting;\n  computeUnitMarginMultiplier: number;\n  jitoBlockEngineUrl: string;\n};\n\n/**\n * Defines a percentile value for priority fee selection.\n */\nexport type Percentile = \"25\" | \"50\" | \"75\" | \"95\" | \"99\";\n\n/**\n * Represents a supported blockchain network chain ID.\n */\nexport type ChainId = \"solana\" | \"eclipse\" | \"solana-devnet\" | \"eclipse-testnet\" | \"unknown\";\n","import { Address, TransactionMessage, TransactionMessageWithFeePayer, TransactionSigner } from \"@solana/kit\";\nimport { address, lamports, prependTransactionMessageInstruction } from \"@solana/kit\";\nimport { getTransferSolInstruction } from \"@solana-program/system\";\n\nimport { type Percentile, TransactionConfig } from \"./config\";\n\nexport async function processJitoTipForTxMessage(\n  message: TransactionMessage & TransactionMessageWithFeePayer,\n  signer: TransactionSigner,\n  config: TransactionConfig,\n) {\n  let jitoTipLamports = BigInt(0);\n  const jito = config.jito;\n\n  if (jito.type === \"exact\") {\n    jitoTipLamports = jito.amountLamports;\n  } else if (jito.type === \"dynamic\") {\n    jitoTipLamports = await recentJitoTip(config);\n  }\n  if (jitoTipLamports > 0) {\n    return prependTransactionMessageInstruction(\n      getTransferSolInstruction({\n        source: signer,\n        destination: getJitoTipAddress(),\n        amount: jitoTipLamports,\n      }),\n      message,\n    );\n  } else {\n    return message;\n  }\n}\n\n// returns recent jito tip in lamports\nexport async function recentJitoTip(config: TransactionConfig) {\n  const response = await fetch(`${config.jitoBlockEngineUrl}/api/v1/bundles/tip_floor`);\n  if (!response.ok) {\n    return BigInt(0);\n  }\n  const data = await response.json().then(res => res[0]);\n\n  const percentileToKey: Record<Percentile | \"50ema\", string> = {\n    \"25\": \"landed_tips_25th_percentile\",\n    \"50\": \"landed_tips_50th_percentile\",\n    \"75\": \"landed_tips_75th_percentile\",\n    \"95\": \"landed_tips_95th_percentile\",\n    \"99\": \"landed_tips_99th_percentile\",\n    \"50ema\": \"ema_landed_tips_50th_percentile\",\n  };\n\n  const key = percentileToKey[config.priorityFee.priorityFeePercentile ?? \"50\"];\n  if (!key || !data[key]) {\n    return BigInt(0);\n  }\n  return lamports(BigInt(Math.floor(Number(data[key]) * 10 ** 9))).valueOf();\n}\n\n// should we add an argument that dictates if we should use cached value in case fetch fails ?\n\n// below is taken from legacy sdk (no need to add the whole library)\n// https://jito-foundation.gitbook.io/mev/mev-payment-and-distribution/on-chain-addresses\nconst jitoTipAddresses = [\n  \"96gYZGLnJYVFmbjzopPSU6QiEV5fGqZNyN9nmNhvrZU5\",\n  \"HFqU5x63VTqvQss8hp11i4wVV8bD44PvwucfZ2bU7gRe\",\n  \"Cw8CFyM9FkoMi7K7Crf6HNQqf4uEMzpKw6QNghXLvLkY\",\n  \"ADaUMid9yfUytqMBgopwjb2DTLSokTSzL1zt6iGPaS49\",\n  \"DfXygSm4jCyNCybVYYK6DwvWqjKee8pbDmJGcLWNDXjh\",\n  \"ADuUkR4vqLUMWXxW9gh6D6L8pMSawimctcNZ5pGwDcEt\",\n  \"DttWaMuVvTiduZRnguLF7jNxTgiMBZ1hyAumKUiL2KRL\",\n  \"3AVi9Tg9Uo68tJfuvoKvqKNWKkC5wPdSSdeBnizKZ6jT\",\n];\n\nfunction getJitoTipAddress(): Address {\n  // just pick a random one from the list. There are multiple addresses so that no single one\n  // can cause local congestion.\n  return address(jitoTipAddresses[Math.floor(Math.random() * jitoTipAddresses.length)]);\n}\n","import {\n  Address,\n  Commitment,\n  getBase58Decoder,\n  getBase64EncodedWireTransaction,\n  Instruction,\n  KeyPairSigner,\n  Rpc,\n  SendableTransaction,\n  Signature,\n  SolanaRpcApi,\n  Transaction,\n  TransactionWithLifetime,\n} from \"@solana/kit\";\n\nimport { buildTransaction } from \"./buildTransaction\";\nimport { DEFAULT_TRANSACTION_CONFIG, TransactionConfig } from \"./config\";\n\n/**\n * Builds and sends a transaction with the given instructions, signers, and commitment level.\n *\n * @param {Rpc<SolanaRpcApi>} rpc - Solana Rpc client.\n * @param {Instruction[]} instructions - Array of instructions to include in the transaction.\n * @param {KeyPairSigner} payer - The fee payer for the transaction.\n * @param {TransactionConfig} config - The transaction config.\n * @param {Address[]} [lookupTableAddresses] - Optional array of address lookup table addresses to use.\n * @param {Commitment} [commitment=\"confirmed\"] - The commitment level for transaction confirmation.\n *\n * @returns {Promise<Signature>} A promise that resolves to the transaction signature.\n *\n * @throws {Error} If transaction building or sending fails.\n *\n * @example\n * ```ts\n * const signature = await sendTransaction(\n *   instructions,\n *   keypairSigner,\n *   DEFAULT_TRANSACTION_CONFIG,\n *   lookupTables,\n *   \"finalized\"\n * );\n * ```\n */\nexport async function sendTransaction(\n  rpc: Rpc<SolanaRpcApi>,\n  instructions: Instruction[],\n  payer: KeyPairSigner,\n  config?: TransactionConfig,\n  lookupTableAddresses?: Address[],\n  commitment: Commitment = \"confirmed\",\n): Promise<Signature> {\n  const tx = await buildTransaction(\n    rpc,\n    config ?? DEFAULT_TRANSACTION_CONFIG,\n    instructions,\n    payer,\n    lookupTableAddresses,\n  );\n  return sendSignedTransaction(rpc, tx, commitment);\n}\n\n/**\n * Sends a signed transaction message to the Solana network with a specified commitment level.\n *\n * @param {Rpc<SolanaRpcApi>} rpc - Rpc client.\n * @param {SendableTransaction & Transaction & TransactionWithLifetime} transaction - The fully signed transaction to send.\n * @param {Commitment} [commitment=\"confirmed\"] - The commitment level for transaction confirmation.\n *\n * @returns {Promise<Signature>} A promise that resolves to the transaction signature.\n *\n * @throws {Error} If transaction sending fails, the RPC connection fails, or the transaction expires.\n *\n * @example\n * ```ts\n * const signature = await sendSignedTransaction(\n *   rpc,\n *   signedTransaction,\n *   \"finalized\"\n * );\n * ```\n */\nexport async function sendSignedTransaction(\n  rpc: Rpc<SolanaRpcApi>,\n  transaction: SendableTransaction & Transaction & TransactionWithLifetime,\n  commitment: Commitment = \"confirmed\",\n): Promise<Signature> {\n  const txSignature = getTxSignature(transaction);\n  const encodedTransaction = getBase64EncodedWireTransaction(transaction);\n\n  // Simulate transaction first\n  const simResult = await rpc\n    .simulateTransaction(encodedTransaction, {\n      encoding: \"base64\",\n    })\n    .send();\n\n  if (simResult.value.err) {\n    throw new Error(`Transaction simulation failed`, { cause: simResult.value });\n  }\n\n  const expiryTime = Date.now() + 60_000;\n\n  while (Date.now() < expiryTime) {\n    await rpc\n      .sendTransaction(encodedTransaction, {\n        maxRetries: BigInt(0),\n        skipPreflight: true,\n        encoding: \"base64\",\n      })\n      .send();\n\n    const { value } = await rpc.getSignatureStatuses([txSignature]).send();\n    const status = value[0];\n    if (status?.confirmationStatus === commitment) {\n      if (status.err) {\n        throw new Error(`Transaction failed`, { cause: status.err });\n      }\n      return txSignature;\n    }\n  }\n\n  throw new Error(\"Transaction expired\");\n}\n\nfunction getTxSignature(transaction: Transaction) {\n  const [signature] = Object.values(transaction.signatures);\n  return getBase58Decoder().decode(signature!) as Signature;\n}\n"],"mappings":"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","names":["import_kit","import_kit","import_kit"]}

package/dist/index.d.cts

@@ -0,0 +1,114 @@
+import { Rpc, SolanaRpcApi, Instruction, TransactionSigner, Address, SendableTransaction, Transaction, TransactionWithLifetime, Commitment, Signature, KeyPairSigner } from '@solana/kit';
+
+/**
+ * Default compute unit margin multiplier used to ensure sufficient compute budget.
+ */
+declare const DEFAULT_COMPUTE_UNIT_MARGIN_MULTIPLIER = 1.15;
+/**
+ * Default prioritization settings, including priority fees and Jito tips.
+ */
+declare const DEFAULT_TRANSACTION_CONFIG: TransactionConfig;
+type FeeSetting = {
+    type: "dynamic";
+    maxCapLamports?: bigint;
+} | {
+    type: "exact";
+    amountLamports: bigint;
+} | {
+    type: "none";
+};
+/**
+ * Configuration for transaction fees, including Jito and priority fee settings.
+ */
+type JitoFeeSetting = FeeSetting & {
+    priorityFeePercentile?: Percentile | "50ema";
+};
+type PriorityFeeSetting = FeeSetting & {
+    priorityFeePercentile?: Percentile;
+};
+type TransactionConfig = {
+    jito: JitoFeeSetting;
+    priorityFee: PriorityFeeSetting;
+    computeUnitMarginMultiplier: number;
+    jitoBlockEngineUrl: string;
+};
+/**
+ * Defines a percentile value for priority fee selection.
+ */
+type Percentile = "25" | "50" | "75" | "95" | "99";
+/**
+ * Represents a supported blockchain network chain ID.
+ */
+type ChainId = "solana" | "eclipse" | "solana-devnet" | "eclipse-testnet" | "unknown";
+
+/**
+ * Builds and signs a transaction from the given instructions and configuration.
+ *
+ * @param {Rpc<SolanaRpcApi>} rpc - Solana Rpc client.
+ * @param {TransactionConfig} config - The transaction config.
+ * @param {Instruction[]} instructions - Array of instructions to include in the transaction
+ * @param {TransactionSigner} feePayer - The signer that will pay for the transaction
+ * @param {(Address | string)[]} [lookupTableAddresses] - Optional array of address lookup table addresses to compress the transaction
+ *
+ * @returns {Promise<Readonly<SendableTransaction & Transaction & TransactionWithLifetime>>} A signed and encoded transaction
+ *
+ * @example
+ * const instructions = [createATAix, createTransferSolInstruction];
+ * const feePayer = wallet.publicKey;
+ * const message = await buildTransaction(
+ *   rpc,
+ *   instructions,
+ *   feePayer,
+ * );
+ */
+declare function buildTransaction(rpc: Rpc<SolanaRpcApi>, config: TransactionConfig, instructions: Instruction[], feePayer: TransactionSigner | Address, lookupTableAddresses?: Address[]): Promise<Readonly<SendableTransaction & Transaction & TransactionWithLifetime>>;
+
+/**
+ * Builds and sends a transaction with the given instructions, signers, and commitment level.
+ *
+ * @param {Rpc<SolanaRpcApi>} rpc - Solana Rpc client.
+ * @param {Instruction[]} instructions - Array of instructions to include in the transaction.
+ * @param {KeyPairSigner} payer - The fee payer for the transaction.
+ * @param {TransactionConfig} config - The transaction config.
+ * @param {Address[]} [lookupTableAddresses] - Optional array of address lookup table addresses to use.
+ * @param {Commitment} [commitment="confirmed"] - The commitment level for transaction confirmation.
+ *
+ * @returns {Promise<Signature>} A promise that resolves to the transaction signature.
+ *
+ * @throws {Error} If transaction building or sending fails.
+ *
+ * @example
+ * ```ts
+ * const signature = await sendTransaction(
+ *   instructions,
+ *   keypairSigner,
+ *   DEFAULT_TRANSACTION_CONFIG,
+ *   lookupTables,
+ *   "finalized"
+ * );
+ * ```
+ */
+declare function sendTransaction(rpc: Rpc<SolanaRpcApi>, instructions: Instruction[], payer: KeyPairSigner, config?: TransactionConfig, lookupTableAddresses?: Address[], commitment?: Commitment): Promise<Signature>;
+/**
+ * Sends a signed transaction message to the Solana network with a specified commitment level.
+ *
+ * @param {Rpc<SolanaRpcApi>} rpc - Rpc client.
+ * @param {SendableTransaction & Transaction & TransactionWithLifetime} transaction - The fully signed transaction to send.
+ * @param {Commitment} [commitment="confirmed"] - The commitment level for transaction confirmation.
+ *
+ * @returns {Promise<Signature>} A promise that resolves to the transaction signature.
+ *
+ * @throws {Error} If transaction sending fails, the RPC connection fails, or the transaction expires.
+ *
+ * @example
+ * ```ts
+ * const signature = await sendSignedTransaction(
+ *   rpc,
+ *   signedTransaction,
+ *   "finalized"
+ * );
+ * ```
+ */
+declare function sendSignedTransaction(rpc: Rpc<SolanaRpcApi>, transaction: SendableTransaction & Transaction & TransactionWithLifetime, commitment?: Commitment): Promise<Signature>;
+
+export { type ChainId, DEFAULT_COMPUTE_UNIT_MARGIN_MULTIPLIER, DEFAULT_TRANSACTION_CONFIG, type JitoFeeSetting, type Percentile, type PriorityFeeSetting, type TransactionConfig, buildTransaction, sendSignedTransaction, sendTransaction };

package/dist/index.d.ts

@@ -0,0 +1,114 @@
+import { Rpc, SolanaRpcApi, Instruction, TransactionSigner, Address, SendableTransaction, Transaction, TransactionWithLifetime, Commitment, Signature, KeyPairSigner } from '@solana/kit';
+
+/**
+ * Default compute unit margin multiplier used to ensure sufficient compute budget.
+ */
+declare const DEFAULT_COMPUTE_UNIT_MARGIN_MULTIPLIER = 1.15;
+/**
+ * Default prioritization settings, including priority fees and Jito tips.
+ */
+declare const DEFAULT_TRANSACTION_CONFIG: TransactionConfig;
+type FeeSetting = {
+    type: "dynamic";
+    maxCapLamports?: bigint;
+} | {
+    type: "exact";
+    amountLamports: bigint;
+} | {
+    type: "none";
+};
+/**
+ * Configuration for transaction fees, including Jito and priority fee settings.
+ */
+type JitoFeeSetting = FeeSetting & {
+    priorityFeePercentile?: Percentile | "50ema";
+};
+type PriorityFeeSetting = FeeSetting & {
+    priorityFeePercentile?: Percentile;
+};
+type TransactionConfig = {
+    jito: JitoFeeSetting;
+    priorityFee: PriorityFeeSetting;
+    computeUnitMarginMultiplier: number;
+    jitoBlockEngineUrl: string;
+};
+/**
+ * Defines a percentile value for priority fee selection.
+ */
+type Percentile = "25" | "50" | "75" | "95" | "99";
+/**
+ * Represents a supported blockchain network chain ID.
+ */
+type ChainId = "solana" | "eclipse" | "solana-devnet" | "eclipse-testnet" | "unknown";
+
+/**
+ * Builds and signs a transaction from the given instructions and configuration.
+ *
+ * @param {Rpc<SolanaRpcApi>} rpc - Solana Rpc client.
+ * @param {TransactionConfig} config - The transaction config.
+ * @param {Instruction[]} instructions - Array of instructions to include in the transaction
+ * @param {TransactionSigner} feePayer - The signer that will pay for the transaction
+ * @param {(Address | string)[]} [lookupTableAddresses] - Optional array of address lookup table addresses to compress the transaction
+ *
+ * @returns {Promise<Readonly<SendableTransaction & Transaction & TransactionWithLifetime>>} A signed and encoded transaction
+ *
+ * @example
+ * const instructions = [createATAix, createTransferSolInstruction];
+ * const feePayer = wallet.publicKey;
+ * const message = await buildTransaction(
+ *   rpc,
+ *   instructions,
+ *   feePayer,
+ * );
+ */
+declare function buildTransaction(rpc: Rpc<SolanaRpcApi>, config: TransactionConfig, instructions: Instruction[], feePayer: TransactionSigner | Address, lookupTableAddresses?: Address[]): Promise<Readonly<SendableTransaction & Transaction & TransactionWithLifetime>>;
+
+/**
+ * Builds and sends a transaction with the given instructions, signers, and commitment level.
+ *
+ * @param {Rpc<SolanaRpcApi>} rpc - Solana Rpc client.
+ * @param {Instruction[]} instructions - Array of instructions to include in the transaction.
+ * @param {KeyPairSigner} payer - The fee payer for the transaction.
+ * @param {TransactionConfig} config - The transaction config.
+ * @param {Address[]} [lookupTableAddresses] - Optional array of address lookup table addresses to use.
+ * @param {Commitment} [commitment="confirmed"] - The commitment level for transaction confirmation.
+ *
+ * @returns {Promise<Signature>} A promise that resolves to the transaction signature.
+ *
+ * @throws {Error} If transaction building or sending fails.
+ *
+ * @example
+ * ```ts
+ * const signature = await sendTransaction(
+ *   instructions,
+ *   keypairSigner,
+ *   DEFAULT_TRANSACTION_CONFIG,
+ *   lookupTables,
+ *   "finalized"
+ * );
+ * ```
+ */
+declare function sendTransaction(rpc: Rpc<SolanaRpcApi>, instructions: Instruction[], payer: KeyPairSigner, config?: TransactionConfig, lookupTableAddresses?: Address[], commitment?: Commitment): Promise<Signature>;
+/**
+ * Sends a signed transaction message to the Solana network with a specified commitment level.
+ *
+ * @param {Rpc<SolanaRpcApi>} rpc - Rpc client.
+ * @param {SendableTransaction & Transaction & TransactionWithLifetime} transaction - The fully signed transaction to send.
+ * @param {Commitment} [commitment="confirmed"] - The commitment level for transaction confirmation.
+ *
+ * @returns {Promise<Signature>} A promise that resolves to the transaction signature.
+ *
+ * @throws {Error} If transaction sending fails, the RPC connection fails, or the transaction expires.
+ *
+ * @example
+ * ```ts
+ * const signature = await sendSignedTransaction(
+ *   rpc,
+ *   signedTransaction,
+ *   "finalized"
+ * );
+ * ```
+ */
+declare function sendSignedTransaction(rpc: Rpc<SolanaRpcApi>, transaction: SendableTransaction & Transaction & TransactionWithLifetime, commitment?: Commitment): Promise<Signature>;
+
+export { type ChainId, DEFAULT_COMPUTE_UNIT_MARGIN_MULTIPLIER, DEFAULT_TRANSACTION_CONFIG, type JitoFeeSetting, type Percentile, type PriorityFeeSetting, type TransactionConfig, buildTransaction, sendSignedTransaction, sendTransaction };

package/dist/index.js

@@ -0,0 +1,257 @@
+// src/buildTransaction.ts
+import {
+  appendTransactionMessageInstructions,
+  assertAccountDecoded,
+  compressTransactionMessageUsingAddressLookupTables,
+  createNoopSigner,
+  createTransactionMessage,
+  estimateComputeUnitLimitFactory,
+  pipe,
+  setTransactionMessageFeePayerSigner,
+  setTransactionMessageLifetimeUsingBlockhash,
+  signTransactionMessageWithSigners
+} from "@solana/kit";
+import { fetchAllMaybeAddressLookupTable } from "@solana-program/address-lookup-table";
+
+// src/computeBudget.ts
+import { isWritableRole, prependTransactionMessageInstruction } from "@solana/kit";
+import { getSetComputeUnitLimitInstruction, getSetComputeUnitPriceInstruction } from "@solana-program/compute-budget";
+
+// src/config.ts
+var DEFAULT_COMPUTE_UNIT_MARGIN_MULTIPLIER = 1.15;
+var DEFAULT_TRANSACTION_CONFIG = {
+  priorityFee: {
+    type: "none",
+    priorityFeePercentile: "50"
+  },
+  jito: {
+    type: "none",
+    priorityFeePercentile: "50"
+  },
+  computeUnitMarginMultiplier: DEFAULT_COMPUTE_UNIT_MARGIN_MULTIPLIER,
+  jitoBlockEngineUrl: "https://bundles.jito.wtf"
+};
+
+// src/computeBudget.ts
+async function processComputeBudgetForTxMessage(rpc, message, computeUnits, config) {
+  const priorityFee = config.priorityFee;
+  const computeUnitMarginMultiplier = config.computeUnitMarginMultiplier;
+  let priorityFeeMicroLamports = 0n;
+  if (priorityFee.type === "exact") {
+    priorityFeeMicroLamports = priorityFee.amountLamports * 1000000n / BigInt(computeUnits);
+  } else if (priorityFee.type === "dynamic") {
+    const estimatedPriorityFee = await calculateDynamicPriorityFees(
+      rpc,
+      message.instructions,
+      priorityFee.priorityFeePercentile ?? "50"
+    );
+    if (!priorityFee.maxCapLamports) {
+      priorityFeeMicroLamports = estimatedPriorityFee;
+    } else {
+      const maxCapMicroLamports = priorityFee.maxCapLamports * 1000000n / BigInt(computeUnits);
+      priorityFeeMicroLamports = maxCapMicroLamports > estimatedPriorityFee ? estimatedPriorityFee : maxCapMicroLamports;
+    }
+  }
+  if (priorityFeeMicroLamports > 0) {
+    message = prependTransactionMessageInstruction(
+      getSetComputeUnitPriceInstruction({
+        microLamports: priorityFeeMicroLamports
+      }),
+      message
+    );
+  }
+  message = prependTransactionMessageInstruction(
+    getSetComputeUnitLimitInstruction({
+      units: Math.ceil(computeUnits * (computeUnitMarginMultiplier ?? DEFAULT_COMPUTE_UNIT_MARGIN_MULTIPLIER))
+    }),
+    message
+  );
+  return message;
+}
+function getWritableAccounts(ixs) {
+  const writable = /* @__PURE__ */ new Set();
+  ixs.forEach((ix) => {
+    if (ix.accounts) {
+      ix.accounts.forEach((acc) => {
+        if (isWritableRole(acc.role)) writable.add(acc.address);
+      });
+    }
+  });
+  return Array.from(writable);
+}
+async function calculateDynamicPriorityFees(rpc, instructions, percentile) {
+  const writableAccounts = getWritableAccounts(instructions);
+  const recent = await rpc.getRecentPrioritizationFees(writableAccounts).send();
+  const nonZero = recent.filter((pf) => pf.prioritizationFee > 0).map((pf) => pf.prioritizationFee);
+  const sorted = nonZero.sort((a, b) => Number(a - b));
+  return sorted[Math.floor(sorted.length * (parseInt(percentile) / 100))] || BigInt(0);
+}
+
+// src/jito.ts
+import { address, lamports, prependTransactionMessageInstruction as prependTransactionMessageInstruction2 } from "@solana/kit";
+import { getTransferSolInstruction } from "@solana-program/system";
+async function processJitoTipForTxMessage(message, signer, config) {
+  let jitoTipLamports = BigInt(0);
+  const jito = config.jito;
+  if (jito.type === "exact") {
+    jitoTipLamports = jito.amountLamports;
+  } else if (jito.type === "dynamic") {
+    jitoTipLamports = await recentJitoTip(config);
+  }
+  if (jitoTipLamports > 0) {
+    return prependTransactionMessageInstruction2(
+      getTransferSolInstruction({
+        source: signer,
+        destination: getJitoTipAddress(),
+        amount: jitoTipLamports
+      }),
+      message
+    );
+  } else {
+    return message;
+  }
+}
+async function recentJitoTip(config) {
+  const response = await fetch(`${config.jitoBlockEngineUrl}/api/v1/bundles/tip_floor`);
+  if (!response.ok) {
+    return BigInt(0);
+  }
+  const data = await response.json().then((res) => res[0]);
+  const percentileToKey = {
+    "25": "landed_tips_25th_percentile",
+    "50": "landed_tips_50th_percentile",
+    "75": "landed_tips_75th_percentile",
+    "95": "landed_tips_95th_percentile",
+    "99": "landed_tips_99th_percentile",
+    "50ema": "ema_landed_tips_50th_percentile"
+  };
+  const key = percentileToKey[config.priorityFee.priorityFeePercentile ?? "50"];
+  if (!key || !data[key]) {
+    return BigInt(0);
+  }
+  return lamports(BigInt(Math.floor(Number(data[key]) * 10 ** 9))).valueOf();
+}
+var jitoTipAddresses = [
+  "96gYZGLnJYVFmbjzopPSU6QiEV5fGqZNyN9nmNhvrZU5",
+  "HFqU5x63VTqvQss8hp11i4wVV8bD44PvwucfZ2bU7gRe",
+  "Cw8CFyM9FkoMi7K7Crf6HNQqf4uEMzpKw6QNghXLvLkY",
+  "ADaUMid9yfUytqMBgopwjb2DTLSokTSzL1zt6iGPaS49",
+  "DfXygSm4jCyNCybVYYK6DwvWqjKee8pbDmJGcLWNDXjh",
+  "ADuUkR4vqLUMWXxW9gh6D6L8pMSawimctcNZ5pGwDcEt",
+  "DttWaMuVvTiduZRnguLF7jNxTgiMBZ1hyAumKUiL2KRL",
+  "3AVi9Tg9Uo68tJfuvoKvqKNWKkC5wPdSSdeBnizKZ6jT"
+];
+function getJitoTipAddress() {
+  return address(jitoTipAddresses[Math.floor(Math.random() * jitoTipAddresses.length)]);
+}
+
+// src/buildTransaction.ts
+async function buildTransaction(rpc, config, instructions, feePayer, lookupTableAddresses) {
+  return buildTransactionMessage(
+    rpc,
+    config,
+    instructions,
+    !("address" in feePayer) ? createNoopSigner(feePayer) : feePayer,
+    lookupTableAddresses
+  );
+}
+async function buildTransactionMessage(rpc, config, instructions, signer, lookupTableAddresses) {
+  let message = await prepareTransactionMessage(instructions, rpc, signer);
+  if (lookupTableAddresses?.length) {
+    const lookupTableAccounts = await fetchAllMaybeAddressLookupTable(rpc, lookupTableAddresses);
+    const tables = lookupTableAccounts.reduce(
+      (prev, account) => {
+        if (account.exists) {
+          assertAccountDecoded(account);
+          prev[account.address] = account.data.addresses;
+        }
+        return prev;
+      },
+      {}
+    );
+    message = compressTransactionMessageUsingAddressLookupTables(message, tables);
+  }
+  const messageWithExtraInstructions = await addPriorityInstructions(rpc, message, signer, config);
+  return signTransactionMessageWithSigners(messageWithExtraInstructions);
+}
+async function prepareTransactionMessage(instructions, rpc, signer) {
+  const { value: blockhash } = await rpc.getLatestBlockhash({
+    commitment: "confirmed"
+  }).send();
+  return pipe(
+    createTransactionMessage({ version: 0 }),
+    (tx) => setTransactionMessageLifetimeUsingBlockhash(blockhash, tx),
+    (tx) => setTransactionMessageFeePayerSigner(signer, tx),
+    (tx) => appendTransactionMessageInstructions(instructions, tx)
+  );
+}
+async function addPriorityInstructions(rpc, message, signer, config) {
+  if (config.jito.type !== "none") {
+    message = await processJitoTipForTxMessage(message, signer, config);
+  }
+  let computeUnits = 14e5;
+  try {
+    computeUnits = await getComputeUnitsForTxMessage(rpc, message);
+  } catch {
+    console.warn("Transaction simulation failed, using 1,400,000 compute units");
+  }
+  return processComputeBudgetForTxMessage(rpc, message, computeUnits, config);
+}
+async function getComputeUnitsForTxMessage(rpc, txMessage) {
+  return await estimateComputeUnitLimitFactory({ rpc })(txMessage);
+}
+
+// src/sendTransaction.ts
+import {
+  getBase58Decoder,
+  getBase64EncodedWireTransaction
+} from "@solana/kit";
+async function sendTransaction(rpc, instructions, payer, config, lookupTableAddresses, commitment = "confirmed") {
+  const tx = await buildTransaction(
+    rpc,
+    config ?? DEFAULT_TRANSACTION_CONFIG,
+    instructions,
+    payer,
+    lookupTableAddresses
+  );
+  return sendSignedTransaction(rpc, tx, commitment);
+}
+async function sendSignedTransaction(rpc, transaction, commitment = "confirmed") {
+  const txSignature = getTxSignature(transaction);
+  const encodedTransaction = getBase64EncodedWireTransaction(transaction);
+  const simResult = await rpc.simulateTransaction(encodedTransaction, {
+    encoding: "base64"
+  }).send();
+  if (simResult.value.err) {
+    throw new Error(`Transaction simulation failed`, { cause: simResult.value });
+  }
+  const expiryTime = Date.now() + 6e4;
+  while (Date.now() < expiryTime) {
+    await rpc.sendTransaction(encodedTransaction, {
+      maxRetries: BigInt(0),
+      skipPreflight: true,
+      encoding: "base64"
+    }).send();
+    const { value } = await rpc.getSignatureStatuses([txSignature]).send();
+    const status = value[0];
+    if (status?.confirmationStatus === commitment) {
+      if (status.err) {
+        throw new Error(`Transaction failed`, { cause: status.err });
+      }
+      return txSignature;
+    }
+  }
+  throw new Error("Transaction expired");
+}
+function getTxSignature(transaction) {
+  const [signature] = Object.values(transaction.signatures);
+  return getBase58Decoder().decode(signature);
+}
+export {
+  DEFAULT_COMPUTE_UNIT_MARGIN_MULTIPLIER,
+  DEFAULT_TRANSACTION_CONFIG,
+  buildTransaction,
+  sendSignedTransaction,
+  sendTransaction
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/buildTransaction.ts","../src/computeBudget.ts","../src/config.ts","../src/jito.ts","../src/sendTransaction.ts"],"sourcesContent":["import {\n  Address,\n  appendTransactionMessageInstructions,\n  assertAccountDecoded,\n  compressTransactionMessageUsingAddressLookupTables,\n  createNoopSigner,\n  createTransactionMessage,\n  estimateComputeUnitLimitFactory,\n  Instruction,\n  pipe,\n  Rpc,\n  SendableTransaction,\n  setTransactionMessageFeePayerSigner,\n  setTransactionMessageLifetimeUsingBlockhash,\n  signTransactionMessageWithSigners,\n  SolanaRpcApi,\n  Transaction,\n  TransactionMessage,\n  TransactionMessageWithFeePayer,\n  TransactionSigner,\n  TransactionWithLifetime,\n} from \"@solana/kit\";\nimport { fetchAllMaybeAddressLookupTable } from \"@solana-program/address-lookup-table\";\n\nimport { processComputeBudgetForTxMessage } from \"./computeBudget.ts\";\nimport { TransactionConfig } from \"./config\";\nimport { processJitoTipForTxMessage } from \"./jito.ts\";\n\n/**\n * Builds and signs a transaction from the given instructions and configuration.\n *\n * @param {Rpc<SolanaRpcApi>} rpc - Solana Rpc client.\n * @param {TransactionConfig} config - The transaction config.\n * @param {Instruction[]} instructions - Array of instructions to include in the transaction\n * @param {TransactionSigner} feePayer - The signer that will pay for the transaction\n * @param {(Address | string)[]} [lookupTableAddresses] - Optional array of address lookup table addresses to compress the transaction\n *\n * @returns {Promise<Readonly<SendableTransaction & Transaction & TransactionWithLifetime>>} A signed and encoded transaction\n *\n * @example\n * const instructions = [createATAix, createTransferSolInstruction];\n * const feePayer = wallet.publicKey;\n * const message = await buildTransaction(\n *   rpc,\n *   instructions,\n *   feePayer,\n * );\n */\nexport async function buildTransaction(\n  rpc: Rpc<SolanaRpcApi>,\n  config: TransactionConfig,\n  instructions: Instruction[],\n  feePayer: TransactionSigner | Address,\n  lookupTableAddresses?: Address[],\n): Promise<Readonly<SendableTransaction & Transaction & TransactionWithLifetime>> {\n  return buildTransactionMessage(\n    rpc,\n    config,\n    instructions,\n    !(\"address\" in feePayer) ? createNoopSigner(feePayer) : feePayer,\n    lookupTableAddresses,\n  );\n}\n\nasync function buildTransactionMessage(\n  rpc: Rpc<SolanaRpcApi>,\n  config: TransactionConfig,\n  instructions: Instruction[],\n  signer: TransactionSigner,\n  lookupTableAddresses?: Address[],\n) {\n  let message = await prepareTransactionMessage(instructions, rpc, signer);\n\n  if (lookupTableAddresses?.length) {\n    const lookupTableAccounts = await fetchAllMaybeAddressLookupTable(rpc, lookupTableAddresses);\n    const tables = lookupTableAccounts.reduce(\n      (prev, account) => {\n        if (account.exists) {\n          assertAccountDecoded(account);\n          prev[account.address] = account.data.addresses;\n        }\n        return prev;\n      },\n      {} as { [address: Address]: Address[] },\n    );\n    message = compressTransactionMessageUsingAddressLookupTables(message, tables);\n  }\n\n  const messageWithExtraInstructions = await addPriorityInstructions(rpc, message, signer, config);\n\n  return signTransactionMessageWithSigners(messageWithExtraInstructions);\n}\n\nasync function prepareTransactionMessage(\n  instructions: Instruction[],\n  rpc: Rpc<SolanaRpcApi>,\n  signer: TransactionSigner,\n) {\n  const { value: blockhash } = await rpc\n    .getLatestBlockhash({\n      commitment: \"confirmed\",\n    })\n    .send();\n\n  return pipe(\n    createTransactionMessage({ version: 0 }),\n    tx => setTransactionMessageLifetimeUsingBlockhash(blockhash, tx),\n    tx => setTransactionMessageFeePayerSigner(signer, tx),\n    tx => appendTransactionMessageInstructions(instructions, tx),\n  );\n}\n\nasync function addPriorityInstructions(\n  rpc: Rpc<SolanaRpcApi>,\n  message: TransactionMessage & TransactionMessageWithFeePayer,\n  signer: TransactionSigner,\n  config: TransactionConfig,\n): Promise<TransactionMessage & TransactionMessageWithFeePayer> {\n  if (config.jito.type !== \"none\") {\n    message = await processJitoTipForTxMessage(message, signer, config);\n  }\n\n  let computeUnits = 1_400_000;\n\n  try {\n    computeUnits = await getComputeUnitsForTxMessage(rpc, message);\n  } catch {\n    console.warn(\"Transaction simulation failed, using 1,400,000 compute units\");\n  }\n\n  return processComputeBudgetForTxMessage(rpc, message, computeUnits, config);\n}\n\nasync function getComputeUnitsForTxMessage(\n  rpc: Rpc<SolanaRpcApi>,\n  txMessage: TransactionMessage & TransactionMessageWithFeePayer,\n) {\n  return await estimateComputeUnitLimitFactory({ rpc })(txMessage);\n}\n","import {\n  Address,\n  Instruction,\n  Rpc,\n  SolanaRpcApi,\n  TransactionMessage,\n  TransactionMessageWithFeePayer,\n} from \"@solana/kit\";\nimport { isWritableRole, prependTransactionMessageInstruction } from \"@solana/kit\";\nimport { getSetComputeUnitLimitInstruction, getSetComputeUnitPriceInstruction } from \"@solana-program/compute-budget\";\n\nimport type { Percentile, TransactionConfig } from \"./config\";\nimport { DEFAULT_COMPUTE_UNIT_MARGIN_MULTIPLIER } from \"./config\";\n\nexport async function processComputeBudgetForTxMessage(\n  rpc: Rpc<SolanaRpcApi>,\n  message: TransactionMessage & TransactionMessageWithFeePayer,\n  computeUnits: number,\n  config: TransactionConfig,\n) {\n  const priorityFee = config.priorityFee;\n  const computeUnitMarginMultiplier = config.computeUnitMarginMultiplier;\n  let priorityFeeMicroLamports = 0n;\n\n  if (priorityFee.type === \"exact\") {\n    priorityFeeMicroLamports = (priorityFee.amountLamports * 1_000_000n) / BigInt(computeUnits);\n  } else if (priorityFee.type === \"dynamic\") {\n    const estimatedPriorityFee = await calculateDynamicPriorityFees(\n      rpc,\n      message.instructions,\n      priorityFee.priorityFeePercentile ?? \"50\",\n    );\n\n    if (!priorityFee.maxCapLamports) {\n      priorityFeeMicroLamports = estimatedPriorityFee;\n    } else {\n      const maxCapMicroLamports = (priorityFee.maxCapLamports * 1_000_000n) / BigInt(computeUnits);\n\n      priorityFeeMicroLamports =\n        maxCapMicroLamports > estimatedPriorityFee ? estimatedPriorityFee : maxCapMicroLamports;\n    }\n  }\n\n  if (priorityFeeMicroLamports > 0) {\n    message = prependTransactionMessageInstruction(\n      getSetComputeUnitPriceInstruction({\n        microLamports: priorityFeeMicroLamports,\n      }),\n      message,\n    );\n  }\n\n  message = prependTransactionMessageInstruction(\n    getSetComputeUnitLimitInstruction({\n      units: Math.ceil(computeUnits * (computeUnitMarginMultiplier ?? DEFAULT_COMPUTE_UNIT_MARGIN_MULTIPLIER)),\n    }),\n    message,\n  );\n\n  return message;\n}\n\nfunction getWritableAccounts(ixs: readonly Instruction[]) {\n  const writable = new Set<Address>();\n  ixs.forEach(ix => {\n    if (ix.accounts) {\n      ix.accounts.forEach(acc => {\n        if (isWritableRole(acc.role)) writable.add(acc.address);\n      });\n    }\n  });\n  return Array.from(writable);\n}\n\nasync function calculateDynamicPriorityFees(\n  rpc: Rpc<SolanaRpcApi>,\n  instructions: readonly Instruction[],\n  percentile: Percentile,\n) {\n  const writableAccounts = getWritableAccounts(instructions);\n  const recent = await rpc.getRecentPrioritizationFees(writableAccounts).send();\n  const nonZero = recent.filter(pf => pf.prioritizationFee > 0).map(pf => pf.prioritizationFee);\n  const sorted = nonZero.sort((a, b) => Number(a - b));\n  return sorted[Math.floor(sorted.length * (parseInt(percentile) / 100))] || BigInt(0);\n}\n","/**\n * Default compute unit margin multiplier used to ensure sufficient compute budget.\n */\nexport const DEFAULT_COMPUTE_UNIT_MARGIN_MULTIPLIER = 1.15;\n\n/**\n * Default prioritization settings, including priority fees and Jito tips.\n */\nexport const DEFAULT_TRANSACTION_CONFIG: TransactionConfig = {\n  priorityFee: {\n    type: \"none\",\n    priorityFeePercentile: \"50\",\n  },\n  jito: {\n    type: \"none\",\n    priorityFeePercentile: \"50\",\n  },\n  computeUnitMarginMultiplier: DEFAULT_COMPUTE_UNIT_MARGIN_MULTIPLIER,\n  jitoBlockEngineUrl: \"https://bundles.jito.wtf\",\n};\n\n/*\nasync function getChainIdFromGenesisHash(rpc: Rpc<SolanaRpcApi>): Promise<ChainId> {\n  // not all rpc endpoints support getGenesisHash\n  try {\n    const genesisHash = await rpc.getGenesisHash().send();\n    const genesisHashToChainId: Record<string, ChainId> = {\n      \"5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d\": \"solana\",\n      EAQLJCV2mh23BsK2P9oYpV5CHVLDNHTxYss3URrNmg3s: \"eclipse\",\n      EtWTRABZaYq6iMfeYKouRu166VU2xqa1wcaWoxPkrZBG: \"solana-devnet\",\n      CX4huckiV9QNAkKNVKi5Tj8nxzBive5kQimd94viMKsU: \"eclipse-testnet\",\n    };\n    return genesisHashToChainId[genesisHash] || \"unknown\";\n  } catch (error) {\n    console.warn(\"Error getting chain ID from genesis hash\", error);\n    return \"unknown\";\n  }\n}\n */\n\ntype FeeSetting =\n  | {\n      type: \"dynamic\";\n      maxCapLamports?: bigint;\n    }\n  | {\n      type: \"exact\";\n      amountLamports: bigint;\n    }\n  | {\n      type: \"none\";\n    };\n\n/**\n * Configuration for transaction fees, including Jito and priority fee settings.\n */\nexport type JitoFeeSetting = FeeSetting & {\n  priorityFeePercentile?: Percentile | \"50ema\";\n};\n\nexport type PriorityFeeSetting = FeeSetting & {\n  priorityFeePercentile?: Percentile;\n};\n\nexport type TransactionConfig = {\n  jito: JitoFeeSetting;\n  priorityFee: PriorityFeeSetting;\n  computeUnitMarginMultiplier: number;\n  jitoBlockEngineUrl: string;\n};\n\n/**\n * Defines a percentile value for priority fee selection.\n */\nexport type Percentile = \"25\" | \"50\" | \"75\" | \"95\" | \"99\";\n\n/**\n * Represents a supported blockchain network chain ID.\n */\nexport type ChainId = \"solana\" | \"eclipse\" | \"solana-devnet\" | \"eclipse-testnet\" | \"unknown\";\n","import { Address, TransactionMessage, TransactionMessageWithFeePayer, TransactionSigner } from \"@solana/kit\";\nimport { address, lamports, prependTransactionMessageInstruction } from \"@solana/kit\";\nimport { getTransferSolInstruction } from \"@solana-program/system\";\n\nimport { type Percentile, TransactionConfig } from \"./config\";\n\nexport async function processJitoTipForTxMessage(\n  message: TransactionMessage & TransactionMessageWithFeePayer,\n  signer: TransactionSigner,\n  config: TransactionConfig,\n) {\n  let jitoTipLamports = BigInt(0);\n  const jito = config.jito;\n\n  if (jito.type === \"exact\") {\n    jitoTipLamports = jito.amountLamports;\n  } else if (jito.type === \"dynamic\") {\n    jitoTipLamports = await recentJitoTip(config);\n  }\n  if (jitoTipLamports > 0) {\n    return prependTransactionMessageInstruction(\n      getTransferSolInstruction({\n        source: signer,\n        destination: getJitoTipAddress(),\n        amount: jitoTipLamports,\n      }),\n      message,\n    );\n  } else {\n    return message;\n  }\n}\n\n// returns recent jito tip in lamports\nexport async function recentJitoTip(config: TransactionConfig) {\n  const response = await fetch(`${config.jitoBlockEngineUrl}/api/v1/bundles/tip_floor`);\n  if (!response.ok) {\n    return BigInt(0);\n  }\n  const data = await response.json().then(res => res[0]);\n\n  const percentileToKey: Record<Percentile | \"50ema\", string> = {\n    \"25\": \"landed_tips_25th_percentile\",\n    \"50\": \"landed_tips_50th_percentile\",\n    \"75\": \"landed_tips_75th_percentile\",\n    \"95\": \"landed_tips_95th_percentile\",\n    \"99\": \"landed_tips_99th_percentile\",\n    \"50ema\": \"ema_landed_tips_50th_percentile\",\n  };\n\n  const key = percentileToKey[config.priorityFee.priorityFeePercentile ?? \"50\"];\n  if (!key || !data[key]) {\n    return BigInt(0);\n  }\n  return lamports(BigInt(Math.floor(Number(data[key]) * 10 ** 9))).valueOf();\n}\n\n// should we add an argument that dictates if we should use cached value in case fetch fails ?\n\n// below is taken from legacy sdk (no need to add the whole library)\n// https://jito-foundation.gitbook.io/mev/mev-payment-and-distribution/on-chain-addresses\nconst jitoTipAddresses = [\n  \"96gYZGLnJYVFmbjzopPSU6QiEV5fGqZNyN9nmNhvrZU5\",\n  \"HFqU5x63VTqvQss8hp11i4wVV8bD44PvwucfZ2bU7gRe\",\n  \"Cw8CFyM9FkoMi7K7Crf6HNQqf4uEMzpKw6QNghXLvLkY\",\n  \"ADaUMid9yfUytqMBgopwjb2DTLSokTSzL1zt6iGPaS49\",\n  \"DfXygSm4jCyNCybVYYK6DwvWqjKee8pbDmJGcLWNDXjh\",\n  \"ADuUkR4vqLUMWXxW9gh6D6L8pMSawimctcNZ5pGwDcEt\",\n  \"DttWaMuVvTiduZRnguLF7jNxTgiMBZ1hyAumKUiL2KRL\",\n  \"3AVi9Tg9Uo68tJfuvoKvqKNWKkC5wPdSSdeBnizKZ6jT\",\n];\n\nfunction getJitoTipAddress(): Address {\n  // just pick a random one from the list. There are multiple addresses so that no single one\n  // can cause local congestion.\n  return address(jitoTipAddresses[Math.floor(Math.random() * jitoTipAddresses.length)]);\n}\n","import {\n  Address,\n  Commitment,\n  getBase58Decoder,\n  getBase64EncodedWireTransaction,\n  Instruction,\n  KeyPairSigner,\n  Rpc,\n  SendableTransaction,\n  Signature,\n  SolanaRpcApi,\n  Transaction,\n  TransactionWithLifetime,\n} from \"@solana/kit\";\n\nimport { buildTransaction } from \"./buildTransaction\";\nimport { DEFAULT_TRANSACTION_CONFIG, TransactionConfig } from \"./config\";\n\n/**\n * Builds and sends a transaction with the given instructions, signers, and commitment level.\n *\n * @param {Rpc<SolanaRpcApi>} rpc - Solana Rpc client.\n * @param {Instruction[]} instructions - Array of instructions to include in the transaction.\n * @param {KeyPairSigner} payer - The fee payer for the transaction.\n * @param {TransactionConfig} config - The transaction config.\n * @param {Address[]} [lookupTableAddresses] - Optional array of address lookup table addresses to use.\n * @param {Commitment} [commitment=\"confirmed\"] - The commitment level for transaction confirmation.\n *\n * @returns {Promise<Signature>} A promise that resolves to the transaction signature.\n *\n * @throws {Error} If transaction building or sending fails.\n *\n * @example\n * ```ts\n * const signature = await sendTransaction(\n *   instructions,\n *   keypairSigner,\n *   DEFAULT_TRANSACTION_CONFIG,\n *   lookupTables,\n *   \"finalized\"\n * );\n * ```\n */\nexport async function sendTransaction(\n  rpc: Rpc<SolanaRpcApi>,\n  instructions: Instruction[],\n  payer: KeyPairSigner,\n  config?: TransactionConfig,\n  lookupTableAddresses?: Address[],\n  commitment: Commitment = \"confirmed\",\n): Promise<Signature> {\n  const tx = await buildTransaction(\n    rpc,\n    config ?? DEFAULT_TRANSACTION_CONFIG,\n    instructions,\n    payer,\n    lookupTableAddresses,\n  );\n  return sendSignedTransaction(rpc, tx, commitment);\n}\n\n/**\n * Sends a signed transaction message to the Solana network with a specified commitment level.\n *\n * @param {Rpc<SolanaRpcApi>} rpc - Rpc client.\n * @param {SendableTransaction & Transaction & TransactionWithLifetime} transaction - The fully signed transaction to send.\n * @param {Commitment} [commitment=\"confirmed\"] - The commitment level for transaction confirmation.\n *\n * @returns {Promise<Signature>} A promise that resolves to the transaction signature.\n *\n * @throws {Error} If transaction sending fails, the RPC connection fails, or the transaction expires.\n *\n * @example\n * ```ts\n * const signature = await sendSignedTransaction(\n *   rpc,\n *   signedTransaction,\n *   \"finalized\"\n * );\n * ```\n */\nexport async function sendSignedTransaction(\n  rpc: Rpc<SolanaRpcApi>,\n  transaction: SendableTransaction & Transaction & TransactionWithLifetime,\n  commitment: Commitment = \"confirmed\",\n): Promise<Signature> {\n  const txSignature = getTxSignature(transaction);\n  const encodedTransaction = getBase64EncodedWireTransaction(transaction);\n\n  // Simulate transaction first\n  const simResult = await rpc\n    .simulateTransaction(encodedTransaction, {\n      encoding: \"base64\",\n    })\n    .send();\n\n  if (simResult.value.err) {\n    throw new Error(`Transaction simulation failed`, { cause: simResult.value });\n  }\n\n  const expiryTime = Date.now() + 60_000;\n\n  while (Date.now() < expiryTime) {\n    await rpc\n      .sendTransaction(encodedTransaction, {\n        maxRetries: BigInt(0),\n        skipPreflight: true,\n        encoding: \"base64\",\n      })\n      .send();\n\n    const { value } = await rpc.getSignatureStatuses([txSignature]).send();\n    const status = value[0];\n    if (status?.confirmationStatus === commitment) {\n      if (status.err) {\n        throw new Error(`Transaction failed`, { cause: status.err });\n      }\n      return txSignature;\n    }\n  }\n\n  throw new Error(\"Transaction expired\");\n}\n\nfunction getTxSignature(transaction: Transaction) {\n  const [signature] = Object.values(transaction.signatures);\n  return getBase58Decoder().decode(signature!) as Signature;\n}\n"],"mappings":"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","names":["prependTransactionMessageInstruction"]}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@unio-aggregator/unio-tx-sender",
+  "description": "A TypeScript package for building and sending Solana transactions with support for priority fees and Jito tips.",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    "import": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "require": {
+      "types": "./dist/index.d.cts",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --sourcemap",
+    "lint": "pnpm eslint && pnpm type-check",
+    "eslint": "eslint \"**/*.ts*\" --fix",
+    "type-check": "tsc -p .",
+    "clean": "rimraf dist"
+  },
+  "dependencies": {
+    "@solana-program/address-lookup-table": "^0.11.0",
+    "@solana-program/compute-budget": "^0.15.0",
+    "@solana-program/system": "^0.11.0",
+    "@solana/kit": "^6.9.0",
+    "@solana/rpc": "^6.9.0",
+    "@solana/rpc-api": "^6.9.0"
+  },
+  "devDependencies": {
+    "@unio-aggregator/prettier-config": "^1.0.1",
+    "@unio-aggregator/typescript-config": "^1.0.1",
+    "@eslint/eslintrc": "^3.3.5",
+    "@eslint/js": "^10.0.1",
+    "@typescript-eslint/eslint-plugin": "^8.62.1",
+    "@typescript-eslint/parser": "^8.62.1",
+    "tsup": "^8.3.5",
+    "typescript": "5.8.3",
+    "rimraf": "^6.1.3",
+    "eslint": "^10.6.0",
+    "eslint-plugin-prettier": "^5.5.6",
+    "eslint-plugin-simple-import-sort": "^13.0.0"
+  }
+}