@hawksightco/hawk-sdk 1.1.39 → 1.1.41-hotfix-1

package/dist/src/classes/Transaction2.d.ts

@@ -0,0 +1,108 @@
+/// <reference types="@meteora-ag/dlmm/node_modules/@solana/web3.js" />
+import * as client from "@hawksightco/swagger-client";
+import * as web3 from "@solana/web3.js";
+import { GeneralUtility } from "./GeneralUtility";
+import { Transaction3, TransactionMetadataResponse } from "./Transaction3";
+export declare const DummyTransactionMetadataResponse: TransactionMetadataResponse;
+/**
+ * Represents a transaction object in Solana using the web3.js library.
+ * This class encapsulates the logic for creating, signing, and verifying signatures of transactions.
+ */
+export declare class Transaction2 extends Transaction3 {
+    readonly txMetadataResponse: TransactionMetadataResponse;
+    readonly payerKey: web3.PublicKey;
+    protected latestBlockhash: {
+        blockhash: string;
+        lastValidBlockHeight: number;
+    };
+    readonly alts: web3.AddressLookupTableAccount[];
+    protected generalUtility: GeneralUtility;
+    /**
+     * Whether transaction has nonce advance instruction
+     */
+    readonly hasNonceAdvanceIx: boolean;
+    /**
+     * Fee estimate that can be overwritten
+     */
+    feeEstimate: number;
+    /**
+     * Constructs a new Transaction object.
+     *
+     * @param payerKey PublicKey of the transaction payer
+     * @param instructions Array of TransactionInstruction to be executed in this transaction
+     * @param recentBlockhash The blockhash of a recent ledger entry
+     * @param alts Address lookup tables that optimize account address storage
+     */
+    private constructor();
+    static new(payerKey: web3.PublicKey, alts: web3.AddressLookupTableAccount[], generalUtility: GeneralUtility, _mainIxs?: web3.TransactionInstruction[], latestBlockhash?: {
+        blockhash: string;
+        lastValidBlockHeight: number;
+    }): Transaction2;
+    /**
+     * Generate nonde advance instruction (dummy instruction)
+     */
+    private nonceAdvanceIx;
+    /**
+     * Get nonce index
+     *
+     * @returns
+     */
+    private getNonceIndex;
+    /**
+     * Signs the transaction with provided signers.
+     *
+     * @param signers Array of Signer objects whose private keys will be used to sign the transaction.
+     * @param idempotent Boolean indicating whether signing should be idempotent (default is false).
+     * @throws Error if a signer is not required or has already signed the transaction when not idempotent.
+     */
+    sign(signers: web3.Signer[], idempotent?: boolean): void;
+    /**
+     * Add a signature on the transaction with provided signature.
+     *
+     * @param publicKey The public key of the signer
+     * @param signature A signature of the signed transaction
+     * @throws Error if a signer is not required or has already signed the transaction.
+     */
+    addSignature(publicKey: web3.PublicKey, signature: Uint8Array): void;
+    /**
+     * Checks if all required signers have signed the transaction.
+     *
+     * @returns Boolean indicating whether all required signers have signed.
+     */
+    isSignedByRequiredSigners(): boolean;
+    /**
+     * Add priority fee instructions (compute budget) with a fixed priority fee.
+     *
+     * This method adds priority fee instructions to the transaction based on a fixed priority fee.
+     *
+     * @param connection - The connection to the Solana cluster.
+     * @param computeUnitLimit - The limit on the number of compute units.
+     * @param fixedPriority - Set to true to indicate a fixed priority fee.
+     * @param fixedPriorityFee - The fixed priority fee in lamports.
+     * @returns An array of transaction instructions.
+     */
+    addPriorityFeeIx(connection: web3.Connection, computeUnitLimit: number, fixedPriority: true, fixedPriorityFee: number): Promise<web3.TransactionInstruction[]>;
+    /**
+     * Add priority fee instructions (compute budget) with a variable priority defined by Helius.
+     *
+     * This method adds priority fee instructions to the transaction based on the specified
+     * priority level and compute unit limit. It ensures that the total fee does not exceed
+     * the specified maximum priority fee (in SOL) if provided.
+     *
+     * @param connection - The connection to the Solana cluster.
+     * @param computeUnitLimit - The limit on the number of compute units.
+     * @param fixedPriority - Set to false to indicate a variable priority fee.
+     * @param priorityLevel - The priority level for the fee estimation.
+     * @param maxPriorityFee - The maximum priority fee in SOL (optional).
+     * @returns An array of transaction instructions.
+     */
+    addPriorityFeeIx(connection: web3.Connection, computeUnitLimit: number, fixedPriority: false, priorityLevel: client.PriorityLevel, maxPriorityFee?: number): Promise<web3.TransactionInstruction[]>;
+    /**
+     * Overwrite blockhash and rebuild transaction
+     *
+     * @param blockhash
+     * @param lastValidBlockHeight
+     */
+    setBlockhash(blockhash: string | null, lastValidBlockHeight: number | null): void;
+}
+//# sourceMappingURL=Transaction2.d.ts.map

