@symmetry-hq/temp-v3-sdk 0.0.39 → 0.0.41

package/dist/src/index.js

@@ -37,12 +37,21 @@ const fraction_1 = require("./layouts/fraction");
 const intent_1 = require("./layouts/intents/intent");
 Object.defineProperty(exports, "TaskType", { enumerable: true, get: function () { return intent_1.TaskType; } });
 const rebalanceIntent_2 = require("./layouts/intents/rebalanceIntent");
+const oracle_1 = require("./layouts/oracle");
 const basket_1 = require("./states/basket");
 const config_1 = require("./states/config");
 const intent_2 = require("./states/intents/intent");
 const rebalanceIntent_3 = require("./states/intents/rebalanceIntent");
+const pythOracle_1 = require("./states/oracles/pythOracle");
 const txUtils_1 = require("./txUtils");
 class SymmetryCore {
+    /**
+     * Initializes the SymmetryCore SDK.
+     * @param params {connection: Connection, network: "devnet" | "mainnet", priorityFee?: number} - The parameters for the SDK.
+     * @param params.connection - The connection to the Solana network.
+     * @param params.network - The network to use (devnet or mainnet).
+     * @param params.priorityFee - Optional. The priority fee to use for the transactions. Defaults to PRIORITY_FEE.
+    */
     constructor(params) {
         var _a;
         this.sdkParams = {
@@ -51,41 +60,82 @@ class SymmetryCore {
             priorityFee: (_a = params.priorityFee) !== null && _a !== void 0 ? _a : constants_1.PRIORITY_FEE,
         };
     }
+    /**
+     * Fetches the global config account.
+     * @returns {Promise<GlobalConfig>} The global config.
+    */
     fetchGlobalConfig() {
         return __awaiter(this, void 0, void 0, function* () {
             return yield (0, config_1.fetchGlobalConfig)(this.sdkParams.connection);
         });
     }
+    /**
+     * Fetches a basket by its public key.
+     * @param {string} basketPubkey - The public key of the basket.
+     * @returns {Promise<Basket>} The basket.
+    */
     fetchBasket(basketPubkey) {
         return __awaiter(this, void 0, void 0, function* () {
             return yield (0, basket_1.fetchBasket)(this.sdkParams.connection, new web3_js_1.PublicKey(basketPubkey));
         });
     }
+    /**
+     * Fetches multiple baskets by their public keys.
+     * @param {string[]} basketPubkeys - The public keys of the baskets.
+     * @returns {Promise<Map<string, Basket>>} A map of basket public keys to baskets.
+    */
     fetchMultipleBaskets(basketPubkeys) {
         return __awaiter(this, void 0, void 0, function* () {
             return yield (0, basket_1.fetchBaskektsMultiple)(this.sdkParams.connection, basketPubkeys.map(key => new web3_js_1.PublicKey(key)));
         });
     }
+    /**
+     * Fetches all baskets.
+     * @param {BasketFilter} basketFilter - Optional. The filter to apply to the baskets.
+     * @param {"creator" | "host" | "manager"} basketFilter.type - The type of the basket filter ("creator", "host", "manager").
+     * @param {string} basketFilter.pubkey - The public key of the basket filter.
+     * @returns {Promise<Basket[]>} The baskets.
+    */
     fetchAllBaskets(basketFilter) {
         return __awaiter(this, void 0, void 0, function* () {
             return yield (0, basket_1.fetchBaskets)(this.sdkParams.connection, basketFilter);
         });
     }
+    /**
+     * Fetches all baskets created by a given public key.
+     * @param {string} creatorPubkey - The public key of the creator.
+     * @returns {Promise<Basket[]>} The baskets.
+    */
     fetchCreatedBaskets(creatorPubkey) {
         return __awaiter(this, void 0, void 0, function* () {
             return yield (0, basket_1.fetchBaskets)(this.sdkParams.connection, { type: "creator", pubkey: creatorPubkey });
         });
     }
+    /**
+     * Fetches all baskets hosted by a given public key.
+     * @param {string} hostPubkey - The public key of the host.
+     * @returns {Promise<Basket[]>} The baskets.
+    */
     fetchHostedBaskets(hostPubkey) {
         return __awaiter(this, void 0, void 0, function* () {
             return yield (0, basket_1.fetchBaskets)(this.sdkParams.connection, { type: "host", pubkey: hostPubkey });
         });
     }
+    /**
+     * Fetches all baskets managed by a given public key.
+     * @param {string} managerPubkey - The public key of the manager.
+     * @returns {Promise<Basket[]>} The baskets.
+    */
     fetchManagedBaskets(managerPubkey) {
         return __awaiter(this, void 0, void 0, function* () {
             return yield (0, basket_1.fetchBaskets)(this.sdkParams.connection, { type: "manager", pubkey: managerPubkey });
         });
     }
+    /**
+     * Derives baskets by their mints.
+     * @param {string[]} mints - The mint public keys of the baskets.
+     * @returns {Promise<Map<string, string>>} A map of basket mint public keys to basket public keys.
+    */
     deriveBasketsByMints(mints) {
         return __awaiter(this, void 0, void 0, function* () {
             let result = new Map();
@@ -98,6 +148,11 @@ class SymmetryCore {
             return result;
         });
     }
+    /**
+     * Fetches baskets by their mint public keys.
+     * @param {string[]} mints - The mint public keys of the baskets.
+     * @returns {Promise<Map<string, Basket>>} A map of basket mint public keys to baskets.
+    */
     fetchBasketsFromMints(mints) {
         return __awaiter(this, void 0, void 0, function* () {
             let basketPubkeys = mints.map(mint => {
@@ -118,56 +173,115 @@ class SymmetryCore {
             return mintsMap;
         });
     }
+    /**
+     * Loads the price of a basket.
+     * @param {Basket} basket - The basket.
+     * @returns {Promise<Basket>} The basket with the price.
+    */
     loadBasketPrice(basket) {
         return __awaiter(this, void 0, void 0, function* () {
             return yield (0, basket_1.loadBasketPrice)(basket, this.sdkParams.connection);
         });
     }
+    /**
+     * Fetches an intent by its public key.
+     * @param {string} intentPubkey - The public key of the intent.
+     * @returns {Promise<Intent>} The intent.
+    */
     fetchIntent(intentPubkey) {
         return __awaiter(this, void 0, void 0, function* () {
             return yield (0, intent_2.fetchIntent)(this.sdkParams.connection, new web3_js_1.PublicKey(intentPubkey));
         });
     }
+    /**
+     * Fetches multiple intents by their public keys.
+     * @param {string[]} intentPubkeys - The public keys of the intents.
+     * @returns {Promise<Map<string, Intent>>} A map of intent public keys to intents.
+    */
     fetchMultipleIntents(intentPubkeys) {
         return __awaiter(this, void 0, void 0, function* () {
             return yield (0, intent_2.fetchIntentsMultiple)(this.sdkParams.connection, intentPubkeys.map(key => new web3_js_1.PublicKey(key)));
         });
     }
+    /**
+     * Fetches all intents.
+     * @param {IntentFilter} filter - Optional. The filter to apply to the intents.
+     * @param {"creator" | "host" | "manager" | "basket" | "owner"} filter.type - The type of the intent filter ("creator", "host", "manager", "basket", "owner").
+     * @param {string} filter.pubkey - The public key of the intent filter.
+     * @returns {Promise<Intent[]>} The intents.
+    */
     fetchAllIntents(filter) {
         return __awaiter(this, void 0, void 0, function* () {
             return yield (0, intent_2.fetchIntents)(this.sdkParams.connection, filter);
         });
     }
+    /**
+     * Fetches all intents created by a given public key.
+     * @param {string} creatorPubkey - The public key of the creator.
+     * @returns {Promise<Intent[]>} The intents.
+    */
     fetchCreatedIntents(creatorPubkey) {
         return __awaiter(this, void 0, void 0, function* () {
             return yield (0, intent_2.fetchIntents)(this.sdkParams.connection, { type: "manager", pubkey: creatorPubkey });
         });
     }
+    /**
+     * Fetches all intents for a given basket.
+     * @param {string} basketPubkey - The public key of the basket.
+     * @returns {Promise<Intent[]>} The intents.
+    */
     fetchBasketIntents(basketPubkey) {
         return __awaiter(this, void 0, void 0, function* () {
             return yield (0, intent_2.fetchIntents)(this.sdkParams.connection, { type: "basket", pubkey: basketPubkey });
         });
     }
+    /**
+     * Fetches a rebalance intent by its public key.
+     * @param {string} rebalanceIntentPubkey - The public key of the rebalance intent.
+     * @returns {Promise<RebalanceIntent>} The rebalance intent.
+    */
     fetchRebalanceIntent(rebalanceIntentPubkey) {
         return __awaiter(this, void 0, void 0, function* () {
             return yield (0, rebalanceIntent_3.fetchRebalanceIntent)(this.sdkParams.connection, new web3_js_1.PublicKey(rebalanceIntentPubkey));
         });
     }
+    /**
+     * Fetches multiple rebalance intents by their public keys.
+     * @param {string[]} rebalanceIntentPubkeys - The public keys of the rebalance intents.
+     * @returns {Promise<Map<string, RebalanceIntent>>} A map of rebalance intent public keys to rebalance intents.
+    */
     fetchMultipleRebalanceIntents(rebalanceIntentPubkeys) {
         return __awaiter(this, void 0, void 0, function* () {
             return yield (0, rebalanceIntent_3.fetchRebalanceIntentsMultiple)(this.sdkParams.connection, rebalanceIntentPubkeys.map(key => new web3_js_1.PublicKey(key)));
         });
     }
+    /**
+     * Fetches all rebalance intents.
+     * @param {RebalanceIntentFilter} filter - Optional. The filter to apply to the rebalance intents.
+     * @param {"owner" | "basket"} filter.type - The type of the rebalance intent filter ("owner", "basket").
+     * @param {string} filter.pubkey - The public key of the rebalance intent filter.
+     * @returns {Promise<RebalanceIntent[]>} The rebalance intents.
+    */
     fetchAllRebalanceIntents(filter) {
         return __awaiter(this, void 0, void 0, function* () {
             return yield (0, rebalanceIntent_3.fetchRebalanceIntents)(this.sdkParams.connection, filter);
         });
     }
+    /**
+     * Fetches all rebalance intents for a given owner.
+     * @param {string} ownerPubkey - The public key of the owner.
+     * @returns {Promise<RebalanceIntent[]>} The rebalance intents.
+    */
     fetchOwnerRebalanceIntents(ownerPubkey) {
         return __awaiter(this, void 0, void 0, function* () {
             return yield (0, rebalanceIntent_3.fetchRebalanceIntents)(this.sdkParams.connection, { type: "owner", pubkey: ownerPubkey });
         });
     }
+    /**
+     * Fetches all rebalance intents for a given basket.
+     * @param {string} basketPubkey - The public key of the basket.
+     * @returns {Promise<RebalanceIntent[]>} The rebalance intents.
+    */
     fetchBasketRebalanceIntents(basketPubkey) {
         return __awaiter(this, void 0, void 0, function* () {
             return yield (0, rebalanceIntent_3.fetchRebalanceIntents)(this.sdkParams.connection, { type: "basket", pubkey: basketPubkey });
@@ -207,6 +321,22 @@ class SymmetryCore {
             return txPayloadBatchSequence;
         });
     }
+    /**
+     * Creates a basket.
+     * @param {Object} params - The parameters for the basket creation.
+     * @param {string} params.creator - The public key of the creator.
+     * @param {string} params.start_price - The start price of the basket.
+     * @param {string} params.name - The name of the basket.
+     * @param {string} params.symbol - The symbol of the basket.
+     * @param {string} params.metadata_uri - The metadata URI of the basket.
+     * @param {Object} params.host_platform_params - Optional. The host platform parameters.
+     * @param {string} params.host_platform_params.host_pubkey - The public key of the host.
+     * @param {number} params.host_platform_params.host_deposit_fee_bps - The host deposit fee in basis points.
+     * @param {number} params.host_platform_params.host_withdraw_fee_bps - The host withdrawal fee in basis points.
+     * @param {number} params.host_platform_params.host_management_fee_bps - The host management fee in basis points.
+     * @param {number} params.host_platform_params.host_performance_fee_bps - The host performance fee in basis points.
+     * @returns {Promise<BasketCreationTx>} The basket creation transaction.
+    */
     createBasketTx(params) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
@@ -266,86 +396,194 @@ class SymmetryCore {
             };
         });
     }
+    /**
+     * Changes the creator of a basket.
+     * @param {TaskContext} context - The context of the task.
+     * @param {EditCreatorSettings} settings - The settings for the creator edit.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+    */
     editCreatorTx(context, settings) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.openBasketIntentTx({ type: intent_1.TaskType.EditCreator, context, settings });
         });
     }
+    /**
+     * Creates an edit manager settings intent for a basket.
+     * @param {TaskContext} context - The context of the task.
+     * @param {EditManagerSettings} settings - The settings for the manager edit.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+    */
     editManagersTx(context, settings) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.openBasketIntentTx({ type: intent_1.TaskType.EditManagerSettings, context, settings });
         });
     }
