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

package/dist/index.js

@@ -53,6 +53,7 @@ __export(src_exports, {
   Scallop: () => Scallop,
   ScallopAddress: () => ScallopAddress,
   ScallopBuilder: () => ScallopBuilder,
+  ScallopCache: () => ScallopCache,
   ScallopClient: () => ScallopClient,
   ScallopIndexer: () => ScallopIndexer,
   ScallopQuery: () => ScallopQuery,
@@ -74,7 +75,10 @@ module.exports = __toCommonJS(src_exports);
 var API_BASE_URL = "https://sui.api.scallop.io";
 var SDK_API_BASE_URL = "https://sdk.api.scallop.io";
 var IS_VE_SCA_TEST = false;
-var ADDRESSES_ID = IS_VE_SCA_TEST ? "65fb07c39c845425d71d7b18" : "6601955b8b0024600a917079";
+var ADDRESSES_ID = IS_VE_SCA_TEST ? (
+  // ? ('65fb07c39c845425d71d7b18' as const)
+  "65fb07c39c845425d71d7b18"
+) : "664dfe22898c36c159e28bc8";
 var PROTOCOL_OBJECT_ID = IS_VE_SCA_TEST ? "0xc9f859f98ca352a11b97a038c4b4162bee437b8df8caa047990fe9cb03d4f778" : "0xefe8b36d5b2e43728cc323298626b83177803521d195cfb11e15b910e892fddf";
 var BORROW_FEE_PROTOCOL_ID = IS_VE_SCA_TEST ? "0xc9f859f98ca352a11b97a038c4b4162bee437b8df8caa047990fe9cb03d4f778" : "0xc38f849e81cfe46d4e4320f508ea7dda42934a329d5a6571bb4c3cb6ea63f5da";
 var SCA_COIN_TYPE = IS_VE_SCA_TEST ? `0x6cd813061a3adf3602b76545f076205f0c8e7ec1d3b1eab9a1da7992c18c0524::sca::SCA` : "0x7016aae72cfc67f2fadf55769c0a7dd54291a583b63051a5ed71081cce836ac6::sca::SCA";
@@ -258,13 +262,233 @@ var voloCoinIds = {
 
 // src/constants/vesca.ts
 var UNLOCK_ROUND_DURATION = 60 * 60 * 24;
-var MAX_LOCK_ROUNDS = IS_VE_SCA_TEST ? 9 : 1460;
+var MAX_LOCK_ROUNDS = 1460;
 var MAX_LOCK_DURATION = MAX_LOCK_ROUNDS * UNLOCK_ROUND_DURATION;
 var MIN_INITIAL_LOCK_AMOUNT = 1e10;
 var MIN_TOP_UP_AMOUNT = 1e9;
 
 // src/models/scallop.ts
-var import_sui_kit11 = require("@scallop-io/sui-kit");
+var import_sui_kit12 = require("@scallop-io/sui-kit");
+
+// src/models/scallopCache.ts
+var import_query_core = require("@tanstack/query-core");
+var import_sui_kit = require("@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 import_query_core.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 import_sui_kit.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);
+      }
+    });
+  }
+  async queryGetAllCoinBalances(owner) {
+    const queryKey = ["getAllCoinBalances", owner];
+    return this.queryClient.fetchQuery({
+      queryKey,
+      queryFn: async () => {
+        const allBalances = await this.suiKit.client().getAllBalances({ owner });
+        return allBalances.reduce(
+          (acc, coinBalance) => {
+            if (coinBalance.totalBalance !== "0") {
+              acc[(0, import_sui_kit.normalizeStructTag)(coinBalance.coinType)] = coinBalance.totalBalance;
+            }
+            return acc;
+          },
+          {}
+        );
+      }
+    });
+  }
+  async queryGetCoinBalance(input) {
+    const queryKey = ["getCoinBalance", input.owner, input.coinType];
+    return this.queryClient.fetchQuery({
+      queryKey,
+      queryFn: async () => {
+        if (!input.coinType)
+          return "0";
+        return (await this.queryGetAllCoinBalances(input.owner))[(0, import_sui_kit.normalizeStructTag)(input.coinType)] ?? "0";
+      }
+    });
+  }
+};
 
 // src/models/scallopAddress.ts
 var import_axios = __toESM(require("axios"));