package/dist/src/classes/Transaction2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transaction2.d.ts","sourceRoot":"","sources":["../../../src/classes/Transaction2.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,MAAM,MAAM,6BAA6B,CAAC;AACtD,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AAExC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAG3E,eAAO,MAAM,gCAAgC,EAAE,2BAQ9C,CAAC;AAEF;;;GAGG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAqB1C,QAAQ,CAAC,kBAAkB,EAAE,2BAA2B;IACxD,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS;IACjC,SAAS,CAAC,eAAe,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,oBAAoB,EAAE,MAAM,CAAA;KAAE;IAC9E,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,yBAAyB,EAAE;IAC/C,SAAS,CAAC,cAAc,EAAE,cAAc;IAvB1C;;OAEG;IACH,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IAEpC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAK;IAExB;;;;;;;OAOG;IACH,OAAO;IAoBP,MAAM,CAAC,GAAG,CACR,QAAQ,EAAE,IAAI,CAAC,SAAS,EACxB,IAAI,EAAE,IAAI,CAAC,yBAAyB,EAAE,EACtC,cAAc,EAAE,cAAc,EAC9B,QAAQ,GAAE,IAAI,CAAC,sBAAsB,EAAO,EAC5C,eAAe,GAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,oBAAoB,EAAE,MAAM,CAAA;KAA+C;IAanH;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAWrB;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,UAAU,GAAE,OAAe,GAAG,IAAI;IAuB/D;;;;;;OAMG;IACH,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,GAAG,IAAI;IAcpE;;;;OAIG;IACH,yBAAyB,IAAI,OAAO;IAIpC;;;;;;;;;;OAUG;IACG,gBAAgB,CACpB,UAAU,EAAE,IAAI,CAAC,UAAU,EAC3B,gBAAgB,EAAE,MAAM,EACxB,aAAa,EAAE,IAAI,EACnB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC;IAEzC;;;;;;;;;;;;;OAaG;IACG,gBAAgB,CACpB,UAAU,EAAE,IAAI,CAAC,UAAU,EAC3B,gBAAgB,EAAE,MAAM,EACxB,aAAa,EAAE,KAAK,EACpB,aAAa,EAAE,MAAM,CAAC,aAAa,EACnC,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC;IA4EzC;;;;;OAKG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,oBAAoB,EAAE,MAAM,GAAG,IAAI;CAY3E"}

package/dist/src/classes/Transaction2.js