+    /**
+     * Creates an edit schedule settings intent for a basket.
+     * @param {TaskContext} context - The context of the task.
+     * @param {EditScheduleSettings} settings - The settings for the schedule edit.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+    */
     editScheduleTx(context, settings) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.openBasketIntentTx({ type: intent_1.TaskType.EditScheduleSettings, context, settings });
         });
     }
+    /**
+     * Creates an edit fees settings intent for a basket.
+     * @param {TaskContext} context - The context of the task.
+     * @param {EditFeeSettings} settings - The settings for the fee edit.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+    */
     editFeesTx(context, settings) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.openBasketIntentTx({ type: intent_1.TaskType.EditFeeSettings, context, settings });
         });
     }
+    /**
+     * Creates an edit automation settings intent for a basket.
+     * @param {TaskContext} context - The context of the task.
+     * @param {EditAutomationSettings} settings - The settings for the automation edit.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+    */
     editAutomationTx(context, settings) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.openBasketIntentTx({ type: intent_1.TaskType.EditAutomationSettings, context, settings });
         });
     }
+    /**
+     * Creates an edit LP settings intent for a basket.
+     * @param {TaskContext} context - The context of the task.
+     * @param {EditLpSettings} settings - The settings for the LP edit.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+    */
     editLpTx(context, settings) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.openBasketIntentTx({ type: intent_1.TaskType.EditLpSettings, context, settings });
         });
     }