@@ -278,6 +502,45 @@ var EMPTY_ADDRESSES = {
     coinDecimalsRegistry: "",
     obligationAccessStore: "",
     coins: {
+      cetus: {
+        id: "",
+        metaData: "",
+        treasury: "",
+        oracle: {
+          supra: "",
+          switchboard: "",
+          pyth: {
+            feed: "",
+            feedObject: ""
+          }
+        }
+      },
+      apt: {
+        id: "",
+        metaData: "",
+        treasury: "",
+        oracle: {
+          supra: "",
+          switchboard: "",
+          pyth: {
+            feed: "",
+            feedObject: ""
+          }
+        }
+      },
+      sol: {
+        id: "",
+        metaData: "",
+        treasury: "",
+        oracle: {
+          supra: "",
+          switchboard: "",
+          pyth: {
+            feed: "",
+            feedObject: ""
+          }
+        }
+      },
       btc: {
         id: "",
         metaData: "",
@@ -399,15 +662,8 @@ var EMPTY_ADDRESSES = {
     oracles: {
       xOracle: "",
       xOracleCap: "",
-      supra: {
-        registry: "",
-        registryCap: "",
-        holder: ""
-      },
-      switchboard: {
-        registry: "",
-        registryCap: ""
-      },
+      supra: { registry: "", registryCap: "", holder: "" },
+      switchboard: { registry: "", registryCap: "" },
       pyth: {
         registry: "",
         registryCap: "",
@@ -437,27 +693,25 @@ var EMPTY_ADDRESSES = {
         id: "",
         upgradeCap: ""
       },
-      query: {
+      protocolWhitelist: {
         id: "",
         upgradeCap: ""
       },
-      pyth: {
+      query: {
         id: "",
         upgradeCap: ""
       },
-      switchboard: {
+      supra: { id: "", upgradeCap: "" },
+      pyth: {
         id: "",
         upgradeCap: ""
       },
+      switchboard: { id: "", upgradeCap: "" },
       xOracle: {
         id: "",
         upgradeCap: ""
       },
-      // Deploy for faucet on testnet.
-      testCoin: {
-        id: "",
-        upgradeCap: ""
-      }
+      testCoin: { id: "", upgradeCap: "" }
     }
   },
   spool: {
@@ -497,34 +751,45 @@ var EMPTY_ADDRESSES = {
         id: "",
         rewardPoolId: ""
       }
-    }
+    },
+    config: ""
   },
   borrowIncentive: {
     id: "",
     adminCap: "",
     object: "",
     query: "",
-    config: "",
     incentivePools: "",
-    incentiveAccounts: ""
+    incentiveAccounts: "",
+    config: ""
   },
   vesca: {
     id: "",
+    object: "",
     adminCap: "",
     tableId: "",
     table: "",
     treasury: "",
     config: ""
+  },
+  referral: {
+    id: "",
+    version: "",
+    object: "",
+    adminCap: "",
+    referralBindings: "",
+    bindingTableId: "",
+    referralRevenuePool: "",
+    revenueTableId: "",
+    referralTiers: "",
+    tiersTableId: "",
+    authorizedWitnessList: ""
   }
 };
 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 = import_axios.default.create({
       baseURL: API_BASE_URL,
       headers: {
@@ -533,6 +798,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.
@@ -656,7 +926,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: {
@@ -693,14 +963,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
@@ -754,7 +1026,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: {
@@ -796,7 +1068,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",
@@ -818,8 +1090,8 @@ var ScallopAddress = class {
 };
 
 // src/models/scallopClient.ts
-var import_utils20 = require("@mysten/sui.js/utils");
-var import_sui_kit10 = require("@scallop-io/sui-kit");
+var import_utils21 = require("@mysten/sui.js/utils");
+var import_sui_kit11 = require("@scallop-io/sui-kit");
 
 // src/models/scallopUtils.ts
 var import_utils9 = require("@mysten/sui.js/utils");
@@ -831,8 +1103,6 @@ var import_sui_kit3 = require("@scallop-io/sui-kit");
 
 // src/queries/coreQuery.ts
 var import_utils2 = require("@mysten/sui.js/utils");
-var import_sui_kit = require("@scallop-io/sui-kit");
-var import_bignumber2 = __toESM(require("bignumber.js"));
 
 // src/utils/builder.ts
 var requireSender = (txBlock) => {
@@ -1380,13 +1650,16 @@ var findClosestUnlockRound = (unlockAtInSecondTimestamp) => {
 };
 
 // src/queries/coreQuery.ts
+var import_bignumber2 = __toESM(require("bignumber.js"));
 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 import_sui_kit.SuiTxBlock();
   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 = {};
@@ -1504,11 +1777,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 = {};
@@ -1541,11 +1811,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;
@@ -1566,7 +1833,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",
@@ -1581,7 +1848,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",
@@ -1596,7 +1863,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",
@@ -1610,7 +1877,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`,
@@ -1677,11 +1944,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 = {};
@@ -1714,11 +1978,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;
@@ -1737,7 +1998,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",
@@ -1752,7 +2013,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",
@@ -1808,7 +2069,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`
@@ -1824,7 +2085,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;
@@ -1838,12 +2099,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(
@@ -1855,182 +2114,60 @@ 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 import_sui_kit.SuiTxBlock();
-  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) => {
   assetCoinNames = assetCoinNames || [...SUPPORT_POOLS];
   const owner = ownerAddress || query.suiKit.currentAddress();
-  const coinObjectsResponse = [];
-  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
-    });
-    coinObjectsResponse.push(...paginatedCoinObjectsResponse.data);
-    if (paginatedCoinObjectsResponse.hasNextPage && paginatedCoinObjectsResponse.nextCursor) {
-      hasNextPage = true;
-      nextCursor = paginatedCoinObjectsResponse.nextCursor;
-    } else {
-      hasNextPage = false;
-    }
-  } while (hasNextPage);
-  const coinAmounts = {};
-  const coinObjects = coinObjectsResponse.map((response) => {
-    return response.data;
-  }).filter(
-    (object) => object !== void 0 && object !== null
+  const assetCoins2 = {};
+  await Promise.allSettled(
+    assetCoinNames.map(async (assetCoinName) => {
+      const marketCoin = await getCoinAmount(query, assetCoinName, owner);
+      assetCoins2[assetCoinName] = marketCoin;
+    })
   );
-  for (const coinObject of coinObjects) {
-    const type = coinObject.type;
-    if (coinObject.content && "fields" in coinObject.content) {
-      const fields = coinObject.content.fields;
-      const poolCoinName = query.utils.parseCoinNameFromType(type);
-      if (poolCoinName) {
-        coinAmounts[poolCoinName] = (0, import_bignumber2.default)(coinAmounts[poolCoinName] ?? 0).plus(fields.balance).toNumber();
-      }
-    }
-  }
-  return coinAmounts;
+  return assetCoins2;
 };
 var getCoinAmount = async (query, assetCoinName, ownerAddress) => {
   const owner = ownerAddress || query.suiKit.currentAddress();
   const coinType = query.utils.parseCoinType(assetCoinName);
-  const coinObjectsResponse = [];
-  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
-    });
-    coinObjectsResponse.push(...paginatedCoinObjectsResponse.data);
-    if (paginatedCoinObjectsResponse.hasNextPage && paginatedCoinObjectsResponse.nextCursor) {
-      hasNextPage = true;
-      nextCursor = paginatedCoinObjectsResponse.nextCursor;
-    } else {
-      hasNextPage = false;
-    }
-  } while (hasNextPage);
-  let coinAmount = 0;
-  const coinObjects = coinObjectsResponse.map((response) => {
-    return response.data;
-  }).filter(
-    (object) => object !== void 0 && object !== null
-  );
-  for (const coinObject of coinObjects) {
-    if (coinObject.content && "fields" in coinObject.content) {
-      const fields = coinObject.content.fields;
-      coinAmount = (0, import_bignumber2.default)(coinAmount).plus(fields.balance).toNumber();
-    }
-  }
-  return coinAmount;
+  const amount = await query.cache.queryGetCoinBalance({
+    owner,
+    coinType
+  });
+  return (0, import_bignumber2.default)(amount).toNumber();
 };
 var getMarketCoinAmounts = async (query, marketCoinNames, ownerAddress) => {
   marketCoinNames = marketCoinNames || [...SUPPORT_POOLS].map(
     (poolCoinName) => query.utils.parseMarketCoinName(poolCoinName)
   );
   const owner = ownerAddress || query.suiKit.currentAddress();
-  const marketCoinObjectsResponse = [];
-  let hasNextPage = false;
-  let nextCursor = null;
-  do {
-    const paginatedMarketCoinObjectsResponse = await query.suiKit.client().getOwnedObjects({
-      owner,
-      filter: {
-        MatchAny: marketCoinNames.map((marketCoinName) => {
-          const marketCoinType = query.utils.parseMarketCoinType(marketCoinName);
-          return { StructType: `0x2::coin::Coin<${marketCoinType}>` };
-        })
-      },
-      options: {
-        showType: true,
-        showContent: true
-      },
-      cursor: nextCursor
-    });
-    marketCoinObjectsResponse.push(...paginatedMarketCoinObjectsResponse.data);
-    if (paginatedMarketCoinObjectsResponse.hasNextPage && paginatedMarketCoinObjectsResponse.nextCursor) {
-      hasNextPage = true;
-      nextCursor = paginatedMarketCoinObjectsResponse.nextCursor;
-    } else {
-      hasNextPage = false;
-    }
-  } while (hasNextPage);
-  const marketCoinAmounts = {};
-  const marketCoinObjects = marketCoinObjectsResponse.map((response) => {
-    return response.data;
-  }).filter(
-    (object) => object !== void 0 && object !== null
+  const marketCoins2 = {};
+  Promise.allSettled(
+    marketCoinNames.map(async (marketCoinName) => {
+      const marketCoin = await getMarketCoinAmount(
+        query,
+        marketCoinName,
+        owner
+      );
+      marketCoins2[marketCoinName] = marketCoin;
+    })
   );
-  for (const marketCoinObject of marketCoinObjects) {
-    const marketCoinType = marketCoinObject.type;
-    if (marketCoinObject.content && "fields" in marketCoinObject.content) {
-      const fields = marketCoinObject.content.fields;
-      const marketCoinName = query.utils.parseCoinNameFromType(marketCoinType);
-      if (marketCoinName) {
-        marketCoinAmounts[marketCoinName] = (0, import_bignumber2.default)(
-          marketCoinAmounts[marketCoinName] ?? 0
-        ).plus(fields.balance).toNumber();
-      }
-    }
-  }
-  return marketCoinAmounts;
+  return marketCoins2;
 };
 var getMarketCoinAmount = async (query, marketCoinName, ownerAddress) => {
   const owner = ownerAddress || query.suiKit.currentAddress();
   const marketCoinType = query.utils.parseMarketCoinType(marketCoinName);
-  const marketCoinObjectsResponse = [];
-  let hasNextPage = false;
-  let nextCursor = null;
-  do {
-    const paginatedMarketCoinObjectsResponse = await query.suiKit.client().getOwnedObjects({
-      owner,
-      filter: { StructType: `0x2::coin::Coin<${marketCoinType}>` },
-      options: {
-        showContent: true
-      },
-      cursor: nextCursor
-    });
-    marketCoinObjectsResponse.push(...paginatedMarketCoinObjectsResponse.data);
-    if (paginatedMarketCoinObjectsResponse.hasNextPage && paginatedMarketCoinObjectsResponse.nextCursor) {
-      hasNextPage = true;
-      nextCursor = paginatedMarketCoinObjectsResponse.nextCursor;
-    } else {
-      hasNextPage = false;
-    }
-  } while (hasNextPage);
-  let marketCoinAmount = 0;
-  const marketCoinObjects = marketCoinObjectsResponse.map((response) => {
-    return response.data;
-  }).filter(
-    (object) => object !== void 0 && object !== null
-  );
-  for (const marketCoinObject of marketCoinObjects) {
-    if (marketCoinObject.content && "fields" in marketCoinObject.content) {
-      const fields = marketCoinObject.content.fields;
-      marketCoinAmount = (0, import_bignumber2.default)(marketCoinAmount).plus(fields.balance).toNumber();
-    }
-  }
-  return marketCoinAmount;
+  const amount = await query.cache.queryGetCoinBalance({
+    owner,
+    coinType: marketCoinType
+  });
+  return (0, import_bignumber2.default)(amount).toNumber();
 };
 
 // src/queries/spoolQuery.ts
@@ -2100,17 +2237,17 @@ var getSpool = async (query, marketCoinName, indexer = false, marketPool, coinPr
     spoolIndexer.rewardCoinPrice = coinPrices?.[rewardCoinName] || spoolIndexer.rewardCoinPrice;
     return spoolIndexer;
   }
-  const spoolObjectResponse = await query.suiKit.client().multiGetObjects({
-    ids: [poolId, rewardPoolId],
-    options: {
+  const spoolObjectResponse = await query.cache.queryGetObjects(
+    [poolId, rewardPoolId],
+    {
       showContent: true
     }
-  });
-  if (marketPool && spoolObjectResponse[0].data && spoolObjectResponse[1].data) {
+  );
+  if (marketPool && spoolObjectResponse[0] && spoolObjectResponse[1]) {
     const rewardCoinName = query.utils.getSpoolRewardCoinName(marketCoinName);
     coinPrices = coinPrices || await query.utils.getCoinPrices([coinName, rewardCoinName]);
-    const spoolObject = spoolObjectResponse[0].data;
-    const rewardPoolObject = spoolObjectResponse[1].data;
+    const spoolObject = spoolObjectResponse[0];
+    const rewardPoolObject = spoolObjectResponse[1];
     if (spoolObject.content && "fields" in spoolObject.content) {
       const spoolFields = spoolObject.content.fields;
       const parsedSpoolData = parseOriginSpoolData({
@@ -2182,7 +2319,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: {
@@ -2220,7 +2357,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;
@@ -2328,12 +2465,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;
@@ -2374,13 +2508,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;
@@ -2410,17 +2544,15 @@ var getStakeRewardPool = async (query, marketCoinName) => {
 
 // src/queries/borrowIncentiveQuery.ts
 var import_utils6 = require("@mysten/sui.js/utils");
-var import_sui_kit2 = require("@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 import_sui_kit2.SuiTxBlock();
   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) {
@@ -2497,9 +2629,8 @@ var queryBorrowIncentiveAccounts = async (query, obligationId, borrowIncentiveCo
     "borrowIncentive.incentiveAccounts"
   );
   const queryTarget = `${queryPkgId}::incentive_account_query::incentive_account_data`;
-  const txBlock = new import_sui_kit2.SuiTxBlock();
-  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
@@ -2517,7 +2648,7 @@ var queryBorrowIncentiveAccounts = async (query, obligationId, borrowIncentiveCo
 var getBindedObligationId = async (query, veScaKeyId) => {
   const borrowIncentiveObjectId = query.address.get("borrowIncentive.object");
   const incentivePoolsId = query.address.get("borrowIncentive.incentivePools");
-  const veScaPkgId = IS_VE_SCA_TEST ? "0xb220d034bdf335d77ae5bfbf6daf059c2cc7a1f719b12bfed75d1736fac038c8" : query.address.get("vesca.id");
+  const veScaObjId = query.address.get("vesca.object");
   const client = query.suiKit.client();
   const incentivePoolsResponse = await client.getObject({
     id: incentivePoolsId,
@@ -2529,7 +2660,7 @@ var getBindedObligationId = async (query, veScaKeyId) => {
     return null;
   const incentivePoolFields = incentivePoolsResponse.data.content.fields;
   const veScaBindTableId = incentivePoolFields.ve_sca_bind.fields.id.id;
-  const keyType = `${borrowIncentiveObjectId}::typed_id::TypedID<${veScaPkgId}::ve_sca::VeScaKey>`;
+  const keyType = `${borrowIncentiveObjectId}::typed_id::TypedID<${veScaObjId}::ve_sca::VeScaKey>`;
   const veScaBindTableResponse = await client.getDynamicFieldObject({
     parentId: veScaBindTableId,
     name: {
@@ -2573,18 +2704,13 @@ var getBindedVeScaKey = async (query, obliationId) => {
 };
 
 // src/queries/priceQuery.ts
-var getPythPrice = async (query, assetCoinName) => {
+var getPythPrice = async (query, assetCoinName, priceFeedObject) => {
   const pythFeedObjectId = query.address.get(
     `core.coins.${assetCoinName}.oracle.pyth.feedObject`
   );
-  const priceFeedObjectResponse = await query.suiKit.client().getObject({
-    id: pythFeedObjectId,
-    options: {
-      showContent: true
-    }
-  });
-  if (priceFeedObjectResponse.data) {
-    const priceFeedPoolObject = priceFeedObjectResponse.data;
+  priceFeedObject = priceFeedObject || (await query.cache.queryGetObject(pythFeedObjectId, { showContent: true })).data;
+  if (priceFeedObject) {
+    const priceFeedPoolObject = priceFeedObject;
     if (priceFeedPoolObject.content && "fields" in priceFeedPoolObject.content) {
       const fields = priceFeedPoolObject.content.fields;
       const expoMagnitude = Number(
@@ -2604,6 +2730,36 @@ var getPythPrice = async (query, assetCoinName) => {
   }
   return 0;
 };
+var getPythPrices = async (query, assetCoinNames) => {
+  const seen = {};
+  const pythFeedObjectIds = assetCoinNames.map((assetCoinName) => {
+    const pythFeedObjectId = query.address.get(
+      `core.coins.${assetCoinName}.oracle.pyth.feedObject`
+    );
+    if (seen[pythFeedObjectId])
+      return null;
+    seen[pythFeedObjectId] = true;
+    return pythFeedObjectId;
+  }).filter((item) => !!item);
+  const priceFeedObjects = await query.cache.queryGetObjects(
+    pythFeedObjectIds,
+    {
+      showContent: true
+    }
+  );
+  return (await Promise.all(
+    priceFeedObjects.map(async (priceFeedObject, idx) => ({
+      coinName: assetCoinNames[idx],
+      price: await getPythPrice(query, assetCoinNames[idx], priceFeedObject)
+    }))
+  )).reduce(
+    (prev, curr) => {
+      prev[curr.coinName] = curr.price;
+      return prev;
+    },
+    {}
+  );
+};
 
 // src/queries/portfolioQuery.ts
 var import_bignumber3 = __toESM(require("bignumber.js"));
@@ -3105,10 +3261,12 @@ var getTotalValueLocked = async (query, indexer = false) => {
 
 // src/queries/vescaQuery.ts
 var import_bignumber4 = __toESM(require("bignumber.js"));
+var import_sui_kit2 = require("@scallop-io/sui-kit");
+var import_bcs = require("@mysten/sui.js/bcs");
 var getVescaKeys = async (query, ownerAddress) => {
   const owner = ownerAddress || query.suiKit.currentAddress();
-  const veScaPkgId = IS_VE_SCA_TEST ? "0xb220d034bdf335d77ae5bfbf6daf059c2cc7a1f719b12bfed75d1736fac038c8" : query.address.get("vesca.id");
-  const veScaKeyType = `${veScaPkgId}::ve_sca::VeScaKey`;
+  const veScaObjId = query.address.get("vesca.object");
+  const veScaKeyType = `${veScaObjId}::ve_sca::VeScaKey`;
   const keyObjectsResponse = [];
   let hasNextPage = false;
   let nextCursor = null;
@@ -3134,19 +3292,21 @@ var getVescaKeys = async (query, ownerAddress) => {
 var getVeScas = async (query, ownerAddress) => {
   const keyObjectDatas = await getVescaKeys(query, ownerAddress);
   const keyObjectId = keyObjectDatas.map((data) => data.objectId);
-  const veScas = [];
-  for (const keyId of keyObjectId) {
+  const veScas = Array(keyObjectId.length).fill(null);
+  const tasks = keyObjectId.map(async (keyId, idx) => {
     const veSca = await getVeSca(query, keyId);
-    if (veSca)
-      veScas.push(veSca);
-  }
-  return veScas;
+    if (veSca) {
+      veScas[idx] = veSca;
+    }
+  });
+  await Promise.allSettled(tasks);
+  return veScas.filter(Boolean).sort((a, b) => a.currentVeScaBalance - b.currentVeScaBalance);
 };
 var getVeSca = async (query, veScaKeyId, ownerAddress) => {
-  const tableId = IS_VE_SCA_TEST ? "0xc607241e4a679fe376d1170b2fbe07b64917bfe69100d4825241cda20039d4bd" : query.address.get(`vesca.tableId`);
+  const tableId = 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",
@@ -3174,11 +3334,79 @@ var getVeSca = async (query, veScaKeyId, ownerAddress) => {
   }
   return vesca;
 };
+var getTotalVeScaTreasuryAmount = async (query) => {
+  const veScaPkgId = query.address.get("vesca.id");
+  const veScaConfig = query.address.get("vesca.config");
+  const veScaTreasury = query.address.get("vesca.treasury");
+  const refreshQueryTarget = `${veScaPkgId}::treasury::refresh`;
+  const refreshArgs = [veScaConfig, veScaTreasury, import_sui_kit2.SUI_CLOCK_OBJECT_ID];
+  const veScaAmountQueryTarget = `${veScaPkgId}::treasury::total_ve_sca_amount`;
+  const veScaAmountArgs = [veScaTreasury, import_sui_kit2.SUI_CLOCK_OBJECT_ID];
+  const resolvedRefreshArgs = await Promise.all(
+    refreshArgs.map(async (arg) => {
+      if (typeof arg === "string") {
+        return (await query.cache.queryGetObject(arg, { showContent: true })).data;
+      }
+      return arg;
+    })
+  );
+  const resolvedVeScaAmountArgs = await Promise.all(
+    veScaAmountArgs.map(async (arg) => {
+      if (typeof arg === "string") {
+        return (await query.cache.queryGetObject(arg, { showContent: true })).data;
+      }
+      return arg;
+    })
+  );
+  const txb = new import_sui_kit2.SuiTxBlock();
+  txb.moveCall(refreshQueryTarget, resolvedRefreshArgs);
+  txb.moveCall(veScaAmountQueryTarget, resolvedVeScaAmountArgs);
+  const txBytes = await txb.txBlock.build({
+    client: query.suiKit.client(),
+    onlyTransactionKind: true,
+    protocolConfig: await query.cache.getProtocolConfig()
+  });
+  const res = await query.cache.queryClient.fetchQuery({
+    queryKey: [
+      "getTotalVeScaTreasuryAmount",
+      JSON.stringify([...refreshArgs, ...veScaAmountArgs])
+    ],
+    queryFn: async () => {
+      return await query.suiKit.inspectTxn(txBytes);
+    },
+    staleTime: 8e3
+  });
+  const results = res.results;
+  if (results && results[1].returnValues) {
+    const value = Uint8Array.from(results[1].returnValues[0][0]);
+    const type = results[1].returnValues[0][1];
+    return import_bcs.bcs.de(type, value);
+  }
+  return "0";
+};
+
+// src/queries/referralQuery.ts
+var queryVeScaKeyIdFromReferralBindings = async (query, refereeAddress) => {
+  const referralBindingTableId = query.address.get("referral.bindingTableId");
+  const referralBindResponse = await query.cache.queryGetDynamicFieldObject({
+    parentId: referralBindingTableId,
+    name: {
+      type: "address",
+      value: refereeAddress
+    }
+  });
+  if (referralBindResponse.data?.content?.dataType !== "moveObject")
+    return null;
+  const fields = referralBindResponse.data.content.fields;
+  return fields.value;
+};
 
 // src/models/scallopIndexer.ts
 var import_axios2 = __toESM(require("axios"));
 var ScallopIndexer = class {
-  constructor() {
+  constructor(params, instance) {
+    this.params = params;
+    this._cache = instance?.cache ?? new ScallopCache();
     this._requestClient = import_axios2.default.create({
       baseURL: SDK_API_BASE_URL,
       headers: {
@@ -3194,7 +3422,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) => {
@@ -3219,15 +3452,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.
@@ -3235,12 +3461,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.
@@ -3248,18 +3469,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.
@@ -3267,12 +3477,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.
@@ -3280,7 +3485,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;
@@ -3296,12 +3506,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.
@@ -3309,7 +3514,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) => {
@@ -3328,14 +3538,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.
@@ -3343,7 +3546,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 {
@@ -3357,16 +3565,21 @@ var ScallopQuery = class {
   constructor(params, instance) {
     this.params = params;
     this.suiKit = instance?.suiKit ?? new import_sui_kit3.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.
@@ -3506,6 +3719,15 @@ var ScallopQuery = class {
   async getPriceFromPyth(assetCoinName) {
     return await getPythPrice(this, assetCoinName);
   }
+  /**
+   * Get prices from pyth fee object.
+   *
+   * @param assetCoinNames - Array of supported asset coin names.
+   * @return Array of asset coin prices.
+   */
+  async getPricesFromPyth(assetCoinNames) {
+    return await getPythPrices(this, assetCoinNames);
+  }
   /* ==================== Spool Query Methods ==================== */
   /**
    * Get spools data.
@@ -3704,6 +3926,29 @@ var ScallopQuery = class {
   async getTvl(indexer = false) {
     return await getTotalValueLocked(this, indexer);
   }
+  /**
+   * Get all veSca from walletAdddress
+   * @param walletAddress
+   * @returns array of veSca
+   */
+  async getVeScas(walletAddress) {
+    return await getVeScas(this, walletAddress);
+  }
+  /**
+   * Get total vesca treasury with movecall
+   * @returns Promise<string | undefined>
+   */
+  async getTotalVeScaTreasuryAmount() {
+    return await getTotalVeScaTreasuryAmount(this);
+  }
+  /**
+   * Return binded veScaKeyId of walletAddress if exist
+   * @param walletAddress
+   * @returns veScaKeyId
+   */
+  async getVeScaKeyIdFromReferralBindings(walletAddress) {
+    return await queryVeScaKeyIdFromReferralBindings(this, walletAddress);
+  }
   /**
    * Get binded obligationId from a veScaKey if it exists.
    * @param veScaKey
@@ -3752,13 +3997,18 @@ var ScallopUtils = class {
     };
     this.params = params;
     this._suiKit = instance?.suiKit ?? new import_sui_kit4.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._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;
   }
@@ -3975,40 +4225,60 @@ 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 import_pyth_sui_js.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) {
+        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];
-              this._priceMap.set(coinName, {
-                price: data.price,
-                publishTime: data.publishTime
+            acc[coinName] = priceId;
+            return acc;
+          },
+          {}
+        );
+        await Promise.allSettled(
+          Object.entries(priceIds).map(async ([coinName, priceId]) => {
+            const pythConnection = new import_pyth_sui_js.SuiPriceServiceConnection(endpoint);
+            try {
+              const feed = await this._cache.queryClient.fetchQuery({
+                queryKey: [priceId],
+                queryFn: async () => {
+                  return await pythConnection.getLatestPriceFeeds([priceId]);
+                }
               });
-              coinPrices[coinName] = data.price;
+              if (feed) {
+                const data = parseDataFromPythPriceFeed(feed[0], this._address);
+                this._priceMap.set(coinName, {
+                  price: data.price,
+                  publishTime: data.publishTime
+                });
+                coinPrices[coinName] = data.price;
+              }
+              failedRequests.delete(coinName);
+            } catch (e) {
+              console.warn(
+                `Failed to get price ${coinName} feeds with endpoint ${endpoint}: ${e}`
+              );
             }
-            break;
-          } catch (e) {
-            console.warn(
-              `Failed to update price feeds with endpoint ${endpoint}: ${e}`
-            );
-          }
-          throw new Error("Failed to update price feeds with all endpoins");
-        }
-      } catch (_e) {
-        for (const coinName of lackPricesCoinNames) {
-          const price = await this._query.getPriceFromPyth(coinName);
-          this._priceMap.set(coinName, {
-            price,
-            publishTime: Date.now()
-          });
-          coinPrices[coinName] = price;
-        }
+          })
+        );
+        if (failedRequests.size === 0)
+          break;
+      }
+      if (failedRequests.size > 0) {
+        await Promise.allSettled(
+          Array.from(failedRequests.values()).map(async (coinName) => {
+            const price = await this._query.getPriceFromPyth(coinName);
+            this._priceMap.set(coinName, {
+              price,
+              publishTime: Date.now()
+            });
+            coinPrices[coinName] = price;
+          })
+        );
       }
     }
     return coinPrices;
@@ -4068,8 +4338,8 @@ var ScallopUtils = class {
 };
 
 // src/models/scallopBuilder.ts
-var import_utils19 = require("@mysten/sui.js/utils");
-var import_sui_kit9 = require("@scallop-io/sui-kit");
+var import_utils20 = require("@mysten/sui.js/utils");
+var import_sui_kit10 = require("@scallop-io/sui-kit");
 
 // src/builders/coreBuilder.ts
 var import_transactions = require("@mysten/sui.js/transactions");
@@ -4244,6 +4514,8 @@ var generateCoreNormalMethod = ({
     coinDecimalsRegistry: builder.address.get("core.coinDecimalsRegistry"),
     xOracle: builder.address.get("core.oracles.xOracle")
   };
+  const referralPkgId = builder.address.get("referral.id");
+  const referralWitnessType = `${referralPkgId}::scallop_referral_program::REFERRAL_WITNESS`;
   return {
     openObligation: () => txBlock.moveCall(
       `${coreIds.protocolPkg}::open_obligation::open_obligation`,
@@ -4331,6 +4603,24 @@ var generateCoreNormalMethod = ({
         [coinType]
       );
     },
+    borrowWithReferral: (obligation, obligationKey, borrowReferral, amount, poolCoinName) => {
+      const coinType = builder.utils.parseCoinType(poolCoinName);
+      return txBlock.moveCall(
+        `${coreIds.protocolPkg}::borrow::borrow_with_referral`,
+        [
+          coreIds.version,
+          obligation,
+          obligationKey,
+          coreIds.market,
+          coreIds.coinDecimalsRegistry,
+          borrowReferral,
+          amount,
+          coreIds.xOracle,
+          import_utils12.SUI_CLOCK_OBJECT_ID
+        ],
+        [coinType, referralWitnessType]
+      );
+    },
     borrowEntry: (obligation, obligationKey, amount, poolCoinName) => {
       const coinType = builder.utils.parseCoinType(poolCoinName);
       return txBlock.moveCall(
@@ -4471,6 +4761,26 @@ var generateCoreQuickMethod = ({
         poolCoinName
       );
     },
+    borrowWithReferralQuick: async (amount, poolCoinName, borrowReferral, obligationId, obligationKey) => {
+      const obligationInfo = await requireObligationInfo(
+        builder,
+        txBlock,
+        obligationId,
+        obligationKey
+      );
+      const obligationCoinNames = await builder.utils.getObligationCoinNames(
+        obligationInfo.obligationId
+      );
+      const updateCoinNames = [...obligationCoinNames, poolCoinName];
+      await updateOracles(builder, txBlock, updateCoinNames);
+      return txBlock.borrowWithReferral(
+        obligationInfo.obligationId,
+        obligationInfo.obligationKey,
+        borrowReferral,
+        amount,
+        poolCoinName
+      );
+    },
     repayQuick: async (amount, poolCoinName, obligationId) => {
       const sender = requireSender(txBlock);
       const obligationInfo = await requireObligationInfo(
@@ -4742,10 +5052,7 @@ var requireVeSca = async (...params) => {
   if (veScas.length === 0) {
     return void 0;
   }
-  return veScas.reduce(
-    (prev, acc) => acc.currentVeScaBalance > prev.currentVeScaBalance ? acc : prev,
-    veScas[0]
-  );
+  return veScas[0];
 };
 var generateNormalVeScaMethod = ({
   builder,
@@ -4827,6 +5134,13 @@ var generateNormalVeScaMethod = ({
         ],
         []
       );
+    },
+    mintEmptyVeSca: () => {
+      return txBlock.moveCall(
+        `${veScaIds.pkgId}::ve_sca::mint_ve_sca_placeholder_key`,
+        [veScaIds.config, veScaIds.table],
+        []
+      );
     }
   };
 };
@@ -5022,7 +5336,7 @@ var requireObligationInfo2 = async (...params) => {
 };
 var generateBorrowIncentiveNormalMethod = ({ builder, txBlock }) => {
   const borrowIncentiveIds = {
-    borrowIncentivePkg: IS_VE_SCA_TEST ? "0x4d5a7cefa4147b4ace0ca845b20437d6ac0d32e5f2f855171f745472c2576246" : builder.address.get("borrowIncentive.id"),
+    borrowIncentivePkg: builder.address.get("borrowIncentive.id"),
     query: builder.address.get("borrowIncentive.query"),
     config: builder.address.get("borrowIncentive.config"),
     incentivePools: builder.address.get("borrowIncentive.incentivePools"),
@@ -5084,7 +5398,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}`);
       }
@@ -5131,9 +5445,7 @@ var generateBorrowIncentiveQuickMethod = ({ builder, txBlock }) => {
         obligationKey
       );
       const unstakeObligationBeforeStake = !!txBlock.txBlock.blockData.transactions.find(
-        (txn) => txn.kind === "MoveCall" && (txn.target === `${OLD_BORROW_INCENTIVE_PROTOCOL_ID}::user::unstake` || txn.target === (IS_VE_SCA_TEST ? `${"0x4d5a7cefa4147b4ace0ca845b20437d6ac0d32e5f2f855171f745472c2576246"}::user::unstake` : `${builder.address.get(
-          "borrowIncentive.id"
-        )}::user::unstake`))
+        (txn) => txn.kind === "MoveCall" && (txn.target === `${OLD_BORROW_INCENTIVE_PROTOCOL_ID}::user::unstake` || txn.target === `${builder.address.get("borrowIncentive.id")}::user::unstake`)
       );
       if (!obligationLocked || unstakeObligationBeforeStake) {
         txBlock.stakeObligation(obligationArg, obligationtKeyArg);
@@ -5151,9 +5463,7 @@ var generateBorrowIncentiveQuickMethod = ({ builder, txBlock }) => {
         obligationKey
       );
       const unstakeObligationBeforeStake = !!txBlock.txBlock.blockData.transactions.find(
-        (txn) => txn.kind === "MoveCall" && (txn.target === `${OLD_BORROW_INCENTIVE_PROTOCOL_ID}::user::unstake` || txn.target === (IS_VE_SCA_TEST ? `${"0x4d5a7cefa4147b4ace0ca845b20437d6ac0d32e5f2f855171f745472c2576246"}::user::unstake` : `${builder.address.get(
-          "borrowIncentive.id"
-        )}::user::unstake`))
+        (txn) => txn.kind === "MoveCall" && (txn.target === `${OLD_BORROW_INCENTIVE_PROTOCOL_ID}::user::unstake` || txn.target === `${builder.address.get("borrowIncentive.id")}::user::unstake`)
       );
       if (!obligationLocked || unstakeObligationBeforeStake) {
         const veSca = await requireVeSca(builder, txBlock, veScaKey);
@@ -5162,7 +5472,7 @@ var generateBorrowIncentiveQuickMethod = ({ builder, txBlock }) => {
             builder.query,
             veSca.keyId
           );
-          if (!bindedObligationId || bindedObligationId === obligationArg) {
+          if ((!bindedObligationId || bindedObligationId === obligationArg) && veSca.currentVeScaBalance > 0) {
             txBlock.stakeObligationWithVesca(
               obligationArg,
               obligationtKeyArg,
@@ -5238,6 +5548,138 @@ var newBorrowIncentiveTxBlock = (builder, initTxBlock) => {
   });
 };
 
+// src/builders/referralBuilder.ts
+var import_sui_kit9 = require("@scallop-io/sui-kit");
+var generateReferralNormalMethod = ({
+  builder,
+  txBlock
+}) => {
+  const referralIds = {
+    referralPgkId: builder.address.get("referral.id"),
+    referralBindings: builder.address.get("referral.referralBindings"),
+    referralRevenuePool: builder.address.get("referral.referralRevenuePool"),
+    authorizedWitnessList: builder.address.get(
+      "referral.authorizedWitnessList"
+    ),
+    referralTiers: builder.address.get("referral.referralTiers"),
+    version: builder.address.get("referral.version")
+  };
+  const veScaTable = builder.address.get("vesca.table");
+  return {
+    bindToReferral: (veScaKeyId) => {
+      return txBlock.moveCall(
+        `${referralIds.referralPgkId}::referral_bindings::bind_ve_sca_referrer`,
+        [
+          referralIds.referralBindings,
+          txBlock.pure(veScaKeyId),
+          veScaTable,
+          import_sui_kit9.SUI_CLOCK_OBJECT_ID
+        ],
+        []
+      );
+    },
+    claimReferralTicket: (poolCoinName) => {
+      const coinType = builder.utils.parseCoinType(poolCoinName);
+      return txBlock.moveCall(
+        `${referralIds.referralPgkId}::scallop_referral_program::claim_ve_sca_referral_ticket`,
+        [
+          referralIds.version,
+          veScaTable,
+          referralIds.referralBindings,
+          referralIds.authorizedWitnessList,
+          referralIds.referralTiers,
+          import_sui_kit9.SUI_CLOCK_OBJECT_ID
+        ],
+        [coinType]
+      );
+    },
+    burnReferralTicket: (ticket, poolCoinName) => {
+      const coinType = builder.utils.parseCoinType(poolCoinName);
+      return txBlock.moveCall(
+        `${referralIds.referralPgkId}::scallop_referral_program::burn_ve_sca_referral_ticket`,
+        [
+          referralIds.version,
+          ticket,
+          referralIds.referralRevenuePool,
+          import_sui_kit9.SUI_CLOCK_OBJECT_ID
+        ],
+        [coinType]
+      );
+    },
+    claimReferralRevenue: (veScaKey, poolCoinName) => {
+      const coinType = builder.utils.parseCoinType(poolCoinName);
+      return txBlock.moveCall(
+        `${referralIds.referralPgkId}::referral_revenue_pool::claim_revenue_with_ve_sca_key`,
+        [
+          referralIds.version,
+          referralIds.referralRevenuePool,
+          veScaKey,
+          import_sui_kit9.SUI_CLOCK_OBJECT_ID
+        ],
+        [coinType]
+      );
+    }
+  };
+};
+var generateReferralQuickMethod = ({
+  builder,
+  txBlock
+}) => {
+  return {
+    claimReferralRevenueQuick: async (veScaKey, coinNames = [...SUPPORT_POOLS]) => {
+      const sender = requireSender(txBlock);
+      const objToTransfer = [];
+      for (const coinName of coinNames) {
+        if (coinName === "sui") {
+          const rewardCoin = txBlock.claimReferralRevenue(veScaKey, coinName);
+          objToTransfer.push(rewardCoin);
+        } else {
+          const coins = await builder.suiKit.suiInteractor.selectCoins(
+            sender,
+            Infinity,
+            builder.utils.parseCoinType(coinName)
+          );
+          const rewardCoin = txBlock.claimReferralRevenue(veScaKey, coinName);
+          if (coins.length > 0) {
+            txBlock.mergeCoins(rewardCoin, coins);
+          }
+          objToTransfer.push(rewardCoin);
+        }
+      }
+      if (objToTransfer.length > 0) {
+        txBlock.transferObjects(objToTransfer, sender);
+      }
+    }
+  };
+};
+var newReferralTxBlock = (builder, initTxBlock) => {
+  const txBlock = initTxBlock instanceof import_sui_kit9.TransactionBlock ? new import_sui_kit9.SuiTxBlock(initTxBlock) : initTxBlock ? initTxBlock : new import_sui_kit9.SuiTxBlock();
+  const normalMethod = generateReferralNormalMethod({
+    builder,
+    txBlock
+  });
+  const normalTxBlock = new Proxy(txBlock, {
+    get: (target, prop) => {
+      if (prop in normalMethod) {
+        return Reflect.get(normalMethod, prop);
+      }
+      return Reflect.get(target, prop);
+    }
+  });
+  const quickMethod = generateReferralQuickMethod({
+    builder,
+    txBlock: normalTxBlock
+  });
+  return new Proxy(normalTxBlock, {
+    get: (target, prop) => {
+      if (prop in quickMethod) {
+        return Reflect.get(quickMethod, prop);
+      }
+      return Reflect.get(target, prop);
+    }
+  });
+};
+
 // src/builders/index.ts
 var newScallopTxBlock = (builder, initTxBlock) => {
   const vescaTxBlock = newVeScaTxBlock(builder, initTxBlock);
@@ -5245,7 +5687,8 @@ var newScallopTxBlock = (builder, initTxBlock) => {
     builder,
     vescaTxBlock
   );
-  const spoolTxBlock = newSpoolTxBlock(builder, borrowIncentiveTxBlock);
+  const referralTxBlock = newReferralTxBlock(builder, borrowIncentiveTxBlock);
+  const spoolTxBlock = newSpoolTxBlock(builder, referralTxBlock);
   const coreTxBlock = newCoreTxBlock(builder, spoolTxBlock);
   return new Proxy(coreTxBlock, {
     get: (target, prop) => {
@@ -5253,6 +5696,8 @@ var newScallopTxBlock = (builder, initTxBlock) => {
         return Reflect.get(vescaTxBlock, prop);
       } else if (prop in borrowIncentiveTxBlock) {
         return Reflect.get(borrowIncentiveTxBlock, prop);
+      } else if (prop in referralTxBlock) {
+        return Reflect.get(referralTxBlock, prop);
       } else if (prop in spoolTxBlock) {
         return Reflect.get(spoolTxBlock, prop);
       }
@@ -5265,21 +5710,27 @@ var newScallopTxBlock = (builder, initTxBlock) => {
 var ScallopBuilder = class {
   constructor(params, instance) {
     this.params = params;
-    this.suiKit = instance?.suiKit ?? new import_sui_kit9.SuiKit(params);
-    this.address = instance?.address ?? new ScallopAddress({
-      id: params?.addressesId || ADDRESSES_ID,
-      network: params?.networkType
-    });
+    this.suiKit = instance?.suiKit ?? new import_sui_kit10.SuiKit(params);
+    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 = (0, import_utils19.normalizeSuiAddress)(
+    this.walletAddress = (0, import_utils20.normalizeSuiAddress)(
       params?.walletAddress || this.suiKit.currentAddress()
     );
     this.isTestnet = params.networkType ? params.networkType === "testnet" : false;
@@ -5358,27 +5809,34 @@ var ScallopBuilder = class {
 var ScallopClient = class {
   constructor(params, instance) {
     this.params = params;
-    this.suiKit = instance?.suiKit ?? new import_sui_kit10.SuiKit(params);
-    this.address = instance?.address ?? new ScallopAddress({
-      id: params?.addressesId || ADDRESSES_ID,
-      network: params?.networkType
-    });
+    this.suiKit = instance?.suiKit ?? new import_sui_kit11.SuiKit(params);
+    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 = (0, import_utils20.normalizeSuiAddress)(
+    this.walletAddress = (0, import_utils21.normalizeSuiAddress)(
       params?.walletAddress || this.suiKit.currentAddress()
     );
   }
@@ -5882,13 +6340,20 @@ var ScallopClient = class {
 
 // src/models/scallop.ts
 var Scallop = class {
-  constructor(params) {
+  constructor(params, cacheOptions) {
     this.params = params;
-    this.suiKit = new import_sui_kit11.SuiKit(params);
-    this._address = new ScallopAddress({
-      id: params?.addressesId || ADDRESSES_ID,
-      network: params?.networkType
-    });
+    this.suiKit = new import_sui_kit12.SuiKit(params);
+    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.
@@ -5910,7 +6375,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;
   }
@@ -5925,7 +6391,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;
   }
@@ -5939,7 +6405,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;
   }
@@ -5949,7 +6416,9 @@ var Scallop = class {
    * @return Scallop Indexer.
    */
   async createScallopIndexer() {
-    const scallopIndexer = new ScallopIndexer();
+    const scallopIndexer = new ScallopIndexer(this.params, {
+      cache: this.cache
+    });
     return scallopIndexer;
   }
   /**
@@ -5962,7 +6431,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;
   }
@@ -5992,6 +6462,7 @@ var Scallop = class {
   Scallop,
   ScallopAddress,
   ScallopBuilder,
+  ScallopCache,
   ScallopClient,
   ScallopIndexer,
   ScallopQuery,