@@ -0,0 +1,239 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Transaction2 = exports.DummyTransactionMetadataResponse = void 0;
+const client = __importStar(require("@hawksightco/swagger-client"));
+const web3 = __importStar(require("@solana/web3.js"));
+const bn_js_1 = require("bn.js");
+const Transaction3_1 = require("./Transaction3");
+const Logging_1 = require("./Logging");
+exports.DummyTransactionMetadataResponse = {
+    description: '',
+    estimatedFeeInSOL: '',
+    addressLookupTableAddresses: [], // "alts" is confusing, copied jup's naming
+    computeBudgetInstructions: [], // this enables for ease of access while also making them optional
+    mainInstructions: [],
+    payer: '',
+    signature: '',
+};
+/**
+ * Represents a transaction object in Solana using the web3.js library.
+ * This class encapsulates the logic for creating, signing, and verifying signatures of transactions.
+ */
+class Transaction2 extends Transaction3_1.Transaction3 {
+    /**
+     * Constructs a new Transaction object.
+     *
+     * @param payerKey PublicKey of the transaction payer
+     * @param instructions Array of TransactionInstruction to be executed in this transaction
+     * @param recentBlockhash The blockhash of a recent ledger entry
+     * @param alts Address lookup tables that optimize account address storage
+     */
+    constructor(txMetadataResponse, payerKey, latestBlockhash, alts, generalUtility, _mainIxs = []) {
+        super(txMetadataResponse, payerKey, latestBlockhash, alts, generalUtility, _mainIxs);
+        this.txMetadataResponse = txMetadataResponse;
+        this.payerKey = payerKey;
+        this.latestBlockhash = latestBlockhash;
+        this.alts = alts;
+        this.generalUtility = generalUtility;
+        /**
+         * Fee estimate that can be overwritten
+         */
+        this.feeEstimate = 0;
+        const index = this.getNonceIndex();
+        this.hasNonceAdvanceIx = index > -1;
+    }
+    ;
+    static new(payerKey, alts, generalUtility, _mainIxs = [], latestBlockhash = { blockhash: '', lastValidBlockHeight: 0 }) {
+        const instance = new Transaction2(exports.DummyTransactionMetadataResponse, payerKey, latestBlockhash, alts, generalUtility, _mainIxs);
+        return instance;
+    }
+    /**
+     * Generate nonde advance instruction (dummy instruction)
+     */
+    nonceAdvanceIx(noncePubkey) {
+        // Generate dummy nonce ix
+        return web3.SystemProgram.nonceAdvance({
+            /** Nonce account */
+            noncePubkey,
+            /** Public key of the nonce authority */
+            authorizedPubkey: this.payerKey,
+        });
+    }
+    /**
+     * Get nonce index
+     *
+     * @returns
+     */
+    getNonceIndex() {
+        const referenceIx = this.nonceAdvanceIx(web3.Keypair.generate().publicKey);
+        const index = this._instructions.findIndex(ix => {
+            const isNonceAdvanceIx = ix.data.toString("base64") == referenceIx.data.toString("base64") &&
+                ix.programId.toString() == referenceIx.programId.toString();
+            return isNonceAdvanceIx;
+        });
+        return index;
+    }
+    /**
+     * Signs the transaction with provided signers.
+     *
+     * @param signers Array of Signer objects whose private keys will be used to sign the transaction.
+     * @param idempotent Boolean indicating whether signing should be idempotent (default is false).
+     * @throws Error if a signer is not required or has already signed the transaction when not idempotent.
+     */
+    sign(signers, idempotent = false) {
+        // First validate all signers
+        signers.forEach((signer) => {
+            const key = signer.publicKey.toString();
+            if (typeof this.requiredSigners[key] !== "boolean") {
+                throw new Error(`Key ${key} is not a required signer!`);
+            }
+            if (!idempotent && this.requiredSigners[key]) {
+                throw new Error(`Key ${key} has already been signed by required signer!`);
+            }
+        });
+        // If all signers are valid and the process is idempotent or they haven't signed yet, update and sign
+        signers.forEach((signer) => {
+            const key = signer.publicKey.toString();
+            this.requiredSigners[key] = true;
+        });
+        this.versionedTransaction.sign(signers);
+    }
+    /**
+     * Add a signature on the transaction with provided signature.
+     *
+     * @param publicKey The public key of the signer
+     * @param signature A signature of the signed transaction
+     * @throws Error if a signer is not required or has already signed the transaction.
+     */
+    addSignature(publicKey, signature) {
+        const key = publicKey.toBase58();
+        if (typeof this.requiredSigners[key] !== "boolean") {
+            throw new Error(`Key ${key} is not a required signer!`);
+        }
+        if (this.requiredSigners[key]) {
+            throw new Error(`Key ${key} has already been signed by required signer!`);
+        }
+        this.requiredSigners[key] = true;
+        this.versionedTransaction.addSignature(publicKey, signature);
+    }
+    /**
+     * Checks if all required signers have signed the transaction.
+     *
+     * @returns Boolean indicating whether all required signers have signed.
+     */
+    isSignedByRequiredSigners() {
+        return Object.values(this.requiredSigners).every((isSigned) => isSigned);
+    }
+    /**
+     * Add priority fee instructions (compute budget)
+     *
+     * This method adds priority fee instructions to the transaction based on the specified
+     * priority level and compute unit limit. It ensures that the total fee does not exceed
+     * the specified maximum priority fee (in SOL) if provided.
+     *
+     * @param connection - The connection to the Solana cluster.
+     * @param computeUnitLimit - The limit on the number of compute units.
+     * @param fixedPriority - If true, a fixed priority fee is used; if false, the fee is based on priority level.
+     * @param priorityLevelOrPriorityFee - The priority level for the fee estimation or the fixed priority fee.
+     * @param maxPriorityFee - The maximum priority fee in SOL (optional, only applicable when fixedPriority is false).
+     * @returns An array of transaction instructions.
+     */
+    addPriorityFeeIx(connection_1, computeUnitLimit_1) {
+        return __awaiter(this, arguments, void 0, function* (connection, computeUnitLimit, fixedPriority = false, priorityLevelOrPriorityFee, maxPriorityFee) {
+            (0, Logging_1.Log)(`addPriorityFeeIx`);
+            // First, remove any existing priority fee instructions
+            this.removePriorityFeeIxs();
+            let totalPriorityFeeLamports;
+            if (fixedPriority && typeof priorityLevelOrPriorityFee === 'number') {
+                // For fixed priority, directly use the provided fixed priority fee
+                totalPriorityFeeLamports = priorityLevelOrPriorityFee - 5000;
+            }
+            else if (typeof priorityLevelOrPriorityFee === 'string') {
+                // Convert maxPriorityFee from SOL to lamports (1 SOL = 1_000_000_000 lamports)
+                const maxPriorityFeeLamports = maxPriorityFee !== undefined ? maxPriorityFee * 1000000000 : undefined;
+                // Get fee estimate by simulating the transaction
+                let estimate = this.feeEstimate;
+                // If priority is set to default or medium, we multiply estimate by 2 to increase its chance on blockchain.
+                if (priorityLevelOrPriorityFee === client.PriorityLevel.Default || priorityLevelOrPriorityFee === client.PriorityLevel.Medium) {
+                    estimate = estimate * 2;
+                }
+                // Calculate the total fee in lamports
+                totalPriorityFeeLamports = new bn_js_1.BN(estimate).mul(new bn_js_1.BN(computeUnitLimit)).div(new bn_js_1.BN(1000000)).toNumber();
+                // If maxPriorityFee is defined and it is less than the total calculated fee, cap it
+                if (maxPriorityFeeLamports !== undefined && totalPriorityFeeLamports > maxPriorityFeeLamports) {
+                    totalPriorityFeeLamports = maxPriorityFeeLamports - 5000;
+                }
+            }
+            else {
+                throw new Error('Invalid parameters');
+            }
+            // Convert the total priority fee back to microLamports per compute unit
+            const priorityFeePerUnitMicroLamports = new bn_js_1.BN(totalPriorityFeeLamports).mul(new bn_js_1.BN(1000000)).div(new bn_js_1.BN(computeUnitLimit)).toNumber();
+            // Create priority fee instructions for the transaction
+            const priorityFeeIxs = [
+                web3.ComputeBudgetProgram.setComputeUnitLimit({
+                    units: computeUnitLimit,
+                }),
+                web3.ComputeBudgetProgram.setComputeUnitPrice({
+                    microLamports: priorityFeePerUnitMicroLamports,
+                }),
+            ];
+            // Store the total priority fee in lamports
+            this._priorityFeeEstimate = totalPriorityFeeLamports.toString();
+            // Append priority fee instructions at the beginning
+            this._instructions.unshift(...priorityFeeIxs);
+            return priorityFeeIxs;
+        });
+    }
+    /**
+     * Overwrite blockhash and rebuild transaction
+     *
+     * @param blockhash
+     * @param lastValidBlockHeight
+     */
+    setBlockhash(blockhash, lastValidBlockHeight) {
+        if (blockhash !== null) {
+            this.latestBlockhash.blockhash = blockhash;
+        }
+        if (lastValidBlockHeight !== null) {
+            this.latestBlockhash.lastValidBlockHeight = lastValidBlockHeight;
+        }
+        this.buildTransaction({
+            blockhash: this.latestBlockhash.blockhash,
+            lastValidBlockHeight: this.latestBlockhash.lastValidBlockHeight
+        });
+    }
+}
+exports.Transaction2 = Transaction2;