+    /**
+     * Creates an edit metadata settings intent for a basket.
+     * @param {TaskContext} context - The context of the task.
+     * @param {EditMetadataSettings} settings - The settings for the metadata edit.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+    */
     editMetadataTx(context, settings) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.openBasketIntentTx({ type: intent_1.TaskType.EditMetadataSettings, context, settings });
         });
     }
+    /**
+     * Creates an edit deposits settings intent for a basket.
+     * @param {TaskContext} context - The context of the task.
+     * @param {EditDepositsSettings} settings - The settings for the deposits edit.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+    */
     editDepositsTx(context, settings) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.openBasketIntentTx({ type: intent_1.TaskType.EditDepositsSettings, context, settings });
         });
     }
+    /**
+     * Creates an edit force rebalance settings intent for a basket.
+     * @param {TaskContext} context - The context of the task.
+     * @param {EditForceRebalanceSettings} settings - The settings for the force rebalance edit.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+    */
     editForceRebalanceTx(context, settings) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.openBasketIntentTx({ type: intent_1.TaskType.EditForceRebalanceSettings, context, settings });
         });
     }
+    /**
+     * Creates an edit custom rebalance settings intent for a basket.
+     * @param {TaskContext} context - The context of the task.
+     * @param {EditCustomRebalanceSettings} settings - The settings for the custom rebalance edit.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+    */
     editCustomRebalanceTx(context, settings) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.openBasketIntentTx({ type: intent_1.TaskType.EditCustomRebalanceSettings, context, settings });
         });
     }
+    /**
+     * Creates an edit add token delay intent for a basket.
+     * @param {TaskContext} context - The context of the task.
+     * @param {EditAddTokenSettings} settings - The settings for the add token delay edit.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+    */
     editAddTokenDelayTx(context, settings) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.openBasketIntentTx({ type: intent_1.TaskType.EditAddTokenDelay, context, settings });
         });
     }
+    /**
+     * Creates an edit update weights delay intent for a basket.
+     * @param {TaskContext} context - The context of the task.
+     * @param {EditUpdateWeightsSettings} settings - The settings for the update weights delay edit.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+    */
     editUpdateWeightsDelayTx(context, settings) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.openBasketIntentTx({ type: intent_1.TaskType.EditUpdateWeightsDelay, context, settings });
         });
     }
