@scallop-io/sui-scallop-sdk 0.44.28 → 0.45.0

package/dist/index.mjs

@@ -194,6 +194,197 @@ var MIN_TOP_UP_AMOUNT = 1e9;
 // src/models/scallop.ts
 import { SuiKit as SuiKit5 } from "@scallop-io/sui-kit";
 
+// src/models/scallopCache.ts
+import { QueryClient } from "@tanstack/query-core";
+import { SuiTxBlock } from "@scallop-io/sui-kit";
+
+// src/constants/cache.ts
+var DEFAULT_CACHE_OPTIONS = {
+  defaultOptions: {
+    queries: {
+      staleTime: 3e3
+    }
+  }
+};
+
+// src/models/scallopCache.ts
+var ScallopCache = class {
+  constructor(cacheOptions, suiKit) {
+    this.queryClient = new QueryClient(cacheOptions ?? DEFAULT_CACHE_OPTIONS);
+    this._suiKit = suiKit;
+  }
+  get suiKit() {
+    if (!this._suiKit) {
+      throw new Error("SuiKit instance is not initialized");
+    }
+    return this._suiKit;
+  }
+  /**
+   * @description Invalidate cache based on the refetchType parameter
+   * @param refetchType Determines the type of queries to be refetched. Defaults to `active`.
+   *
+   * - `active`: Only queries that match the refetch predicate and are actively being rendered via useQuery and related functions will be refetched in the background.
+   * - `inactive`: Only queries that match the refetch predicate and are NOT actively being rendered via useQuery and related functions will be refetched in the background.
+   * - `all`: All queries that match the refetch predicate will be refetched in the background.
+   * - `none`: No queries will be refetched. Queries that match the refetch predicate will only be marked as invalid.
+   */
+  invalidateAndRefetchAllCache(refetchType) {
+    return this.queryClient.invalidateQueries({
+      refetchType
+    });
+  }
+  /**
+   * @description Cache protocol config call for 60 seconds.
+   * @returns Promise<ProtocolConfig>
+   */
+  async getProtocolConfig() {
+    return await this.queryClient.fetchQuery({
+      queryKey: ["getProtocolConfig"],
+      queryFn: async () => {
+        return await this.suiKit.client().getProtocolConfig();
+      },
+      staleTime: 3e4
+    });
+  }
+  /**
+   * @description Provides cache for inspectTxn of the SuiKit.
+   * @param QueryInspectTxnParams
+   * @param txBlock
+   * @returns Promise<DevInspectResults>
+   */
+  async queryInspectTxn({
+    queryTarget,
+    args,
+    typeArgs
+  }) {
+    const txBlock = new SuiTxBlock();
+    const resolvedArgs = await Promise.all(
+      args.map(async (arg) => {
+        if (typeof arg === "string") {
+          return (await this.queryGetObject(arg, { showContent: true })).data;
+        }
+        return arg;
+      })
+    );
+    txBlock.moveCall(queryTarget, resolvedArgs, typeArgs);
+    const txBytes = await txBlock.txBlock.build({
+      client: this.suiKit.client(),
+      onlyTransactionKind: true,
+      protocolConfig: await this.getProtocolConfig()
+    });
+    const query = await this.queryClient.fetchQuery({
+      queryKey: typeArgs ? ["inspectTxn", queryTarget, JSON.stringify(args)] : [
+        "inspectTxn",
+        queryTarget,
+        JSON.stringify(args),
+        JSON.stringify(typeArgs)
+      ],
+      queryFn: async () => {
+        return await this.suiKit.inspectTxn(txBytes);
+      },
+      staleTime: 8e3
+      // make stale time longer for inspectTxn results
+    });
+    return query;
+  }
+  /**
+   * @description Provides cache for getObject of the SuiKit.
+   * @param objectId
+   * @param QueryObjectParams
+   * @returns Promise<SuiObjectResponse>
+   */
+  async queryGetObject(objectId, options) {
+    const queryKey = ["getObject", objectId, this.suiKit.currentAddress()];
+    if (options) {
+      queryKey.push(JSON.stringify(options));
+    }
+    return this.queryClient.fetchQuery({
+      queryKey,
+      queryFn: async () => {
+        return await this.suiKit.client().getObject({
+          id: objectId,
+          options
+        });
+      }
+    });
+  }
+  /**
+   * @description Provides cache for getObjects of the SuiKit.
+   * @param objectIds
+   * @returns Promise<SuiObjectData[]>
+   */
+  async queryGetObjects(objectIds, options) {
+    const queryKey = [
+      "getObjects",
+      JSON.stringify(objectIds),
+      this.suiKit.currentAddress()
+    ];
+    return this.queryClient.fetchQuery({
+      queryKey,
+      queryFn: async () => {
+        return await this.suiKit.getObjects(objectIds, options);
+      }
+    });
+  }
+  /**
+   * @description Provides cache for getOwnedObjects of the SuiKit.
+   * @param input
+   * @returns Promise<PaginatedObjectsResponse>
+   */
+  async queryGetOwnedObjects(input) {
+    const queryKey = ["getOwnedObjects", input.owner];
+    if (input.cursor) {
+      queryKey.push(JSON.stringify(input.cursor));
+    }
+    if (input.options) {
+      queryKey.push(JSON.stringify(input.options));
+    }
+    if (input.filter) {
+      queryKey.push(JSON.stringify(input.filter));
+    }
+    if (input.limit) {
+      queryKey.push(JSON.stringify(input.limit));
+    }
+    return this.queryClient.fetchQuery({
+      queryKey,
+      queryFn: async () => {
+        return await this.suiKit.client().getOwnedObjects(input);
+      }
+    });
+  }
+  async queryGetDynamicFields(input) {
+    const queryKey = ["getDynamicFields", input.parentId];
+    if (input.cursor) {
+      queryKey.push(JSON.stringify(input.cursor));
+    }
+    if (input.cursor) {
+      queryKey.push(JSON.stringify(input.cursor));
+    }
+    if (input.limit) {
+      queryKey.push(JSON.stringify(input.limit));
+    }
+    return this.queryClient.fetchQuery({
+      queryKey,
+      queryFn: async () => {
+        return await this.suiKit.client().getDynamicFields(input);
+      }
+    });
+  }
+  async queryGetDynamicFieldObject(input) {
+    const queryKey = [
+      "getDynamicFieldObject",
+      input.parentId,
+      input.name.value
+    ];
+    return this.queryClient.fetchQuery({
+      queryKey,
+      queryFn: async () => {
+        return await this.suiKit.client().getDynamicFieldObject(input);
+      }
+    });
+  }
+};
+
 // src/models/scallopAddress.ts
 import axios from "axios";
 var EMPTY_ADDRESSES = {
@@ -446,13 +637,9 @@ var EMPTY_ADDRESSES = {
   }
 };
 var ScallopAddress = class {
-  constructor(params) {
+  constructor(params, cache) {
     const { id, auth, network } = params;
-    if (auth)
-      this._auth = auth;
-    this._id = id;
-    this._network = network || "mainnet";
-    this._addressesMap = /* @__PURE__ */ new Map();
+    this._cache = cache ?? new ScallopCache(DEFAULT_CACHE_OPTIONS);
     this._requestClient = axios.create({
       baseURL: API_BASE_URL,
       headers: {
@@ -461,6 +648,11 @@ var ScallopAddress = class {
       },
       timeout: 3e4
     });
+    if (auth)
+      this._auth = auth;
+    this._id = id;
+    this._network = network || "mainnet";
+    this._addressesMap = /* @__PURE__ */ new Map();
   }
   /**
    * Get addresses API id.
@@ -584,7 +776,7 @@ var ScallopAddress = class {
       this._addressesMap.clear();
       this.setAddresses(targetAddresses, targetNetwork);
       const response = await this._requestClient.post(
-        `${API_BASE_URL}/addresses`,
+        `/addresses`,
         JSON.stringify({ ...Object.fromEntries(this._addressesMap), memo }),
         {
           headers: {
@@ -621,14 +813,16 @@ var ScallopAddress = class {
   async read(id) {
     const addressesId = id || this._id || void 0;
     if (addressesId !== void 0) {
-      const response = await this._requestClient.get(
-        `${API_BASE_URL}/addresses/${addressesId}`,
-        {
-          headers: {
-            "Content-Type": "application/json"
-          }
+      const response = await this._cache.queryClient.fetchQuery({
+        queryKey: ["api-getAddresses", addressesId],
+        queryFn: async () => {
+          return await this._requestClient.get(`/addresses/${addressesId}`, {
+            headers: {
+              "Content-Type": "application/json"
+            }
+          });
         }
-      );
+      });
       if (response.status === 200) {
         for (const [network, addresses] of Object.entries(
           response.data
@@ -682,7 +876,7 @@ var ScallopAddress = class {
       }
       this.setAddresses(targetAddresses, targetNetwork);
       const response = await this._requestClient.put(
-        `${API_BASE_URL}/addresses/${targetId}`,
+        `/addresses/${targetId}`,
         JSON.stringify({ ...Object.fromEntries(this._addressesMap), memo }),
         {
           headers: {
@@ -724,7 +918,7 @@ var ScallopAddress = class {
       throw Error("Require specific addresses id to be deleted.");
     if (apiKey !== void 0) {
       const response = await this._requestClient.delete(
-        `${API_BASE_URL}/addresses/${targetId}`,
+        `/addresses/${targetId}`,
         {
           headers: {
             "Content-Type": "application/json",
@@ -759,7 +953,6 @@ import { SuiKit } from "@scallop-io/sui-kit";
 
 // src/queries/coreQuery.ts
 import { normalizeStructTag as normalizeStructTag2 } from "@mysten/sui.js/utils";
-import { SuiTxBlock as SuiKitTxBlock } from "@scallop-io/sui-kit";
 import BigNumber2 from "bignumber.js";
 
 // src/utils/builder.ts
@@ -1311,10 +1504,12 @@ var findClosestUnlockRound = (unlockAtInSecondTimestamp) => {
 var queryMarket = async (query, indexer = false) => {
   const packageId = query.address.get("core.packages.query.id");
   const marketId = query.address.get("core.market");
-  const txBlock = new SuiKitTxBlock();
   const queryTarget = `${packageId}::market_query::market_data`;
-  txBlock.moveCall(queryTarget, [marketId]);
-  const queryResult = await query.suiKit.inspectTxn(txBlock);
+  const args = [marketId];
+  const queryResult = await query.cache.queryInspectTxn(
+    { queryTarget, args }
+    // txBlock
+  );
   const marketData = queryResult.events[0].parsedJson;
   const coinPrices = await query.utils.getCoinPrices();
   const pools = {};
@@ -1432,11 +1627,8 @@ var queryMarket = async (query, indexer = false) => {
 var getMarketPools = async (query, poolCoinNames, indexer = false) => {
   poolCoinNames = poolCoinNames || [...SUPPORT_POOLS];
   const marketId = query.address.get("core.market");
-  const marketObjectResponse = await query.suiKit.client().getObject({
-    id: marketId,
-    options: {
-      showContent: true
-    }
+  const marketObjectResponse = await query.cache.queryGetObject(marketId, {
+    showContent: true
   });
   const coinPrices = await query.utils.getCoinPrices(poolCoinNames ?? []);
   const marketPools = {};
@@ -1469,11 +1661,8 @@ var getMarketPools = async (query, poolCoinNames, indexer = false) => {
 };
 var getMarketPool = async (query, poolCoinName, indexer = false, marketObject, coinPrice) => {
   const marketId = query.address.get("core.market");
-  marketObject = marketObject || (await query.suiKit.client().getObject({
-    id: marketId,
-    options: {
-      showContent: true
-    }
+  marketObject = marketObject || (await query.cache.queryGetObject(marketId, {
+    showContent: true
   })).data;
   coinPrice = coinPrice || (await query.utils.getCoinPrices([poolCoinName]))?.[poolCoinName];
   let marketPool;
@@ -1494,7 +1683,7 @@ var getMarketPool = async (query, poolCoinName, indexer = false, marketObject, c
       const fields = marketObject.content.fields;
       const coinType = query.utils.parseCoinType(poolCoinName);
       const balanceSheetParentId = fields.vault.fields.balance_sheets.fields.table.fields.id.id;
-      const balanceSheetDynamicFieldObjectResponse = await query.suiKit.client().getDynamicFieldObject({
+      const balanceSheetDynamicFieldObjectResponse = await query.cache.queryGetDynamicFieldObject({
         parentId: balanceSheetParentId,
         name: {
           type: "0x1::type_name::TypeName",
@@ -1509,7 +1698,7 @@ var getMarketPool = async (query, poolCoinName, indexer = false, marketObject, c
         balanceSheet = dynamicFields.value.fields;
       }
       const borrowIndexParentId = fields.borrow_dynamics.fields.table.fields.id.id;
-      const borrowIndexDynamicFieldObjectResponse = await query.suiKit.client().getDynamicFieldObject({
+      const borrowIndexDynamicFieldObjectResponse = await query.cache.queryGetDynamicFieldObject({
         parentId: borrowIndexParentId,
         name: {
           type: "0x1::type_name::TypeName",
@@ -1524,7 +1713,7 @@ var getMarketPool = async (query, poolCoinName, indexer = false, marketObject, c
         borrowIndex = dynamicFields.value.fields;
       }
       const interestModelParentId = fields.interest_models.fields.table.fields.id.id;
-      const interestModelDynamicFieldObjectResponse = await query.suiKit.client().getDynamicFieldObject({
+      const interestModelDynamicFieldObjectResponse = await query.cache.queryGetDynamicFieldObject({
         parentId: interestModelParentId,
         name: {
           type: "0x1::type_name::TypeName",
@@ -1538,7 +1727,7 @@ var getMarketPool = async (query, poolCoinName, indexer = false, marketObject, c
         const dynamicFields = interestModelDynamicFieldObject.content.fields;
         interestModel = dynamicFields.value.fields;
       }
-      const borrowFeeDynamicFieldObjectResponse = await query.suiKit.client().getDynamicFieldObject({
+      const borrowFeeDynamicFieldObjectResponse = await query.cache.queryGetDynamicFieldObject({
         parentId: marketId,
         name: {
           type: `${BORROW_FEE_PROTOCOL_ID}::market_dynamic_keys::BorrowFeeKey`,
@@ -1605,11 +1794,8 @@ var getMarketPool = async (query, poolCoinName, indexer = false, marketObject, c
 var getMarketCollaterals = async (query, collateralCoinNames, indexer = false) => {
   collateralCoinNames = collateralCoinNames || [...SUPPORT_COLLATERALS];
   const marketId = query.address.get("core.market");
-  const marketObjectResponse = await query.suiKit.client().getObject({
-    id: marketId,
-    options: {
-      showContent: true
-    }
+  const marketObjectResponse = await query.cache.queryGetObject(marketId, {
+    showContent: true
   });
   const coinPrices = await query.utils.getCoinPrices(collateralCoinNames ?? []);
   const marketCollaterals = {};
@@ -1642,11 +1828,8 @@ var getMarketCollaterals = async (query, collateralCoinNames, indexer = false) =
 };
 var getMarketCollateral = async (query, collateralCoinName, indexer = false, marketObject, coinPrice) => {
   const marketId = query.address.get("core.market");
-  marketObject = marketObject || (await query.suiKit.client().getObject({
-    id: marketId,
-    options: {
-      showContent: true
-    }
+  marketObject = marketObject || (await query.cache.queryGetObject(marketId, {
+    showContent: true
   })).data;
   coinPrice = coinPrice || (await query.utils.getCoinPrices([collateralCoinName]))?.[collateralCoinName];
   let marketCollateral;
@@ -1665,7 +1848,7 @@ var getMarketCollateral = async (query, collateralCoinName, indexer = false, mar
       const fields = marketObject.content.fields;
       const coinType = query.utils.parseCoinType(collateralCoinName);
       const riskModelParentId = fields.risk_models.fields.table.fields.id.id;
-      const riskModelDynamicFieldObjectResponse = await query.suiKit.client().getDynamicFieldObject({
+      const riskModelDynamicFieldObjectResponse = await query.cache.queryGetDynamicFieldObject({
         parentId: riskModelParentId,
         name: {
           type: "0x1::type_name::TypeName",
@@ -1680,7 +1863,7 @@ var getMarketCollateral = async (query, collateralCoinName, indexer = false, mar
         riskModel = dynamicFields.value.fields;
       }
       const collateralStatParentId = fields.collateral_stats.fields.table.fields.id.id;
-      const collateralStatDynamicFieldObjectResponse = await query.suiKit.client().getDynamicFieldObject({
+      const collateralStatDynamicFieldObjectResponse = await query.cache.queryGetDynamicFieldObject({
         parentId: collateralStatParentId,
         name: {
           type: "0x1::type_name::TypeName",
@@ -1736,7 +1919,7 @@ var getObligations = async (query, ownerAddress) => {
   let hasNextPage = false;
   let nextCursor = null;
   do {
-    const paginatedKeyObjectsResponse = await query.suiKit.client().getOwnedObjects({
+    const paginatedKeyObjectsResponse = await query.cache.queryGetOwnedObjects({
       owner,
       filter: {
         StructType: `${protocolObjectId}::obligation::ObligationKey`
@@ -1752,7 +1935,7 @@ var getObligations = async (query, ownerAddress) => {
     }
   } while (hasNextPage);
   const keyObjectIds = keyObjectsResponse.map((ref) => ref?.data?.objectId).filter((id) => id !== void 0);
-  const keyObjects = await query.suiKit.getObjects(keyObjectIds);
+  const keyObjects = await query.cache.queryGetObjects(keyObjectIds);
   const obligations = [];
   for (const keyObject of keyObjects) {
     const keyId = keyObject.objectId;
@@ -1766,12 +1949,10 @@ var getObligations = async (query, ownerAddress) => {
   return obligations;
 };
 var getObligationLocked = async (query, obligationId) => {
-  const obligationObjectResponse = await query.suiKit.client().getObject({
-    id: obligationId,
-    options: {
-      showContent: true
-    }
-  });
+  const obligationObjectResponse = await query.cache.queryGetObject(
+    obligationId,
+    { showContent: true }
+  );
   let obligationLocked = false;
   if (obligationObjectResponse.data && obligationObjectResponse?.data?.content?.dataType === "moveObject" && "lock_key" in obligationObjectResponse.data.content.fields) {
     obligationLocked = Boolean(
@@ -1783,9 +1964,11 @@ var getObligationLocked = async (query, obligationId) => {
 var queryObligation = async (query, obligationId) => {
   const packageId = query.address.get("core.packages.query.id");
   const queryTarget = `${packageId}::obligation_query::obligation_data`;
-  const txBlock = new SuiKitTxBlock();
-  txBlock.moveCall(queryTarget, [obligationId]);
-  const queryResult = await query.suiKit.inspectTxn(txBlock);
+  const args = [obligationId];
+  const queryResult = await query.cache.queryInspectTxn(
+    { queryTarget, args }
+    // txBlock
+  );
   return queryResult.events[0].parsedJson;
 };
 var getCoinAmounts = async (query, assetCoinNames, ownerAddress) => {
@@ -1795,20 +1978,22 @@ var getCoinAmounts = async (query, assetCoinNames, ownerAddress) => {
   let hasNextPage = false;
   let nextCursor = null;
   do {
-    const paginatedCoinObjectsResponse = await query.suiKit.client().getOwnedObjects({
-      owner,
-      filter: {
-        MatchAny: assetCoinNames.map((assetCoinName) => {
-          const coinType = query.utils.parseCoinType(assetCoinName);
-          return { StructType: `0x2::coin::Coin<${coinType}>` };
-        })
-      },
-      options: {
-        showType: true,
-        showContent: true
-      },
-      cursor: nextCursor
-    });
+    const paginatedCoinObjectsResponse = await query.cache.queryGetOwnedObjects(
+      {
+        owner,
+        filter: {
+          MatchAny: assetCoinNames.map((assetCoinName) => {
+            const coinType = query.utils.parseCoinType(assetCoinName);
+            return { StructType: `0x2::coin::Coin<${coinType}>` };
+          })
+        },
+        options: {
+          showType: true,
+          showContent: true
+        },
+        cursor: nextCursor
+      }
+    );
     coinObjectsResponse.push(...paginatedCoinObjectsResponse.data);
     if (paginatedCoinObjectsResponse.hasNextPage && paginatedCoinObjectsResponse.nextCursor) {
       hasNextPage = true;
@@ -1842,14 +2027,16 @@ var getCoinAmount = async (query, assetCoinName, ownerAddress) => {
   let hasNextPage = false;
   let nextCursor = null;
   do {
-    const paginatedCoinObjectsResponse = await query.suiKit.client().getOwnedObjects({
-      owner,
-      filter: { StructType: `0x2::coin::Coin<${coinType}>` },
-      options: {
-        showContent: true
-      },
-      cursor: nextCursor
-    });
+    const paginatedCoinObjectsResponse = await query.cache.queryGetOwnedObjects(
+      {
+        owner,
+        filter: { StructType: `0x2::coin::Coin<${coinType}>` },
+        options: {
+          showContent: true
+        },
+        cursor: nextCursor
+      }
+    );
     coinObjectsResponse.push(...paginatedCoinObjectsResponse.data);
     if (paginatedCoinObjectsResponse.hasNextPage && paginatedCoinObjectsResponse.nextCursor) {
       hasNextPage = true;
@@ -1881,7 +2068,7 @@ var getMarketCoinAmounts = async (query, marketCoinNames, ownerAddress) => {
   let hasNextPage = false;
   let nextCursor = null;
   do {
-    const paginatedMarketCoinObjectsResponse = await query.suiKit.client().getOwnedObjects({
+    const paginatedMarketCoinObjectsResponse = await query.cache.queryGetOwnedObjects({
       owner,
       filter: {
         MatchAny: marketCoinNames.map((marketCoinName) => {
@@ -1930,7 +2117,7 @@ var getMarketCoinAmount = async (query, marketCoinName, ownerAddress) => {
   let hasNextPage = false;
   let nextCursor = null;
   do {
-    const paginatedMarketCoinObjectsResponse = await query.suiKit.client().getOwnedObjects({
+    const paginatedMarketCoinObjectsResponse = await query.cache.queryGetOwnedObjects({
       owner,
       filter: { StructType: `0x2::coin::Coin<${marketCoinType}>` },
       options: {
@@ -2110,7 +2297,7 @@ var getStakeAccounts = async (query, ownerAddress) => {
   let hasNextPage = false;
   let nextCursor = null;
   do {
-    const paginatedStakeObjectsResponse = await query.suiKit.client().getOwnedObjects({
+    const paginatedStakeObjectsResponse = await query.cache.queryGetOwnedObjects({
       owner,
       filter: { StructType: stakeAccountType },
       options: {
@@ -2148,7 +2335,7 @@ var getStakeAccounts = async (query, ownerAddress) => {
     {}
   );
   const stakeObjectIds = stakeObjectsResponse.map((ref) => ref?.data?.objectId).filter((id) => id !== void 0);
-  const stakeObjects = await query.suiKit.getObjects(stakeObjectIds);
+  const stakeObjects = await query.cache.queryGetObjects(stakeObjectIds);
   for (const stakeObject of stakeObjects) {
     const id = stakeObject.objectId;
     const type = stakeObject.type;
@@ -2256,12 +2443,9 @@ var getStakeAccounts = async (query, ownerAddress) => {
 var getStakePool = async (query, marketCoinName) => {
   const poolId = query.address.get(`spool.pools.${marketCoinName}.id`);
   let stakePool = void 0;
-  const stakePoolObjectResponse = await query.suiKit.client().getObject({
-    id: poolId,
-    options: {
-      showContent: true,
-      showType: true
-    }
+  const stakePoolObjectResponse = await query.cache.queryGetObject(poolId, {
+    showContent: true,
+    showType: true
   });
   if (stakePoolObjectResponse.data) {
     const stakePoolObject = stakePoolObjectResponse.data;
@@ -2302,13 +2486,13 @@ var getStakeRewardPool = async (query, marketCoinName) => {
     `spool.pools.${marketCoinName}.rewardPoolId`
   );
   let stakeRewardPool = void 0;
-  const stakeRewardPoolObjectResponse = await query.suiKit.client().getObject({
-    id: poolId,
-    options: {
+  const stakeRewardPoolObjectResponse = await query.cache.queryGetObject(
+    poolId,
+    {
       showContent: true,
       showType: true
     }
-  });
+  );
   if (stakeRewardPoolObjectResponse.data) {
     const stakeRewardPoolObject = stakeRewardPoolObjectResponse.data;
     const id = stakeRewardPoolObject.objectId;
@@ -2338,17 +2522,15 @@ var getStakeRewardPool = async (query, marketCoinName) => {
 
 // src/queries/borrowIncentiveQuery.ts
 import { normalizeStructTag as normalizeStructTag4 } from "@mysten/sui.js/utils";
-import { SuiTxBlock as SuiKitTxBlock2 } from "@scallop-io/sui-kit";
 var queryBorrowIncentivePools = async (query, borrowIncentiveCoinNames, indexer = false) => {
   borrowIncentiveCoinNames = borrowIncentiveCoinNames || [
     ...SUPPORT_BORROW_INCENTIVE_POOLS
   ];
   const queryPkgId = query.address.get("borrowIncentive.query");
   const incentivePoolsId = query.address.get("borrowIncentive.incentivePools");
-  const txBlock = new SuiKitTxBlock2();
   const queryTarget = `${queryPkgId}::incentive_pools_query::incentive_pools_data`;
-  txBlock.moveCall(queryTarget, [incentivePoolsId]);
-  const queryResult = await query.suiKit.inspectTxn(txBlock);
+  const args = [incentivePoolsId];
+  const queryResult = await query.cache.queryInspectTxn({ queryTarget, args });
   const borrowIncentivePoolsQueryData = queryResult.events[0].parsedJson;
   const borrowIncentivePools = {};
   if (indexer) {
@@ -2425,9 +2607,8 @@ var queryBorrowIncentiveAccounts = async (query, obligationId, borrowIncentiveCo
     "borrowIncentive.incentiveAccounts"
   );
   const queryTarget = `${queryPkgId}::incentive_account_query::incentive_account_data`;
-  const txBlock = new SuiKitTxBlock2();
-  txBlock.moveCall(queryTarget, [incentiveAccountsId, obligationId]);
-  const queryResult = await query.suiKit.inspectTxn(txBlock);
+  const args = [incentiveAccountsId, obligationId];
+  const queryResult = await query.cache.queryInspectTxn({ queryTarget, args });
   const borrowIncentiveAccountsQueryData = queryResult.events[0].parsedJson;
   const borrowIncentiveAccounts = Object.values(
     borrowIncentiveAccountsQueryData.pool_records
@@ -2505,12 +2686,10 @@ var getPythPrice = async (query, assetCoinName) => {
   const pythFeedObjectId = query.address.get(
     `core.coins.${assetCoinName}.oracle.pyth.feedObject`
   );
-  const priceFeedObjectResponse = await query.suiKit.client().getObject({
-    id: pythFeedObjectId,
-    options: {
-      showContent: true
-    }
-  });
+  const priceFeedObjectResponse = await query.cache.queryGetObject(
+    pythFeedObjectId,
+    { showContent: true }
+  );
   if (priceFeedObjectResponse.data) {
     const priceFeedPoolObject = priceFeedObjectResponse.data;
     if (priceFeedPoolObject.content && "fields" in priceFeedPoolObject.content) {
@@ -3074,7 +3253,7 @@ var getVeSca = async (query, veScaKeyId, ownerAddress) => {
   const tableId = IS_VE_SCA_TEST ? "0xc607241e4a679fe376d1170b2fbe07b64917bfe69100d4825241cda20039d4bd" : query.address.get(`vesca.tableId`);
   veScaKeyId = veScaKeyId || (await getVescaKeys(query, ownerAddress))[0].objectId;
   let vesca = void 0;
-  const veScaDynamicFieldObjectResponse = await query.suiKit.client().getDynamicFieldObject({
+  const veScaDynamicFieldObjectResponse = await query.cache.queryGetDynamicFieldObject({
     parentId: tableId,
     name: {
       type: "0x2::object::ID",
@@ -3106,7 +3285,9 @@ var getVeSca = async (query, veScaKeyId, ownerAddress) => {
 // src/models/scallopIndexer.ts
 import axios2 from "axios";
 var ScallopIndexer = class {
-  constructor() {
+  constructor(params, instance) {
+    this.params = params;
+    this._cache = instance?.cache ?? new ScallopCache();
     this._requestClient = axios2.create({
       baseURL: SDK_API_BASE_URL,
       headers: {
@@ -3122,7 +3303,12 @@ var ScallopIndexer = class {
    * @return Market data.
    */
   async getMarket() {
-    const response = await this._requestClient.get(`${SDK_API_BASE_URL}/api/market`);
+    const response = await this._cache.queryClient.fetchQuery({
+      queryKey: ["market"],
+      queryFn: async () => {
+        return await this._requestClient.get(`/api/market`);
+      }
+    });
     if (response.status === 200) {
       return {
         pools: response.data.pools.reduce((marketPools, marketPool) => {
@@ -3147,15 +3333,8 @@ var ScallopIndexer = class {
    * @return Market pools data.
    */
   async getMarketPools() {
-    const response = await this._requestClient.get(`${SDK_API_BASE_URL}/api/market/pools`);
-    if (response.status === 200) {
-      return response.data.pools.reduce((marketPools, marketPool) => {
-        marketPools[marketPool.coinName] = marketPool;
-        return marketPools;
-      }, {});
-    } else {
-      throw Error("Failed to getMarketPools.");
-    }
+    const response = (await this.getMarket()).pools;
+    return response;
   }
   /**
    * Get market pool index data.
@@ -3163,12 +3342,7 @@ var ScallopIndexer = class {
    * @return Market pool data.
    */
   async getMarketPool(poolCoinName) {
-    const response = await this._requestClient.get(`${SDK_API_BASE_URL}/api/market/pool/${poolCoinName}`);
-    if (response.status === 200) {
-      return response.data.pool;
-    } else {
-      throw Error("Failed to getMarketPool.");
-    }
+    return (await this.getMarketPools())[poolCoinName];
   }
   /**
    * Get market collaterals index data.
@@ -3176,18 +3350,7 @@ var ScallopIndexer = class {
    * @return Market collaterals data.
    */
   async getMarketCollaterals() {
-    const response = await this._requestClient.get(`${SDK_API_BASE_URL}/api/market/collaterals`);
-    if (response.status === 200) {
-      return response.data.collaterals.reduce(
-        (marketCollaterals, marketCollateral) => {
-          marketCollaterals[marketCollateral.coinName] = marketCollateral;
-          return marketCollaterals;
-        },
-        {}
-      );
-    } else {
-      throw Error("Failed to getMarketCollaterals.");
-    }
+    return (await this.getMarket()).collaterals;
   }
   /**
    * Get market collateral index data.
@@ -3195,12 +3358,7 @@ var ScallopIndexer = class {
    * @return Market collateral data.
    */
   async getMarketCollateral(collateralCoinName) {
-    const response = await this._requestClient.get(`${SDK_API_BASE_URL}/api/market/collateral/${collateralCoinName}`);
-    if (response.status === 200) {
-      return response.data.collateral;
-    } else {
-      throw Error("Failed to getMarketCollateral.");
-    }
+    return (await this.getMarketCollaterals())[collateralCoinName];
   }
   /**
    * Get spools index data.
@@ -3208,7 +3366,12 @@ var ScallopIndexer = class {
    * @return Spools data.
    */
   async getSpools() {
-    const response = await this._requestClient.get(`${SDK_API_BASE_URL}/api/spools`);
+    const response = await this._cache.queryClient.fetchQuery({
+      queryKey: ["spools"],
+      queryFn: async () => {
+        return await this._requestClient.get(`/api/spools`);
+      }
+    });
     if (response.status === 200) {
       return response.data.spools.reduce((spools, spool) => {
         spools[spool.marketCoinName] = spool;
@@ -3224,12 +3387,7 @@ var ScallopIndexer = class {
    * @return Spool data.
    */
   async getSpool(marketCoinName) {
-    const response = await this._requestClient.get(`${SDK_API_BASE_URL}/api/spool/${marketCoinName}`);
-    if (response.status === 200) {
-      return response.data.spool;
-    } else {
-      throw Error("Failed to getSpool.");
-    }
+    return (await this.getSpools())[marketCoinName];
   }
   /**
    * Get borrow incentive pools index data.
@@ -3237,7 +3395,12 @@ var ScallopIndexer = class {
    * @return Borrow incentive pools data.
    */
   async getBorrowIncentivePools() {
-    const response = await this._requestClient.get(`${SDK_API_BASE_URL}/api/borrowIncentivePools`);
+    const response = await this._cache.queryClient.fetchQuery({
+      queryKey: ["borrowIncentivePools"],
+      queryFn: async () => {
+        return await this._requestClient.get(`/api/borrowIncentivePools`);
+      }
+    });
     if (response.status === 200) {
       return response.data.borrowIncentivePools.reduce(
         (borrowIncentivePools, borrowIncentivePool) => {
@@ -3256,14 +3419,7 @@ var ScallopIndexer = class {
    * @return Borrow incentive pool data.
    */
   async getBorrowIncentivePool(borrowIncentiveCoinName) {
-    const response = await this._requestClient.get(
-      `${SDK_API_BASE_URL}/api/borrowIncentivePool/${borrowIncentiveCoinName}`
-    );
-    if (response.status === 200) {
-      return response.data.borrowIncentivePool;
-    } else {
-      throw Error("Failed to getSpool.");
-    }
+    return (await this.getBorrowIncentivePools())[borrowIncentiveCoinName];
   }
   /**
    * Get total value locked index data.
@@ -3271,7 +3427,12 @@ var ScallopIndexer = class {
    * @return Total value locked.
    */
   async getTotalValueLocked() {
-    const response = await this._requestClient.get(`${SDK_API_BASE_URL}/api/market/tvl`);
+    const response = await this._cache.queryClient.fetchQuery({
+      queryKey: ["totalValueLocked"],
+      queryFn: async () => {
+        return await this._requestClient.get(`/api/market/tvl`);
+      }
+    });
     if (response.status === 200) {
       return response.data;
     } else {
@@ -3285,16 +3446,21 @@ var ScallopQuery = class {
   constructor(params, instance) {
     this.params = params;
     this.suiKit = instance?.suiKit ?? new SuiKit(params);
-    this.address = instance?.address ?? new ScallopAddress({
-      id: params?.addressesId || ADDRESSES_ID,
-      network: params?.networkType
-    });
+    this.cache = instance?.cache ?? new ScallopCache(DEFAULT_CACHE_OPTIONS, this.suiKit);
+    this.address = instance?.address ?? new ScallopAddress(
+      {
+        id: params?.addressesId || ADDRESSES_ID,
+        network: params?.networkType
+      },
+      this.cache
+    );
     this.utils = instance?.utils ?? new ScallopUtils(this.params, {
       suiKit: this.suiKit,
       address: this.address,
+      cache: this.cache,
       query: this
     });
-    this.indexer = new ScallopIndexer();
+    this.indexer = new ScallopIndexer(this.params, { cache: this.cache });
   }
   /**
    * Request the scallop API to initialize data.
@@ -3680,13 +3846,18 @@ var ScallopUtils = class {
     };
     this.params = params;
     this._suiKit = instance?.suiKit ?? new SuiKit2(params);
-    this._address = instance?.address ?? new ScallopAddress({
-      id: params?.addressesId || ADDRESSES_ID,
-      network: params?.networkType
-    });
+    this._cache = instance?.cache ?? new ScallopCache(DEFAULT_CACHE_OPTIONS, this._suiKit);
+    this._address = instance?.address ?? new ScallopAddress(
+      {
+        id: params?.addressesId || ADDRESSES_ID,
+        network: params?.networkType
+      },
+      this._cache
+    );
     this._query = instance?.query ?? new ScallopQuery(params, {
       suiKit: this._suiKit,
-      address: this._address
+      address: this._address,
+      cache: this._cache
     });
     this.isTestnet = params.networkType ? params.networkType === "testnet" : false;
   }
@@ -3903,33 +4074,52 @@ var ScallopUtils = class {
     }
     if (lackPricesCoinNames.length > 0) {
       const endpoints = this.params.pythEndpoints ?? PYTH_ENDPOINTS[this.isTestnet ? "testnet" : "mainnet"];
-      try {
-        for (const endpoint of endpoints) {
-          try {
-            const pythConnection = new SuiPriceServiceConnection(endpoint);
-            const priceIds = lackPricesCoinNames.map(
-              (coinName) => this._address.get(`core.coins.${coinName}.oracle.pyth.feed`)
+      const failedRequests = new Set(
+        lackPricesCoinNames
+      );
+      for (const endpoint of endpoints) {
+        let hasFailRequest = false;
+        const pythConnection = new SuiPriceServiceConnection(endpoint);
+        const priceIds = Array.from(failedRequests.values()).reduce(
+          (acc, coinName) => {
+            const priceId = this._address.get(
+              `core.coins.${coinName}.oracle.pyth.feed`
             );
-            const priceFeeds = await pythConnection.getLatestPriceFeeds(priceIds) || [];
-            for (const [index, feed] of priceFeeds.entries()) {
-              const data = parseDataFromPythPriceFeed(feed, this._address);
-              const coinName = lackPricesCoinNames[index];
+            acc[coinName] = priceId;
+            return acc;
+          },
+          {}
+        );
+        for (const [coinName, priceId] of Object.entries(priceIds)) {
+          try {
+            const feed = await this._cache.queryClient.fetchQuery({
+              queryKey: [priceId],
+              queryFn: async () => {
+                return await pythConnection.getLatestPriceFeeds([priceId]);
+              }
+              // staleTime: 15000,
+            });
+            if (feed) {
+              const data = parseDataFromPythPriceFeed(feed[0], this._address);
               this._priceMap.set(coinName, {
                 price: data.price,
                 publishTime: data.publishTime
               });
               coinPrices[coinName] = data.price;
             }
-            break;
+            failedRequests.delete(coinName);
           } catch (e) {
             console.warn(
-              `Failed to update price feeds with endpoint ${endpoint}: ${e}`
+              `Failed to get price ${coinName} feeds with endpoint ${endpoint}: ${e}`
             );
+            hasFailRequest = true;
           }
-          throw new Error("Failed to update price feeds with all endpoins");
         }
-      } catch (_e) {
-        for (const coinName of lackPricesCoinNames) {
+        if (!hasFailRequest)
+          break;
+      }
+      if (failedRequests.size > 0) {
+        for (const coinName of failedRequests.values()) {
           const price = await this._query.getPriceFromPyth(coinName);
           this._priceMap.set(coinName, {
             price,
@@ -4002,7 +4192,7 @@ import { SuiKit as SuiKit3 } from "@scallop-io/sui-kit";
 // src/builders/coreBuilder.ts
 import { TransactionBlock } from "@mysten/sui.js/transactions";
 import { SUI_CLOCK_OBJECT_ID as SUI_CLOCK_OBJECT_ID2 } from "@mysten/sui.js/utils";
-import { SuiTxBlock as SuiKitTxBlock3 } from "@scallop-io/sui-kit";
+import { SuiTxBlock as SuiKitTxBlock } from "@scallop-io/sui-kit";
 
 // src/builders/oracle.ts
 import { SUI_CLOCK_OBJECT_ID } from "@mysten/sui.js/utils";
@@ -4437,7 +4627,7 @@ var generateCoreQuickMethod = ({
   };
 };
 var newCoreTxBlock = (builder, initTxBlock) => {
-  const txBlock = initTxBlock instanceof TransactionBlock ? new SuiKitTxBlock3(initTxBlock) : initTxBlock ? initTxBlock : new SuiKitTxBlock3();
+  const txBlock = initTxBlock instanceof TransactionBlock ? new SuiKitTxBlock(initTxBlock) : initTxBlock ? initTxBlock : new SuiKitTxBlock();
   const normalMethod = generateCoreNormalMethod({
     builder,
     txBlock
@@ -4467,7 +4657,7 @@ var newCoreTxBlock = (builder, initTxBlock) => {
 // src/builders/spoolBuilder.ts
 import { TransactionBlock as TransactionBlock2 } from "@mysten/sui.js/transactions";
 import { SUI_CLOCK_OBJECT_ID as SUI_CLOCK_OBJECT_ID3 } from "@mysten/sui.js/utils";
-import { SuiTxBlock as SuiKitTxBlock4 } from "@scallop-io/sui-kit";
+import { SuiTxBlock as SuiKitTxBlock2 } from "@scallop-io/sui-kit";
 var requireStakeAccountIds = async (...params) => {
   const [builder, txBlock, stakeMarketCoinName, stakeAccountId] = params;
   if (params.length === 4 && stakeAccountId)
@@ -4625,7 +4815,7 @@ var generateSpoolQuickMethod = ({
   };
 };
 var newSpoolTxBlock = (builder, initTxBlock) => {
-  const txBlock = initTxBlock instanceof TransactionBlock2 ? new SuiKitTxBlock4(initTxBlock) : initTxBlock ? initTxBlock : new SuiKitTxBlock4();
+  const txBlock = initTxBlock instanceof TransactionBlock2 ? new SuiKitTxBlock2(initTxBlock) : initTxBlock ? initTxBlock : new SuiKitTxBlock2();
   const normalMethod = generateSpoolNormalMethod({
     builder,
     txBlock
@@ -4655,13 +4845,13 @@ var newSpoolTxBlock = (builder, initTxBlock) => {
 // src/builders/borrowIncentiveBuilder.ts
 import { TransactionBlock as TransactionBlock4 } from "@mysten/sui.js/transactions";
 import { SUI_CLOCK_OBJECT_ID as SUI_CLOCK_OBJECT_ID5 } from "@mysten/sui.js/utils";
-import { SuiTxBlock as SuiKitTxBlock6 } from "@scallop-io/sui-kit";
+import { SuiTxBlock as SuiKitTxBlock4 } from "@scallop-io/sui-kit";
 
 // src/builders/vescaBuilder.ts
 import {
   SUI_CLOCK_OBJECT_ID as SUI_CLOCK_OBJECT_ID4,
   TransactionBlock as TransactionBlock3,
-  SuiTxBlock as SuiKitTxBlock5
+  SuiTxBlock as SuiKitTxBlock3
 } from "@scallop-io/sui-kit";
 var requireVeSca = async (...params) => {
   const [builder, txBlock, veScaKey] = params;
@@ -4904,7 +5094,7 @@ var generateQuickVeScaMethod = ({
   };
 };
 var newVeScaTxBlock = (builder, initTxBlock) => {
-  const txBlock = initTxBlock instanceof TransactionBlock3 ? new SuiKitTxBlock5(initTxBlock) : initTxBlock ? initTxBlock : new SuiKitTxBlock5();
+  const txBlock = initTxBlock instanceof TransactionBlock3 ? new SuiKitTxBlock3(initTxBlock) : initTxBlock ? initTxBlock : new SuiKitTxBlock3();
   const normalMethod = generateNormalVeScaMethod({
     builder,
     txBlock
@@ -5019,7 +5209,7 @@ var generateBorrowIncentiveNormalMethod = ({ builder, txBlock }) => {
       );
     },
     claimBorrowIncentive: (obligationId, obligationKey, coinName, rewardCoinName) => {
-      const rewardCoinNames = borrowIncentiveRewardCoins[coinName];
+      const rewardCoinNames = builder.utils.getBorrowIncentiveRewardCoinName(coinName);
       if (rewardCoinNames.includes(rewardCoinName) === false) {
         throw new Error(`Invalid reward coin name ${rewardCoinName}`);
       }
@@ -5146,7 +5336,7 @@ var generateBorrowIncentiveQuickMethod = ({ builder, txBlock }) => {
   };
 };
 var newBorrowIncentiveTxBlock = (builder, initTxBlock) => {
-  const txBlock = initTxBlock instanceof TransactionBlock4 ? new SuiKitTxBlock6(initTxBlock) : initTxBlock ? initTxBlock : new SuiKitTxBlock6();
+  const txBlock = initTxBlock instanceof TransactionBlock4 ? new SuiKitTxBlock4(initTxBlock) : initTxBlock ? initTxBlock : new SuiKitTxBlock4();
   const normalMethod = generateBorrowIncentiveNormalMethod({
     builder,
     txBlock
@@ -5201,18 +5391,24 @@ var ScallopBuilder = class {
   constructor(params, instance) {
     this.params = params;
     this.suiKit = instance?.suiKit ?? new SuiKit3(params);
-    this.address = instance?.address ?? new ScallopAddress({
-      id: params?.addressesId || ADDRESSES_ID,
-      network: params?.networkType
-    });
+    this.cache = instance?.cache ?? new ScallopCache(DEFAULT_CACHE_OPTIONS, this.suiKit);
+    this.address = instance?.address ?? new ScallopAddress(
+      {
+        id: params?.addressesId || ADDRESSES_ID,
+        network: params?.networkType
+      },
+      this.cache
+    );
     this.query = instance?.query ?? new ScallopQuery(params, {
       suiKit: this.suiKit,
-      address: this.address
+      address: this.address,
+      cache: this.cache
     });
     this.utils = instance?.utils ?? new ScallopUtils(this.params, {
       suiKit: this.suiKit,
       address: this.address,
-      query: this.query
+      query: this.query,
+      cache: this.cache
     });
     this.walletAddress = normalizeSuiAddress(
       params?.walletAddress || this.suiKit.currentAddress()
@@ -5294,24 +5490,31 @@ var ScallopClient = class {
   constructor(params, instance) {
     this.params = params;
     this.suiKit = instance?.suiKit ?? new SuiKit4(params);
-    this.address = instance?.address ?? new ScallopAddress({
-      id: params?.addressesId || ADDRESSES_ID,
-      network: params?.networkType
-    });
+    this.cache = instance?.cache ?? new ScallopCache(DEFAULT_CACHE_OPTIONS, this.suiKit);
+    this.address = instance?.address ?? new ScallopAddress(
+      {
+        id: params?.addressesId || ADDRESSES_ID,
+        network: params?.networkType
+      },
+      this.cache
+    );
     this.query = instance?.query ?? new ScallopQuery(params, {
       suiKit: this.suiKit,
-      address: this.address
+      address: this.address,
+      cache: this.cache
     });
     this.utils = instance?.utils ?? new ScallopUtils(params, {
       suiKit: this.suiKit,
       address: this.address,
-      query: this.query
+      query: this.query,
+      cache: this.cache
     });
     this.builder = instance?.builder ?? new ScallopBuilder(params, {
       suiKit: this.suiKit,
       address: this.address,
       query: this.query,
-      utils: this.utils
+      utils: this.utils,
+      cache: this.cache
     });
     this.walletAddress = normalizeSuiAddress2(
       params?.walletAddress || this.suiKit.currentAddress()
@@ -5817,13 +6020,20 @@ var ScallopClient = class {
 
 // src/models/scallop.ts
 var Scallop = class {
-  constructor(params) {
+  constructor(params, cacheOptions) {
     this.params = params;
     this.suiKit = new SuiKit5(params);
-    this._address = new ScallopAddress({
-      id: params?.addressesId || ADDRESSES_ID,
-      network: params?.networkType
-    });
+    this.cache = new ScallopCache(
+      cacheOptions ?? DEFAULT_CACHE_OPTIONS,
+      this.suiKit
+    );
+    this._address = new ScallopAddress(
+      {
+        id: params?.addressesId || ADDRESSES_ID,
+        network: params?.networkType
+      },
+      this.cache
+    );
   }
   /**
    * Get a scallop address instance that already has read addresses.
@@ -5845,7 +6055,8 @@ var Scallop = class {
       await this._address.read();
     const scallopBuilder = new ScallopBuilder(this.params, {
       suiKit: this.suiKit,
-      address: this._address
+      address: this._address,
+      cache: this.cache
     });
     return scallopBuilder;
   }
@@ -5860,7 +6071,7 @@ var Scallop = class {
       await this._address.read();
     const scallopClient = new ScallopClient(
       { ...this.params, walletAddress },
-      { suiKit: this.suiKit, address: this._address }
+      { suiKit: this.suiKit, address: this._address, cache: this.cache }
     );
     return scallopClient;
   }
@@ -5874,7 +6085,8 @@ var Scallop = class {
       await this._address.read();
     const scallopQuery = new ScallopQuery(this.params, {
       suiKit: this.suiKit,
-      address: this._address
+      address: this._address,
+      cache: this.cache
     });
     return scallopQuery;
   }
@@ -5884,7 +6096,9 @@ var Scallop = class {
    * @return Scallop Indexer.
    */
   async createScallopIndexer() {
-    const scallopIndexer = new ScallopIndexer();
+    const scallopIndexer = new ScallopIndexer(this.params, {
+      cache: this.cache
+    });
     return scallopIndexer;
   }
   /**
@@ -5897,7 +6111,8 @@ var Scallop = class {
       await this._address.read();
     const scallopUtils = new ScallopUtils(this.params, {
       suiKit: this.suiKit,
-      address: this._address
+      address: this._address,
+      cache: this.cache
     });
     return scallopUtils;
   }
@@ -5926,6 +6141,7 @@ export {
   Scallop,
   ScallopAddress,
   ScallopBuilder,
+  ScallopCache,
   ScallopClient,
   ScallopIndexer,
   ScallopQuery,