package/dist/src/classes/Transaction3.d.ts

@@ -0,0 +1,166 @@
+/// <reference types="@meteora-ag/dlmm/node_modules/@solana/web3.js" />
+import * as client from "@hawksightco/swagger-client";
+import * as web3 from "@solana/web3.js";
+import { GeneralUtility } from "./GeneralUtility";
+export type SimulatedTransactionResponse = {
+    err: web3.TransactionError | string | null;
+    logs: Array<string> | null;
+    accounts?: (web3.SimulatedTransactionAccountInfo | null)[] | null;
+    unitsConsumed: number;
+    returnData?: web3.TransactionReturnData | null;
+};
+export type TransactionMetadataResponse = {
+    description: string;
+    estimatedFeeInSOL: string;
+    addressLookupTableAddresses: string[];
+    computeBudgetInstructions: Instruction[];
+    mainInstructions: Instruction[];
+    payer: string;
+    signature: string;
+};
+export type Instruction = {
+    accounts: {
+        isSigner: boolean;
+        isWritable: boolean;
+        pubkey: string;
+    }[];
+    data: string;
+    programId: string;
+};
+/**
+ * Represents a transaction object in Solana using the web3.js library.
+ * This class encapsulates the logic for creating, signing, and verifying signatures of transactions.
+ */
+export declare class Transaction3 {
+    readonly txMetadataResponse: TransactionMetadataResponse;
+    readonly payerKey: web3.PublicKey;
+    protected latestBlockhash: {
+        blockhash: string;
+        lastValidBlockHeight: number;
+    };
+    readonly alts: web3.AddressLookupTableAccount[];
+    protected generalUtility: GeneralUtility;
+    /** Compiled TransactionMessage which includes payer, instructions, and recent blockhash */
+    protected _txMessage: web3.TransactionMessage;
+    get txMessage(): web3.TransactionMessage;
+    /** Versioned transaction built from the transaction message */
+    protected _versionedTransaction: web3.VersionedTransaction;
+    get versionedTransaction(): web3.VersionedTransaction;
+    /** A map indicating whether each required signer has signed the transaction */
+    readonly requiredSigners: Record<string, boolean>;
+    /** Estimated fee in SOL for priority fee when addPriorityFee() method is called. */
+    protected _priorityFeeEstimate: string;
+    get priorityFeeEstimate(): string;
+    /** The blockhash of a recent ledger entry */
+    get recentBlockhash(): string;
+    /** Array of TransactionInstruction to be executed in this transaction */
+    protected _instructions: web3.TransactionInstruction[];
+    get instructions(): web3.TransactionInstruction[];
+    /** last valid block height */
+    get lastValidBlockHeight(): number;
+    /**
+     * Constructs a new Transaction object.
+     *
+     * @param payerKey PublicKey of the transaction payer
+     * @param instructions Array of TransactionInstruction to be executed in this transaction
+     * @param recentBlockhash The blockhash of a recent ledger entry
+     * @param alts Address lookup tables that optimize account address storage
+     */
+    constructor(txMetadataResponse: TransactionMetadataResponse, payerKey: web3.PublicKey, latestBlockhash: {
+        blockhash: string;
+        lastValidBlockHeight: number;
+    }, alts: web3.AddressLookupTableAccount[], generalUtility: GeneralUtility, _mainIxs?: web3.TransactionInstruction[]);
+    /**
+     * Signs the transaction with provided signers.
+     *
+     * @param signers Array of Signer objects whose private keys will be used to sign the transaction.
+     * @param idempotent Boolean indicating whether signing should be idempotent (default is false).
+     * @throws Error if a signer is not required or has already signed the transaction when not idempotent.
+     */
+    sign(signers: web3.Signer[], idempotent?: boolean): void;
+    /**
+     * Add a signature on the transaction with provided signature.
+     *
+     * @param publicKey The public key of the signer
+     * @param signature A signature of the signed transaction
+     * @throws Error if a signer is not required or has already signed the transaction.
+     */
+    addSignature(publicKey: web3.PublicKey, signature: Uint8Array): void;
+    /**
+     * Checks if all required signers have signed the transaction.
+     *
+     * @returns Boolean indicating whether all required signers have signed.
+     */
+    isSignedByRequiredSigners(): boolean;
+    /**
+     * Add priority fee instructions (compute budget) with a fixed priority fee.
+     *
+     * This method adds priority fee instructions to the transaction based on a fixed priority fee.
+     *
+     * @param connection - The connection to the Solana cluster.
+     * @param computeUnitLimit - The limit on the number of compute units.
+     * @param fixedPriority - Set to true to indicate a fixed priority fee.
+     * @param fixedPriorityFee - The fixed priority fee in lamports.
+     * @returns An array of transaction instructions.
+     */
+    addPriorityFeeIx(connection: web3.Connection, computeUnitLimit: number, fixedPriority: true, fixedPriorityFee: number): Promise<web3.TransactionInstruction[]>;
+    /**
+     * Add priority fee instructions (compute budget) with a variable priority defined by Helius.
+     *
+     * This method adds priority fee instructions to the transaction based on the specified
+     * priority level and compute unit limit. It ensures that the total fee does not exceed
+     * the specified maximum priority fee (in SOL) if provided.
+     *
+     * @param connection - The connection to the Solana cluster.
+     * @param computeUnitLimit - The limit on the number of compute units.
+     * @param fixedPriority - Set to false to indicate a variable priority fee.
+     * @param priorityLevel - The priority level for the fee estimation.
+     * @param maxPriorityFee - The maximum priority fee in SOL (optional).
+     * @returns An array of transaction instructions.
+     */
+    addPriorityFeeIx(connection: web3.Connection, computeUnitLimit: number, fixedPriority: false, priorityLevel: client.PriorityLevel, maxPriorityFee?: number): Promise<web3.TransactionInstruction[]>;
+    /**
+     * Gets the compute unit limit from a transaction simulation.
+     *
+     * This function simulates a transaction and calculates the compute unit limit
+     * based on the simulation results. If an additional compute limit is provided,
+     * it is added to the units consumed in the simulation. Otherwise, the units
+     * consumed are increased by 10%.
+     *
+     * @param {web3.Connection} connection - The connection object to the Solana cluster.
+     * @param {number} [additionalComputeLimit] - Optional additional compute limit to add to the units consumed.
+     * @returns {Promise<number>} - A promise that resolves to the total compute unit limit.
+     * @throws {Error} - Throws an error if the transaction simulation fails.
+     */
+    getComputeUnitLimit(connection: web3.Connection, additionalComputeLimit?: number): Promise<number>;
+    /**
+     * Simulate transaction
+     *
+     * @param connection
+     * @returns
+     */
+    simulateTransaction(connection: web3.Connection, signers?: web3.Keypair[]): Promise<SimulatedTransactionResponse>;
+    /**
+     * Builds transaction object
+     */
+    buildTransaction(latestBlockhash: web3.BlockhashWithExpiryBlockHeight): [web3.TransactionMessage, web3.VersionedTransaction];
+    /**
+     * Gathers the public keys of all parties required to sign the transaction.
+     *
+     * @returns A record of signer public keys mapped to a boolean indicating whether they have signed.
+     */
+    protected getRequiredSigners(): Record<string, boolean>;
+    /**
+     * Find setComputeUnitLimit index within the instructions
+     */
+    protected findSetComputeUnitLimitIndex(instructions?: web3.TransactionInstruction[]): number;
+    /**
+     * Find setComputeUnitPrice index within the instructions
+     */
+    protected findSetComputeUnitPriceIndex(instructions?: web3.TransactionInstruction[]): number;
+    /**
+     * Remove priority fee instructions
+     */
+    protected removePriorityFeeIxs(): void;
+}
+//# sourceMappingURL=Transaction3.d.ts.map

package/dist/src/classes/Transaction3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transaction3.d.ts","sourceRoot":"","sources":["../../../src/classes/Transaction3.ts"],"names":[],"mappings":"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"}