+    /**
+     * Creates an edit swap delay intent for a basket.
+     * @param {TaskContext} context - The context of the task.
+     * @param {EditMakeDirectSwapSettings} settings - The settings for the make direct swap delay edit.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+    */
     editSwapDelayTx(context, settings) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.openBasketIntentTx({ type: intent_1.TaskType.EditMakeDirectSwapDelay, context, settings });
         });
     }
+    /**
+     * Creates an add or edit token intent for a basket.
+     * @param {TaskContext} context - The context of the task.
+     * @param {AddOrEditTokenInput} settings - The settings for the add or edit token.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+    */
     addOrEditTokenTx(context, settings) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.openBasketIntentTx({ type: intent_1.TaskType.AddToken, context, settings });
         });
     }
+    /**
+     * Creates a update weights intent for a basket.
+     * @param {TaskContext} context - The context of the task.
+     * @param {UpdateWeightsInput} settings - The settings for the update weights.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+    */
     updateWeightsTx(context, settings) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.openBasketIntentTx({ type: intent_1.TaskType.UpdateWeights, context, settings });
         });
     }
+    /**
+     * Creates a direct swap intent for a basket.
+     * @param {TaskContext} context - The context of the task.
+     * @param {MakeDirectSwapInput} settings - The settings for the make direct swap.
+     * @param {TransactionInstruction} jup_swap_ix - Optional. The JUP swap instruction.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+    */
     makeDirectSwapTx(context, settings, jup_swap_ix) {
         return __awaiter(this, void 0, void 0, function* () {
             return this.openBasketIntentTx({ type: intent_1.TaskType.MakeDirectSwap, context, settings, jup_swap_ix: jup_swap_ix });
         });
     }
+    /**
+     * Creates basket intent account.
+     * @param {Object} params - The parameters for the basket intent.
+     * @param {TaskContext} params.context - The context of the task.
+     * @param {TaskType} params.type - The type of the task.
+     * @param {Settings} params.settings - The settings for the task.
+     * @param {number} params.min_bounty_per_task - Optional. The minimum bounty per task.
+     * @param {number} params.max_bounty_per_task - Optional. The maximum bounty per task.
+     * @param {TransactionInstruction} params.jup_swap_ix - Optional. The JUP swap instruction (for MakeDirectSwap task).
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+    */
     openBasketIntentTx(params) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c;
@@ -475,6 +713,13 @@ class SymmetryCore {
             return txPayloadBatchSequence;
         });
     }
+    /**
+     * Executes a basket intent. Basket intent will be executed immediately.
+     * @param {Object} params - The parameters for the basket intent.
+     * @param {string} params.keeper - The public key of the keeper.
+     * @param {string} params.intent - The public key of the intent.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+    */
     executeBasketIntentTx(params) {
         return __awaiter(this, void 0, void 0, function* () {
             let keeper = new web3_js_1.PublicKey(params.keeper);
@@ -507,6 +752,13 @@ class SymmetryCore {
             return txPayloadBatchSequence;
         });
     }
+    /**
+     * Cancels a basket intent. Basket intent account will get closed.
+     * @param {Object} params - The parameters for the basket intent.
+     * @param {string} params.keeper - The public key of the keeper.
+     * @param {string} params.intent - The public key of the intent.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+    */
     cancelBasketIntentTx(params) {
         return __awaiter(this, void 0, void 0, function* () {
             let keeper = new web3_js_1.PublicKey(params.keeper);
@@ -533,6 +785,13 @@ class SymmetryCore {
             return txPayloadBatchSequence;
         });
     }
+    /**
+     * Cancels a rebalance intent. Rebalance intent status will be set to AuctionFinished.
+     * @param {Object} params - The parameters for the rebalance intent.
+     * @param {string} params.keeper - The public key of the keeper.
+     * @param {string} params.rebalance_intent - The public key of the rebalance intent.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+    */
     cancelRebalanceIntentTx(params) {
         return __awaiter(this, void 0, void 0, function* () {
             let keeper = new web3_js_1.PublicKey(params.keeper);
@@ -556,6 +815,35 @@ class SymmetryCore {
             return txPayloadBatchSequence;
         });
     }
+    /**
+     * Creates a rebalance intent for a user to deposit tokens into a basket.
+     *
+     * Batch layout:
+     *
+     *  batch 0:
+     * * tx0: [create, resize, init rebalance intent],
+     *
+     * batch 1:
+     * * tx0: [deposit tokens ix],
+     * * tx1: [deposit tokens ix],
+     * * ...
+     *
+     * batch 2:
+     * * tx0: [lock deposits ix, start price updates ix],
+     *
+     * @param {Object} params - The parameters for the basket purchase.
+     * @param {string} params.buyer - The public key of the buyer.
+     * @param {string} params.basket_mint - The mint public key of the basket.
+     * @param {{mint: string, amount: number}[]} params.contributions - The contributions to the basket.
+     * @param {string} params.contributions[].mint - The mint public key of the contribution.
+     * @param {number} params.contributions[].amount - The amount of the contribution.
+     * @param {number} params.rebalance_slippage_bps - Optional. The rebalance slippage in basis points.
+     * @param {number} params.per_trade_rebalance_slippage_bps - Optional. The per trade rebalance slippage in basis points.
+     * @param {number} params.execution_start_time - Optional. The execution start time.
+     * @param {number} params.min_bounty_amount - Optional. The minimum bounty amount.
+     * @param {number} params.max_bounty_amount - Optional. The maximum bounty amount.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+    */
     buyBasketTx(params) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h;
@@ -659,6 +947,20 @@ class SymmetryCore {
             return txPayloadBatchSequence;
         });
     }
+    /**
+     * Creates a rebalance intent for a user to withdraw tokens from a basket.
+     * @param {{Object}} params - The parameters for the basket sale.
+     * @param {string} params.seller - The public key of the seller.
+     * @param {string} params.basket_mint - The mint public key of the basket.
+     * @param {number} params.withdraw_amount - The amount of the withdrawal.
+     * @param {string[]} params.keep_tokens - The token mints to skip rebalancing (will directly be sent to the user without being rebalanced).
+     * @param {number} params.rebalance_slippage_bps - Optional. The rebalance slippage in basis points.
+     * @param {number} params.per_trade_rebalance_slippage_bps - Optional. The per trade rebalance slippage in basis points.
+     * @param {number} params.execution_start_time - Optional. The execution start time.
+     * @param {number} params.min_bounty_amount - Optional. The minimum bounty amount.
+     * @param {number} params.max_bounty_amount - Optional. The maximum bounty amount.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+    */
     sellBasketTx(params) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f;
@@ -773,6 +1075,18 @@ class SymmetryCore {
             return txPayloadBatchSequence;
         });
     }
+    /**
+     * Creates a rebalance intent for a basket rebalance.
+     * @param {Object} params - The parameters for the basket rebalance.
+     * @param {string} params.keeper - The public key of the keeper.
+     * @param {string} params.basket_mint - The basket token mint public key.
+     * @param {number} params.rebalance_slippage_bps - Optional. The rebalance slippage in basis points.
+     * @param {number} params.per_trade_rebalance_slippage_bps - Optional. The per trade rebalance slippage in basis points.
+     * @param {number} params.execution_start_time - Optional. The execution start time.
+     * @param {number} params.min_bounty_amount - Optional. The minimum bounty amount.
+     * @param {number} params.max_bounty_amount - Optional. The maximum bounty amount.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+    */
     rebalanceBasketTx(params) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f;
@@ -837,6 +1151,17 @@ class SymmetryCore {
             return txPayloadBatchSequence;
         });
     }
+    /**
+     * Marks the start of price updates for a rebalance intent. Keepers will be able to
+     *
+     * update token prices for the rebalance intent after priceUpdateDelayAfterCreation seconds.
+     *
+     * @param {Object} params - The parameters for the start price updates.
+     * @param {string} params.keeper - The public key of the keeper.
+     * @param {string} params.basket - The public key of the basket.
+     * @param {string} params.rebalance_intent - The public key of the rebalance intent.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+    */
     startPriceUpdatesTx(params) {
         return __awaiter(this, void 0, void 0, function* () {
             let keeper = new web3_js_1.PublicKey(params.keeper);
@@ -860,30 +1185,74 @@ class SymmetryCore {
             return txPayloadBatchSequence;
         });
     }
+    /**
+     * Build update token prices transactions.
+     *
+     * For pyth oracle accounts, fetches feed IDs, builds vaa [create init encode], [write verify],
+     *
+     * [update feed], [close vaa] instructions. For all tokens, builds [update token prices] instructions.
+     *
+     * returns TxPayloadBatchSequence ready for signAndSendTxPayloadBatchSequence.
+     *
+     * Batch layout:
+     *
+     *  batch 0:
+     * *   tx0: [vaa0CreateIx, vaa0InitIx, vaa0WriteIx],
+     * *   tx1: [vaa1CreateIx, vaa1InitIx, vaa1WriteIx],
+     * *   ...
+     *
+     *  batch 1:
+     * *   tx0: [vaa0WriteVerifyIx, vaa0VerifyIx],
+     * *   tx1: [vaa1WriteVerifyIx, vaa1VerifyIx],
+     * *   ...
+     *
+     *  batch 2:
+     * *   tx0: [updateFeed0Ix],
+     * *   tx1: [updateFeed1Ix],
+     * *   ...
+     *
+     *  batch 3:
+     * *   tx0: [updateTokenPricesIx(max 10 tokens)],
+     * *   tx1: [updateTokenPricesIx(max 10 tokens)],
+     * *   ...
+     * *   txLast: [closeVaa0Ix, closeVaa1Ix, ...]
+     *
+     * @param {Object} params - The parameters for the update token prices.
+     * @param {string} params.keeper - The public key of the keeper.
+     * @param {string} params.basket - The public key of the basket.
+     * @param {string} params.rebalance_intent - The public key of the rebalance intent.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+     */
     updateTokenPricesTx(params) {
         return __awaiter(this, void 0, void 0, function* () {
             let keeper = new web3_js_1.PublicKey(params.keeper);
             let rebalanceIntent = new web3_js_1.PublicKey(params.rebalance_intent);
             let basketRebalanceIntent = (0, pda_1.getRebalanceIntentPda)(new web3_js_1.PublicKey(params.basket), new web3_js_1.PublicKey(params.basket));
             let basket = yield this.fetchBasket(params.basket);
-            let ixs = [];
-            let batchSize = 7;
-            for (let batchStart = 0; batchStart < basket.numTokens; batchStart += batchSize) {
+            let pythPriceFeeds = [];
+            let updateTokenPricesIxs = [];
+            for (let startIndex = 0; startIndex < basket.numTokens; startIndex++) {
                 let allKeys = [];
                 let tokenIndices = [];
-                for (let i = batchStart; i < basket.numTokens && i < batchStart + batchSize; i++) {
-                    tokenIndices.push(i);
-                    let agg = basket.composition[i].oracleAggregator;
+                for (let endIndex = startIndex; endIndex < basket.numTokens; endIndex++) {
+                    let numAccounts = basket.composition[endIndex].oracleAggregator.oracles
+                        .slice(0, basket.composition[endIndex].oracleAggregator.numOracles)
+                        .reduce((acc, oracle) => acc + oracle.oracleSettings.numRequiredAccounts, 0);
+                    if (allKeys.length + numAccounts > constants_1.UPDATE_TOKEN_PRICES_MAX_ACCOUNTS)
+                        break;
+                    if (tokenIndices.length == 20)
+                        break;
+                    startIndex = endIndex;
+                    tokenIndices.push(endIndex);
+                    let agg = basket.composition[endIndex].oracleAggregator;
                     for (let i = 0; i < agg.numOracles; i++) {
-                        const oracleData = agg.oracles[i];
+                        const oracleData = agg.oracles[endIndex];
                         for (let j = 0; j < oracleData.oracleSettings.numRequiredAccounts; j++) {
                             const lutId = oracleData.accountsToLoadLutIds[j];
                             const lutIdx = oracleData.accountsToLoadLutIndices[j];
-                            if (lutId === 0 && lutIdx === 0)
-                                continue;
-                            if (!basket.lutPubkeys)
-                                continue;
                             allKeys.push(basket.lutPubkeys[lutId].state.addresses[lutIdx]);
+                            if (oracleData.oracleSettings.oracleType === oracle_1.OracleType.Pyth)
+                                pythPriceFeeds.push(basket.lutPubkeys[lutId].state.addresses[lutIdx]);
                         }
                     }
                 }
@@ -891,7 +1260,7 @@ class SymmetryCore {
                     tokenIndices.push(0);
                 // TODO: in last instruction we should include performance fee accounts
                 let performanceFees = basket.settings.fees.hostPerformanceFeeBps + basket.settings.fees.creatorPerformanceFeeBps + basket.settings.fees.managersPerformanceFeeBps;
-                ixs.push((0, priceUpdate_1.updateTokenPricesIx)({
+                updateTokenPricesIxs.push((0, priceUpdate_1.updateTokenPricesIx)({
                     keeper: keeper,
                     basket: basket.ownAddress,
                     rebalanceIntent: rebalanceIntent,
@@ -903,20 +1272,191 @@ class SymmetryCore {
                     basketMint: performanceFees > 0 ? basket.mint : undefined,
                 }));
             }
-            let txBatchData = { batches: [ixs.map(ix => ({
-                        payer: keeper,
-                        instructions: [
-                            ix,
-                            web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({ units: constants_1.COMPUTE_UNITS }),
-                            web3_js_1.ComputeBudgetProgram.setComputeUnitPrice({ microLamports: this.sdkParams.priorityFee }),
-                        ],
-                        lookupTables: [basket.lookupTables.active[0], basket.lookupTables.active[1]],
-                    }))] };
+            const { feedIds } = yield (0, pythOracle_1.fetchFeedIdsFromAccounts)(this.sdkParams.connection, pythPriceFeeds);
+            const { vaaCreateInitEncodeIxs, vaaWriteVerifyIxs, updateFeedIxs, closeVaaIxs, } = yield (0, pythOracle_1.buildPythPriceFeedUpdateIxs)(keeper, feedIds);
+            let txBatchData = { batches: [
+                    [
+                        ...vaaCreateInitEncodeIxs.map(ixs => ({
+                            payer: keeper,
+                            instructions: [
+                                ...ixs.ixs,
+                                web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({ units: constants_1.COMPUTE_UNITS }),
+                                web3_js_1.ComputeBudgetProgram.setComputeUnitPrice({ microLamports: this.sdkParams.priorityFee }),
+                            ],
+                            lookupTables: [],
+                        })),
+                    ],
+                    [
+                        ...vaaWriteVerifyIxs.map(ixs => ({
+                            payer: keeper,
+                            instructions: [
+                                ...ixs,
+                                web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({ units: constants_1.COMPUTE_UNITS }),
+                                web3_js_1.ComputeBudgetProgram.setComputeUnitPrice({ microLamports: this.sdkParams.priorityFee }),
+                            ],
+                            lookupTables: [],
+                        })),
+                    ],
+                    [
+                        ...updateFeedIxs.map(ix => ({
+                            payer: keeper,
+                            instructions: [
+                                ix,
+                                web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({ units: constants_1.COMPUTE_UNITS }),
+                                web3_js_1.ComputeBudgetProgram.setComputeUnitPrice({ microLamports: this.sdkParams.priorityFee }),
+                            ],
+                            lookupTables: [],
+                        })),
+                    ],
+                    [
+                        ...updateTokenPricesIxs.map(ix => ({
+                            payer: keeper,
+                            instructions: [
+                                ix,
+                                web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({ units: constants_1.COMPUTE_UNITS }),
+                                web3_js_1.ComputeBudgetProgram.setComputeUnitPrice({ microLamports: this.sdkParams.priorityFee }),
+                            ],
+                            lookupTables: [basket.lookupTables.active[0], basket.lookupTables.active[1]],
+                        })),
+                        {
+                            payer: keeper,
+                            instructions: [
+                                ...closeVaaIxs,
+                                web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({ units: constants_1.COMPUTE_UNITS }),
+                                web3_js_1.ComputeBudgetProgram.setComputeUnitPrice({ microLamports: this.sdkParams.priorityFee }),
+                            ],
+                            lookupTables: [],
+                        }
+                    ],
+                ] };
             let versionedTxs = yield (0, txUtils_1.prepareVersionedTxs)(this.sdkParams.connection, txBatchData);
+            for (let [txId, vaaCreateInitEncodeIx] of vaaCreateInitEncodeIxs.entries()) {
+                versionedTxs.batches[0][txId].sign([vaaCreateInitEncodeIx.signer]);
+            }
+            let txPayloadBatchSequence = (0, txUtils_1.prepareTxPayloadBatchSequence)(txBatchData, versionedTxs);
+            return txPayloadBatchSequence;
+        });
+    }
+    /**
+     * Build Pyth price feed update transactions from on-chain price account pubkeys.
+     * Fetches feed IDs from accounts, builds update instructions, and returns
+     * TxPayloadBatchSequence ready for signAndSendTxPayloadBatchSequence.
+     *
+     * Batch layout:
+     *
+     *  batch 0:
+     * *   tx0: [vaa0CreateIx, vaa0InitIx, vaa0WriteIx],
+     * *   tx1: [vaa1CreateIx, vaa1InitIx, vaa1WriteIx],
+     * *   ...
+     *
+     *  batch 1:
+     * *   tx0: [vaa0WriteVerifyIx, vaa0VerifyIx],
+     * *   tx1: [vaa1WriteVerifyIx, vaa1VerifyIx],
+     * *   ...
+     *
+     *  batch 2:
+     * *   tx0: [updateFeed0Ix],
+     * *   tx1: [updateFeed1Ix],
+     * *   ...
+     *
+     *  batch 3:
+     * *   txLast: [closeVaa0Ix, closeVaa1Ix, ...]
+     *
+     */
+    updatePythPriceFeedsTx(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const payer = new web3_js_1.PublicKey(params.keeper);
+            const priceAccounts = params.accounts.map(a => new web3_js_1.PublicKey(a));
+            const { feedIds } = yield (0, pythOracle_1.fetchFeedIdsFromAccounts)(this.sdkParams.connection, priceAccounts);
+            const { vaaCreateInitEncodeIxs, vaaWriteVerifyIxs, updateFeedIxs, closeVaaIxs, } = yield (0, pythOracle_1.buildPythPriceFeedUpdateIxs)(payer, feedIds);
+            let txBatchData = { batches: [
+                    [
+                        ...vaaCreateInitEncodeIxs.map(ixs => ({
+                            payer: payer,
+                            instructions: [
+                                ...ixs.ixs,
+                                web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({ units: constants_1.COMPUTE_UNITS }),
+                                web3_js_1.ComputeBudgetProgram.setComputeUnitPrice({ microLamports: this.sdkParams.priorityFee }),
+                            ],
+                            lookupTables: [],
+                        })),
+                    ],
+                    [
+                        ...vaaWriteVerifyIxs.map(ixs => ({
+                            payer: payer,
+                            instructions: [
+                                ...ixs,
+                                web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({ units: constants_1.COMPUTE_UNITS }),
+                                web3_js_1.ComputeBudgetProgram.setComputeUnitPrice({ microLamports: this.sdkParams.priorityFee }),
+                            ],
+                            lookupTables: [],
+                        })),
+                    ],
+                    [
+                        ...updateFeedIxs.map(ix => ({
+                            payer: payer,
+                            instructions: [
+                                ix,
+                                web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({ units: constants_1.COMPUTE_UNITS }),
+                                web3_js_1.ComputeBudgetProgram.setComputeUnitPrice({ microLamports: this.sdkParams.priorityFee }),
+                            ],
+                            lookupTables: [],
+                        })),
+                    ],
+                    [
+                        {
+                            payer: payer,
+                            instructions: [
+                                ...closeVaaIxs,
+                                web3_js_1.ComputeBudgetProgram.setComputeUnitLimit({ units: constants_1.COMPUTE_UNITS }),
+                                web3_js_1.ComputeBudgetProgram.setComputeUnitPrice({ microLamports: this.sdkParams.priorityFee }),
+                            ],
+                            lookupTables: [],
+                        }
+                    ],
+                ] };
+            let versionedTxs = yield (0, txUtils_1.prepareVersionedTxs)(this.sdkParams.connection, txBatchData);
+            for (let [txId, vaaCreateInitEncodeIx] of vaaCreateInitEncodeIxs.entries()) {
+                versionedTxs.batches[0][txId].sign([vaaCreateInitEncodeIx.signer]);
+            }
             let txPayloadBatchSequence = (0, txUtils_1.prepareTxPayloadBatchSequence)(txBatchData, versionedTxs);
             return txPayloadBatchSequence;
         });
     }
+    /**
+     * Build flash swap transactions (Rebalance or MakeDirectSwap).
+     *
+     * Withdraws amount_out tokens(mint_out) from basket, deposits amount_in tokens(mint_in) to basket.
+     *
+     * If jup_swap_ix is provided, uses it to swap amount_out tokens(mint_out) for amount_in tokens(mint_in).
+     *
+     * returns TxPayloadBatchSequence ready for signAndSendTxPayloadBatchSequence.
+     *
+     * Batch layout: batch 0: tx: 0:
+     * * create associated token account_mint_out
+     * * create associated token account_mint_in
+     * * jup_token_ledger_ix
+     * * flash withdraw
+     * * jup_swap_ix
+     * * flash deposit
+     * * set compute unit limit
+     * * set compute unit price
+     *
+     * @param {Object} params - The parameters for the flash swap.
+     * @param {string} params.keeper - The public key of the keeper.
+     * @param {string} params.basket - The public key of the basket.
+     * @param {string} params.rebalance_intent - The public key of the rebalance intent (for Rebalance).
+     * @param {string} params.intent - The public key of the intent (for MakeDirectSwap).
+     * @param {string} params.mint_in - The mint of the input token (deposited to basket).
+     * @param {string} params.mint_out - The mint of the output token (withdrawn from basket).
+     * @param {number} params.amount_in - The amount of the input token (deposited to basket).
+     * @param {number} params.amount_out - The amount of the output token (withdrawn from basket).
+     * @param {"exact_in" | "exact_out" | "ioc"} params.mode - The mode of the flash swap.
+     * @param {TransactionInstruction} params.jup_token_ledger_ix - The jup token ledger ix.
+     * @param {TransactionInstruction} params.jup_swap_ix - The jup swap ix.
+     * @param {PublicKey[]} params.jup_address_lookup_table_addresses - The jup address lookup table addresses.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+     */
     flashSwapTx(params) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a;
@@ -969,6 +1509,16 @@ class SymmetryCore {
             return txPayloadBatchSequence;
         });
     }
+    /**
+     * Mints basket tokens for a user. Executable when the rebalance intent has finished its auctions.
+     *
+     * Returns TxPayloadBatchSequence ready for signAndSendTxPayloadBatchSequence.
+     *
+     * @param {Object} params - The parameters for the mint.
+     * @param {string} params.keeper - The public key of the keeper.
+     * @param {string} params.rebalance_intent - The public key of the rebalance intent.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+     */
     mintTx(params) {
         return __awaiter(this, void 0, void 0, function* () {
             let keeper = new web3_js_1.PublicKey(params.keeper);
@@ -996,6 +1546,16 @@ class SymmetryCore {
             return txPayloadBatchSequence;
         });
     }
+    /**
+     * Redeems tokens from the rebalance intent with Withdraw status.
+     *
+     * Returns TxPayloadBatchSequence ready for signAndSendTxPayloadBatchSequence.
+     *
+     * @param {Object} params - The parameters for the redeem tokens.
+     * @param {string} params.keeper - The public key of the keeper.
+     * @param {string} params.rebalance_intent - The public key of the rebalance intent.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+     */
     redeemTokensTx(params) {
         return __awaiter(this, void 0, void 0, function* () {
             let keeper = new web3_js_1.PublicKey(params.keeper);
@@ -1030,6 +1590,20 @@ class SymmetryCore {
             return txPayloadBatchSequence;
         });
     }
+    /**
+     * Claims the bounty to keepers who have completed tasks for rebalance intent.
+     *
+     * Executebale when the rebalance intent has finished its auctions.
+     *
+     * For Withdraw status rebalance intent, tokens have to be redeemed first.
+     *
+     * Closes the rebalance intent if all keepers have claimed the bounty.
+     *
+     * @param {Object} params - The parameters for the claim bounty.
+     * @param {string} params.keeper - The public key of the keeper.
+     * @param {string} params.rebalance_intent - The public key of the rebalance intent.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+     */
     claimBountyTx(params) {
         return __awaiter(this, void 0, void 0, function* () {
             let keeper = new web3_js_1.PublicKey(params.keeper);
@@ -1074,6 +1648,16 @@ class SymmetryCore {
             return txPayloadBatchSequence;
         });
     }
+    /**
+     * Adds bounty for automation to basket.
+     * Returns TxPayloadBatchSequence ready for signAndSendTxPayloadBatchSequence.
+     *
+     * @param {Object} params - The parameters for the add bounty.
+     * @param {string} params.keeper - The public key of the keeper.
+     * @param {string} params.basket - The public key of the basket.
+     * @param {number} params.amount - The amount of the bounty.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+     */
     addBountyTx(params) {
         return __awaiter(this, void 0, void 0, function* () {
             let keeper = new web3_js_1.PublicKey(params.keeper);
@@ -1105,6 +1689,15 @@ class SymmetryCore {
             return txPayloadBatchSequence;
         });
     }
+    /**
+     * Claims fees from the basket for host, creator, managers or symmetry fees collector.
+     * Returns TxPayloadBatchSequence ready for signAndSendTxPayloadBatchSequence.
+     *
+     * @param {Object} params - The parameters for the claim basket fees.
+     * @param {string} params.claimer - The public key of the claimer.
+     * @param {string} params.basket - The public key of the basket.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+     */
     claimBasketFeesTx(params) {
         return __awaiter(this, void 0, void 0, function* () {
             let claimer = new web3_js_1.PublicKey(params.claimer);
@@ -1153,6 +1746,30 @@ class SymmetryCore {
             return txPayloadBatchSequence;
         });
     }
+    /**
+     * Rewrites lookup tables for the basket. (Used when the basket lookup tables are full)
+     *
+     * Returns TxPayloadBatchSequence ready for signAndSendTxPayloadBatchSequence.
+     *
+      * Batch layout:
+     *
+     *  batch 0:
+     * * tx0: [create temp lookup tables],
+     *
+     * batch 1:
+     * * tx0: [extend temp lookup tables (with oracles of active tokens)],
+     * * tx1: [extend temp lookup tables (with oracles of active tokens)],
+     * * ...
+     *
+     * batch 2:
+     * * tx0: [overwrite lookup tables with temp, deactivate old lookup tables],
+     *
+     * @param {Object} params - The parameters for the rewrite lookup tables.
+     * @param {string} params.signer - The public key of the signer.
+     * @param {string} params.basket_mint - The mint of the basket.
+     * @param {string[]} params.additional_accounts - The additional accounts.
+     * @returns {Promise<TxPayloadBatchSequence>} The transaction payload batch sequence.
+     */
     rewriteLookupTablesTx(params) {
         return __awaiter(this, void 0, void 0, function* () {
             const signer = new web3_js_1.PublicKey(params.signer);