@eulerxyz/euler-v2-sdk 0.2.2-beta → 0.2.4-beta

package/dist/src/entities/SecuritizeCollateralVault.js

@@ -18,5 +18,9 @@ export class SecuritizeCollateralVault extends ERC4626Vault {
     convertToShares(assets) {
         return assets;
     }
+    /** 1:1 conversion (rounding-up is a no-op when totalShares === totalAssets). */
+    previewWithdraw(assets) {
+        return assets;
+    }
 }
 //# sourceMappingURL=SecuritizeCollateralVault.js.map

package/dist/src/entities/SecuritizeCollateralVault.js.map

@@ -1 +1 @@
-{"version":3,"file":"SecuritizeCollateralVault.js","sourceRoot":"","sources":["../../../src/entities/SecuritizeCollateralVault.ts"],"names":[],"mappings":"AACA,OAAO,EACN,YAAY,GAGZ,MAAM,mBAAmB,CAAC;AAO3B,MAAM,OAAO,yBACZ,SAAQ,YAAY;IAGpB,QAAQ,CAAU;IAClB,SAAS,CAAS;IAElB,YAAY,IAAgC;QAC3C,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IACjC,CAAC;IAED,IAAa,YAAY;QACxB,OAAO,KAAK,CAAC;IACd,CAAC;IAED,0EAA0E;IACjE,eAAe,CAAC,MAAc;QACtC,OAAO,MAAM,CAAC;IACf,CAAC;IAED,0EAA0E;IACjE,eAAe,CAAC,MAAc;QACtC,OAAO,MAAM,CAAC;IACf,CAAC;CACD"}
+{"version":3,"file":"SecuritizeCollateralVault.js","sourceRoot":"","sources":["../../../src/entities/SecuritizeCollateralVault.ts"],"names":[],"mappings":"AACA,OAAO,EACN,YAAY,GAGZ,MAAM,mBAAmB,CAAC;AAO3B,MAAM,OAAO,yBACZ,SAAQ,YAAY;IAGpB,QAAQ,CAAU;IAClB,SAAS,CAAS;IAElB,YAAY,IAAgC;QAC3C,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IACjC,CAAC;IAED,IAAa,YAAY;QACxB,OAAO,KAAK,CAAC;IACd,CAAC;IAED,0EAA0E;IACjE,eAAe,CAAC,MAAc;QACtC,OAAO,MAAM,CAAC;IACf,CAAC;IAED,0EAA0E;IACjE,eAAe,CAAC,MAAc;QACtC,OAAO,MAAM,CAAC;IACf,CAAC;IAED,gFAAgF;IACvE,eAAe,CAAC,MAAc;QACtC,OAAO,MAAM,CAAC;IACf,CAAC;CACD"}

package/dist/src/index.d.ts

@@ -31,6 +31,7 @@ export * from "./services/rewardsService/index.js";
 export * from "./services/intrinsicApyService/index.js";
 export * from "./services/oracleAdapterService/index.js";
 export * from "./services/feeFlowService/index.js";
+export * from "./services/reulLockService/index.js";
 export * from "./plugins/index.js";
 export * from "./utils/subAccounts.js";
 export * from "./utils/accountPositionClassification.js";
@@ -42,6 +43,7 @@ export * from "./utils/oracle.js";
 export * from "./utils/accountComputations.js";
 export * from "./utils/callBundler.js";
 export * from "./utils/entityDiagnostics.js";
+export * from "./utils/fallbackAdapter.js";
 export * from "./utils/normalization.js";
 export * from "./utils/parsing.js";
 export * from "./utils/decodeSmartContractErrors.js";

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yCAAyC,CAAC;AACxD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,qCAAqC,EAAE,MAAM,wBAAwB,CAAC;AAC/E,+CAA+C;AAC/C,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG9D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,mCAAmC,CAAC;AAClD,cAAc,uCAAuC,CAAC;AACtD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC;AACzD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC;AACnD,cAAc,yCAAyC,CAAC;AACxD,cAAc,0CAA0C,CAAC;AACzD,cAAc,oCAAoC,CAAC;AAGnD,cAAc,oBAAoB,CAAC;AAGnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0CAA0C,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,eAAe,EACf,0BAA0B,EAC1B,mBAAmB,EACnB,2BAA2B,EAC3B,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAChF,cAAc,iCAAiC,CAAC;AAChD,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yCAAyC,CAAC;AACxD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,qCAAqC,EAAE,MAAM,wBAAwB,CAAC;AAC/E,+CAA+C;AAC/C,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG9D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,mCAAmC,CAAC;AAClD,cAAc,uCAAuC,CAAC;AACtD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC;AACzD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC;AACnD,cAAc,yCAAyC,CAAC;AACxD,cAAc,0CAA0C,CAAC;AACzD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AAGpD,cAAc,oBAAoB,CAAC;AAGnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0CAA0C,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,eAAe,EACf,0BAA0B,EAC1B,mBAAmB,EACnB,2BAA2B,EAC3B,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAChF,cAAc,iCAAiC,CAAC;AAChD,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC"}

package/dist/src/index.js

@@ -32,6 +32,7 @@ export * from "./services/rewardsService/index.js";
 export * from "./services/intrinsicApyService/index.js";
 export * from "./services/oracleAdapterService/index.js";
 export * from "./services/feeFlowService/index.js";
+export * from "./services/reulLockService/index.js";
 // Plugins
 export * from "./plugins/index.js";
 // Utils
@@ -44,6 +45,7 @@ export * from "./utils/oracle.js";
 export * from "./utils/accountComputations.js";
 export * from "./utils/callBundler.js";
 export * from "./utils/entityDiagnostics.js";
+export * from "./utils/fallbackAdapter.js";
 export * from "./utils/normalization.js";
 export * from "./utils/parsing.js";
 export * from "./utils/decodeSmartContractErrors.js";

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yCAAyC,CAAC;AACxD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,qCAAqC,EAAE,MAAM,wBAAwB,CAAC;AAC/E,+CAA+C;AAC/C,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE9D,WAAW;AACX,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,mCAAmC,CAAC;AAClD,cAAc,uCAAuC,CAAC;AACtD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC;AACzD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC;AACnD,cAAc,yCAAyC,CAAC;AACxD,cAAc,0CAA0C,CAAC;AACzD,cAAc,oCAAoC,CAAC;AAEnD,UAAU;AACV,cAAc,oBAAoB,CAAC;AAEnC,QAAQ;AACR,cAAc,wBAAwB,CAAC;AACvC,cAAc,0CAA0C,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAIL,eAAe,EACf,0BAA0B,EAC1B,mBAAmB,EACnB,2BAA2B,EAC3B,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,cAAc,iCAAiC,CAAC;AAChD,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yCAAyC,CAAC;AACxD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,qCAAqC,EAAE,MAAM,wBAAwB,CAAC;AAC/E,+CAA+C;AAC/C,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE9D,WAAW;AACX,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,mCAAmC,CAAC;AAClD,cAAc,uCAAuC,CAAC;AACtD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC;AACzD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC;AACnD,cAAc,yCAAyC,CAAC;AACxD,cAAc,0CAA0C,CAAC;AACzD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AAEpD,UAAU;AACV,cAAc,oBAAoB,CAAC;AAEnC,QAAQ;AACR,cAAc,wBAAwB,CAAC;AACvC,cAAc,0CAA0C,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAIL,eAAe,EACf,0BAA0B,EAC1B,mBAAmB,EACnB,2BAA2B,EAC3B,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,cAAc,iCAAiC,CAAC;AAChD,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC"}

package/dist/src/sdk/buildSDK.d.ts

@@ -20,12 +20,14 @@ import { type IRewardsService, type RewardsServiceConfig } from "../services/rew
 import { type IIntrinsicApyService, type IntrinsicApyServiceConfig } from "../services/intrinsicApyService/index.js";
 import { type IOracleAdapterService, type OracleAdapterServiceConfig } from "../services/oracleAdapterService/index.js";
 import { type IFeeFlowService, type FeeFlowServiceConfig } from "../services/feeFlowService/index.js";
+import { type IREULLockService } from "../services/reulLockService/index.js";
 import { type EulerSDKConfig } from "./config.js";
 import type { TokenlistServiceConfig } from "../services/tokenlistService/index.js";
 import { type IVaultMetaService, type VaultEntity, type VaultServiceEntry } from "../services/vaults/vaultMetaService/index.js";
 import type { VaultTypeSubgraphAdapterConfig, VaultTypeV3AdapterConfig } from "../services/vaults/vaultMetaService/index.js";
 import type { IVaultEntity } from "../entities/Account.js";
 import { type BuildQueryFn, type QueryCacheConfig } from "../utils/buildQuery.js";
+import { type FallbackInfo } from "../utils/fallbackAdapter.js";
 import type { EulerPlugin } from "../plugins/types.js";
 export interface BuildSDKOverrides<TVaultEntity extends IVaultEntity = VaultEntity> {
     abiService?: IABIService;
@@ -47,6 +49,7 @@ export interface BuildSDKOverrides<TVaultEntity extends IVaultEntity = VaultEnti
     intrinsicApyService?: IIntrinsicApyService;
     oracleAdapterService?: IOracleAdapterService;
     feeFlowService?: IFeeFlowService;
+    reulLockService?: IREULLockService;
 }
 export type { EulerSDKConfig } from "./config.js";
 export interface BuildSDKOptions<TVaultEntity extends IVaultEntity = VaultEntity> {
@@ -78,6 +81,11 @@ export interface BuildSDKOptions<TVaultEntity extends IVaultEntity = VaultEntity
     buildQuery?: BuildQueryFn;
     /** Plugins that enrich on-chain reads (via batchSimulation) and transaction plans (via processPlan). */
     plugins?: EulerPlugin[];
+    /**
+     * Optional callback invoked whenever a built-in fallback adapter routes a call from the primary
+     * to the secondary. Use for telemetry, dashboards, or in-app diagnostics.
+     */
+    onFallback?: (info: FallbackInfo) => void;
     servicesOverrides?: BuildSDKOverrides<TVaultEntity>;
 }
 export declare function buildEulerSDK<TVaultEntity extends IVaultEntity = VaultEntity>(options?: BuildSDKOptions<TVaultEntity>): Promise<EulerSDK<TVaultEntity>>;

package/dist/src/sdk/buildSDK.d.ts.map

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

package/dist/src/sdk/buildSDK.js

@@ -25,12 +25,14 @@ import { OracleAdapterService, } from "../services/oracleAdapterService/index.js
 import { DEFAULT_EULER_LABELS_BASE_URL, DEFAULT_TOKENLIST_API_BASE_URL, defaultAccountV3AdapterConfig, defaultAccountVaultsAdapterConfig, defaultDeploymentServiceConfig, defaultEulerEarnV3AdapterConfig, defaultEulerLabelsURLAdapterConfig, defaultIntrinsicApyV3AdapterConfig, defaultPricingServiceConfig, defaultRewardsV3AdapterConfig, defaultSwapServiceConfig, defaultTokenlistServiceConfig, defaultVaultTypeAdapterConfig, } from "./defaultConfig.js";
 import { defaultEVaultV3AdapterConfig } from "./defaultConfig.js";
 import { FeeFlowService, } from "../services/feeFlowService/index.js";
+import { REULLockService, } from "../services/reulLockService/index.js";
 import { readEulerSDKEnvConfig, } from "./config.js";
 import { EVaultOnchainAdapter } from "../services/vaults/eVaultService/adapters/eVaultOnchainAdapter/eVaultOnchainAdapter.js";
 import { EVaultV3Adapter } from "../services/vaults/eVaultService/adapters/eVaultV3Adapter/eVaultV3Adapter.js";
 import { VaultMetaService, VaultTypeSubgraphAdapter, VaultTypeV3Adapter, } from "../services/vaults/vaultMetaService/index.js";
 import { VaultType } from "../utils/types.js";
 import { createQueryCacheBuildQuery, } from "../utils/buildQuery.js";
+import { createFallbackAdapter, } from "../utils/fallbackAdapter.js";
 import { BatchSimulationAdapter } from "../plugins/batchSimulation.js";
 function pickConfigValue(configValue, explicitValue, envValue, defaultValue) {
     return configValue ?? explicitValue ?? envValue ?? defaultValue;
@@ -205,7 +207,7 @@ function resolveRewardsDirectAdapterConfig(explicitConfig, envConfig, config) {
     };
 }
 export async function buildEulerSDK(options = {}) {
-    const { config, v3ApiKey, accountServiceConfig, eVaultServiceConfig, eulerEarnServiceConfig, accountVaultsAdapterConfig, vaultTypeAdapterConfig, additionalVaultServices, eulerLabelsAdapterConfig, tokenlistServiceConfig, swapServiceConfig, pricingServiceConfig, rewardsServiceConfig, intrinsicApyServiceConfig, oracleAdapterServiceConfig, queryCacheConfig, buildQuery, plugins, servicesOverrides, feeFlowServiceConfig, } = options;
+    const { config, v3ApiKey, accountServiceConfig, eVaultServiceConfig, eulerEarnServiceConfig, accountVaultsAdapterConfig, vaultTypeAdapterConfig, additionalVaultServices, eulerLabelsAdapterConfig, tokenlistServiceConfig, swapServiceConfig, pricingServiceConfig, rewardsServiceConfig, intrinsicApyServiceConfig, oracleAdapterServiceConfig, queryCacheConfig, buildQuery, plugins, onFallback, servicesOverrides, feeFlowServiceConfig, } = options;
     const envConfig = readEulerSDKEnvConfig();
     const resolvedRpcUrls = mergeNumberRecords(undefined, envConfig.rpcUrls, undefined, config?.rpcUrls);
     const resolvedQueryCacheConfig = {
@@ -226,34 +228,76 @@ export async function buildEulerSDK(options = {}) {
     const deploymentService = servicesOverrides?.deploymentService ??
         (await DeploymentService.build(resolvedDeploymentServiceConfig, resolvedBuildQuery));
     const providerService = servicesOverrides?.providerService ?? new ProviderService(resolvedRpcUrls);
+    const disableV3 = pickConfigValue(config?.disableV3, undefined, envConfig.disableV3) ?? false;
     // Account adapter is built early so it can be used when building account service (after vault meta service)
     const resolvedAccountServiceConfig = accountServiceConfig ?? {};
-    const resolvedAccountServiceAdapter = pickConfigValue(config?.accountServiceAdapter, resolvedAccountServiceConfig.adapter, envConfig.accountServiceAdapter);
+    const resolvedAccountServiceAdapter = pickConfigValue(config?.accountServiceAdapter, resolvedAccountServiceConfig.adapter, envConfig.accountServiceAdapter) ?? "fallback";
+    const effectiveAccountServiceAdapter = (() => {
+        if (!disableV3)
+            return resolvedAccountServiceAdapter;
+        if (resolvedAccountServiceAdapter === "v3") {
+            console.warn("[buildEulerSDK] disableV3 is set but accountServiceAdapter='v3'; forcing 'onchain'.");
+            return "onchain";
+        }
+        if (resolvedAccountServiceAdapter === "fallback")
+            return "onchain";
+        return resolvedAccountServiceAdapter;
+    })();
+    const accountV3Config = resolveV3AdapterConfig(defaultAccountV3AdapterConfig, {
+        explicitConfig: resolvedAccountServiceConfig.v3AdapterConfig,
+        explicitV3ApiKey: v3ApiKey,
+        envConfig,
+        config,
+        envEndpoint: envConfig.accountV3ApiUrl,
+        configEndpoint: config?.accountV3ApiUrl,
+        envApiKey: envConfig.accountV3ApiKey,
+        configApiKey: config?.accountV3ApiKey,
+        envExtra: {
+            ...maybeField("forceFresh", envConfig.accountV3ForceFresh),
+        },
+        configExtra: {
+            ...maybeField("forceFresh", config?.accountV3ForceFresh),
+        },
+    });
+    const accountVaultsSubgraphUrls = mergeNumberRecords(defaultAccountVaultsAdapterConfig.subgraphURLs, envConfig.accountVaultsSubgraphUrls, accountVaultsAdapterConfig?.subgraphURLs, config?.accountVaultsSubgraphUrls);
+    const canBuildAccountV3 = !!accountV3Config.endpoint;
+    const canBuildAccountOnchain = Object.keys(accountVaultsSubgraphUrls).length > 0;
     let accountOnchainAdapter;
-    const accountAdapter = resolvedAccountServiceAdapter === "onchain"
-        ? (() => {
-            const accountVaultsAdapter = new AccountVaultsSubgraphAdapter({
-                subgraphURLs: mergeNumberRecords(defaultAccountVaultsAdapterConfig.subgraphURLs, envConfig.accountVaultsSubgraphUrls, accountVaultsAdapterConfig?.subgraphURLs, config?.accountVaultsSubgraphUrls),
-            }, resolvedBuildQuery);
-            accountOnchainAdapter = new AccountOnchainAdapter(providerService, deploymentService, accountVaultsAdapter, resolvedBuildQuery);
-            return accountOnchainAdapter;
-        })()
-        : new AccountV3Adapter(resolveV3AdapterConfig(defaultAccountV3AdapterConfig, {
-            explicitConfig: resolvedAccountServiceConfig.v3AdapterConfig,
-            explicitV3ApiKey: v3ApiKey,
-            envConfig,
-            config,
-            envEndpoint: envConfig.accountV3ApiUrl,
-            configEndpoint: config?.accountV3ApiUrl,
-            envApiKey: envConfig.accountV3ApiKey,
-            configApiKey: config?.accountV3ApiKey,
-            envExtra: {
-                ...maybeField("forceFresh", envConfig.accountV3ForceFresh),
-            },
-            configExtra: {
-                ...maybeField("forceFresh", config?.accountV3ForceFresh),
-            },
-        }), resolvedBuildQuery);
+    const buildAccountV3 = () => new AccountV3Adapter(accountV3Config, resolvedBuildQuery);
+    const buildAccountOnchain = () => {
+        const accountVaultsAdapter = new AccountVaultsSubgraphAdapter({ subgraphURLs: accountVaultsSubgraphUrls }, resolvedBuildQuery);
+        accountOnchainAdapter = new AccountOnchainAdapter(providerService, deploymentService, accountVaultsAdapter, resolvedBuildQuery);
+        return accountOnchainAdapter;
+    };
+    let accountAdapter;
+    if (effectiveAccountServiceAdapter === "v3") {
+        if (!canBuildAccountV3)
+            throw new Error("[buildEulerSDK] accountServiceAdapter='v3' but no V3 endpoint is configured.");
+        accountAdapter = buildAccountV3();
+    }
+    else if (effectiveAccountServiceAdapter === "onchain") {
+        if (!canBuildAccountOnchain)
+            throw new Error("[buildEulerSDK] accountServiceAdapter='onchain' but no accountVaultsSubgraphUrls are configured.");
+        accountAdapter = buildAccountOnchain();
+    }
+    else if (canBuildAccountV3 && canBuildAccountOnchain) {
+        accountAdapter = createFallbackAdapter(buildAccountV3(), buildAccountOnchain(), {
+            methods: ["fetchAccount", "fetchSubAccount"],
+            adapterNames: { primary: "accountV3", secondary: "accountOnchain" },
+            onFallback,
+        });
+    }
+    else if (canBuildAccountV3) {
+        console.warn("[buildEulerSDK] accountService fallback disabled: onchain adapter requires accountVaultsSubgraphUrls. Using V3 only.");
+        accountAdapter = buildAccountV3();
+    }
+    else if (canBuildAccountOnchain) {
+        console.warn("[buildEulerSDK] accountService fallback disabled: V3 endpoint not configured. Using onchain only.");
+        accountAdapter = buildAccountOnchain();
+    }
+    else {
+        throw new Error("[buildEulerSDK] cannot build account adapter: neither V3 endpoint nor accountVaultsSubgraphUrls are configured.");
+    }
     // Build wallet service if not overridden
     let walletService;
     if (servicesOverrides?.walletService) {
@@ -271,28 +315,65 @@ export async function buildEulerSDK(options = {}) {
     }
     else {
         const resolvedEVaultServiceConfig = eVaultServiceConfig ?? {};
-        const resolvedEVaultServiceAdapter = pickConfigValue(config?.eVaultServiceAdapter, resolvedEVaultServiceConfig.adapter, envConfig.eVaultServiceAdapter);
-        const selectedEVaultAdapter = resolvedEVaultServiceAdapter === "onchain"
-            ? (() => {
-                eVaultAdapter = new EVaultOnchainAdapter(providerService, deploymentService, resolvedBuildQuery);
-                return eVaultAdapter;
-            })()
-            : new EVaultV3Adapter(resolveV3AdapterConfig(defaultEVaultV3AdapterConfig, {
-                explicitConfig: resolvedEVaultServiceConfig.v3AdapterConfig,
-                explicitV3ApiKey: v3ApiKey,
-                envConfig,
-                config,
-                envEndpoint: envConfig.eVaultV3ApiUrl,
-                configEndpoint: config?.eVaultV3ApiUrl,
-                envApiKey: envConfig.eVaultV3ApiKey,
-                configApiKey: config?.eVaultV3ApiKey,
-                envExtra: {
-                    ...maybeField("batchSize", envConfig.eVaultV3BatchSize),
-                },
-                configExtra: {
-                    ...maybeField("batchSize", config?.eVaultV3BatchSize),
-                },
-            }), providerService, resolvedBuildQuery);
+        const resolvedEVaultServiceAdapter = pickConfigValue(config?.eVaultServiceAdapter, resolvedEVaultServiceConfig.adapter, envConfig.eVaultServiceAdapter) ?? "fallback";
+        const effectiveEVaultServiceAdapter = (() => {
+            if (!disableV3)
+                return resolvedEVaultServiceAdapter;
+            if (resolvedEVaultServiceAdapter === "v3") {
+                console.warn("[buildEulerSDK] disableV3 is set but eVaultServiceAdapter='v3'; forcing 'onchain'.");
+                return "onchain";
+            }
+            if (resolvedEVaultServiceAdapter === "fallback")
+                return "onchain";
+            return resolvedEVaultServiceAdapter;
+        })();
+        const eVaultV3Config = resolveV3AdapterConfig(defaultEVaultV3AdapterConfig, {
+            explicitConfig: resolvedEVaultServiceConfig.v3AdapterConfig,
+            explicitV3ApiKey: v3ApiKey,
+            envConfig,
+            config,
+            envEndpoint: envConfig.eVaultV3ApiUrl,
+            configEndpoint: config?.eVaultV3ApiUrl,
+            envApiKey: envConfig.eVaultV3ApiKey,
+            configApiKey: config?.eVaultV3ApiKey,
+            envExtra: { ...maybeField("batchSize", envConfig.eVaultV3BatchSize) },
+            configExtra: { ...maybeField("batchSize", config?.eVaultV3BatchSize) },
+        });
+        const canBuildEVaultV3 = !!eVaultV3Config.endpoint;
+        const canBuildEVaultOnchain = true; // onchain only needs provider + deployment, always available
+        const buildEVaultV3 = () => new EVaultV3Adapter(eVaultV3Config, providerService, resolvedBuildQuery);
+        const buildEVaultOnchain = () => {
+            eVaultAdapter = new EVaultOnchainAdapter(providerService, deploymentService, resolvedBuildQuery);
+            return eVaultAdapter;
+        };
+        let selectedEVaultAdapter;
+        if (effectiveEVaultServiceAdapter === "v3") {
+            if (!canBuildEVaultV3)
+                throw new Error("[buildEulerSDK] eVaultServiceAdapter='v3' but no V3 endpoint is configured.");
+            selectedEVaultAdapter = buildEVaultV3();
+        }
+        else if (effectiveEVaultServiceAdapter === "onchain") {
+            selectedEVaultAdapter = buildEVaultOnchain();
+        }
+        else if (canBuildEVaultV3 && canBuildEVaultOnchain) {
+            selectedEVaultAdapter = createFallbackAdapter(buildEVaultV3(), buildEVaultOnchain(), {
+                methods: [
+                    "fetchVaults",
+                    "fetchAllVaults",
+                    "fetchVerifiedVaultsAddresses",
+                ],
+                adapterNames: { primary: "eVaultV3", secondary: "eVaultOnchain" },
+                onFallback,
+            });
+        }
+        else if (canBuildEVaultV3) {
+            console.warn("[buildEulerSDK] eVaultService fallback disabled: onchain adapter unavailable. Using V3 only.");
+            selectedEVaultAdapter = buildEVaultV3();
+        }
+        else {
+            console.warn("[buildEulerSDK] eVaultService fallback disabled: V3 endpoint not configured. Using onchain only.");
+            selectedEVaultAdapter = buildEVaultOnchain();
+        }
         eVaultService = new EVaultService(selectedEVaultAdapter, deploymentService);
     }
     // Build eulerEarn service if not overridden
@@ -302,19 +383,58 @@ export async function buildEulerSDK(options = {}) {
     }
     else {
         const resolvedEulerEarnServiceConfig = eulerEarnServiceConfig ?? {};
-        const resolvedEulerEarnServiceAdapter = pickConfigValue(config?.eulerEarnServiceAdapter, resolvedEulerEarnServiceConfig.adapter, envConfig.eulerEarnServiceAdapter);
-        const eulerEarnAdapter = resolvedEulerEarnServiceAdapter === "onchain"
-            ? new EulerEarnOnchainAdapter(providerService, deploymentService, resolvedBuildQuery)
-            : new EulerEarnV3Adapter(resolveV3AdapterConfig(defaultEulerEarnV3AdapterConfig, {
-                explicitConfig: resolvedEulerEarnServiceConfig.v3AdapterConfig,
-                explicitV3ApiKey: v3ApiKey,
-                envConfig,
-                config,
-                envEndpoint: envConfig.eulerEarnV3ApiUrl,
-                configEndpoint: config?.eulerEarnV3ApiUrl,
-                envApiKey: envConfig.eulerEarnV3ApiKey,
-                configApiKey: config?.eulerEarnV3ApiKey,
-            }), resolvedBuildQuery);
+        const resolvedEulerEarnServiceAdapter = pickConfigValue(config?.eulerEarnServiceAdapter, resolvedEulerEarnServiceConfig.adapter, envConfig.eulerEarnServiceAdapter) ?? "fallback";
+        const effectiveEulerEarnServiceAdapter = (() => {
+            if (!disableV3)
+                return resolvedEulerEarnServiceAdapter;
+            if (resolvedEulerEarnServiceAdapter === "v3") {
+                console.warn("[buildEulerSDK] disableV3 is set but eulerEarnServiceAdapter='v3'; forcing 'onchain'.");
+                return "onchain";
+            }
+            if (resolvedEulerEarnServiceAdapter === "fallback")
+                return "onchain";
+            return resolvedEulerEarnServiceAdapter;
+        })();
+        const eulerEarnV3Config = resolveV3AdapterConfig(defaultEulerEarnV3AdapterConfig, {
+            explicitConfig: resolvedEulerEarnServiceConfig.v3AdapterConfig,
+            explicitV3ApiKey: v3ApiKey,
+            envConfig,
+            config,
+            envEndpoint: envConfig.eulerEarnV3ApiUrl,
+            configEndpoint: config?.eulerEarnV3ApiUrl,
+            envApiKey: envConfig.eulerEarnV3ApiKey,
+            configApiKey: config?.eulerEarnV3ApiKey,
+        });
+        const canBuildEulerEarnV3 = !!eulerEarnV3Config.endpoint;
+        const buildEulerEarnV3 = () => new EulerEarnV3Adapter(eulerEarnV3Config, resolvedBuildQuery);
+        const buildEulerEarnOnchain = () => new EulerEarnOnchainAdapter(providerService, deploymentService, resolvedBuildQuery);
+        let eulerEarnAdapter;
+        if (effectiveEulerEarnServiceAdapter === "v3") {
+            if (!canBuildEulerEarnV3)
+                throw new Error("[buildEulerSDK] eulerEarnServiceAdapter='v3' but no V3 endpoint is configured.");
+            eulerEarnAdapter = buildEulerEarnV3();
+        }
+        else if (effectiveEulerEarnServiceAdapter === "onchain") {
+            eulerEarnAdapter = buildEulerEarnOnchain();
+        }
+        else if (canBuildEulerEarnV3) {
+            eulerEarnAdapter = createFallbackAdapter(buildEulerEarnV3(), buildEulerEarnOnchain(), {
+                methods: [
+                    "fetchVaults",
+                    "fetchAllVaults",
+                    "fetchVerifiedVaultsAddresses",
+                ],
+                adapterNames: {
+                    primary: "eulerEarnV3",
+                    secondary: "eulerEarnOnchain",
+                },
+                onFallback,
+            });
+        }
+        else {
+            console.warn("[buildEulerSDK] eulerEarnService fallback disabled: V3 endpoint not configured. Using onchain only.");
+            eulerEarnAdapter = buildEulerEarnOnchain();
+        }
         eulerEarnService = new EulerEarnService(eulerEarnAdapter, deploymentService, eVaultService);
     }
     // Build securitizeVault service if not overridden
@@ -337,32 +457,75 @@ export async function buildEulerSDK(options = {}) {
                 ? "subgraph"
                 : "v3"
             : undefined;
-        const resolvedVaultTypeAdapterKind = pickConfigValue(config?.vaultTypeAdapter, explicitVaultTypeAdapterKind, envConfig.vaultTypeAdapter, "v3");
-        const vaultTypeAdapter = resolvedVaultTypeAdapterKind === "subgraph"
-            ? new VaultTypeSubgraphAdapter({
-                subgraphURLs: mergeNumberRecords(defaultAccountVaultsAdapterConfig.subgraphURLs, envConfig.vaultTypeSubgraphUrls, vaultTypeAdapterConfig &&
-                    "subgraphURLs" in vaultTypeAdapterConfig
-                    ? vaultTypeAdapterConfig.subgraphURLs
-                    : undefined, config?.vaultTypeSubgraphUrls),
-            }, resolvedBuildQuery)
-            : new VaultTypeV3Adapter(resolveV3AdapterConfig(defaultVaultTypeAdapterConfig, {
-                explicitConfig: vaultTypeAdapterConfig &&
-                    !("subgraphURLs" in vaultTypeAdapterConfig)
-                    ? {
-                        ...vaultTypeAdapterConfig,
-                        ...maybeField("typeMap", mergeStringRecords(envConfig.vaultTypeV3TypeMap, vaultTypeAdapterConfig.typeMap, config?.vaultTypeV3TypeMap)),
-                    }
-                    : {
-                        ...maybeField("typeMap", mergeStringRecords(envConfig.vaultTypeV3TypeMap, undefined, config?.vaultTypeV3TypeMap)),
-                    },
-                explicitV3ApiKey: v3ApiKey,
-                envConfig,
-                config,
-                envEndpoint: envConfig.vaultTypeV3ApiUrl,
-                configEndpoint: config?.vaultTypeV3ApiUrl,
-                envApiKey: envConfig.vaultTypeV3ApiKey,
-                configApiKey: config?.vaultTypeV3ApiKey,
-            }), resolvedBuildQuery);
+        const resolvedVaultTypeAdapterKind = pickConfigValue(config?.vaultTypeAdapter, explicitVaultTypeAdapterKind, envConfig.vaultTypeAdapter, "fallback");
+        const effectiveVaultTypeAdapterKind = (() => {
+            if (!disableV3)
+                return resolvedVaultTypeAdapterKind;
+            if (resolvedVaultTypeAdapterKind === "v3") {
+                console.warn("[buildEulerSDK] disableV3 is set but vaultTypeAdapter='v3'; forcing 'subgraph'.");
+                return "subgraph";
+            }
+            if (resolvedVaultTypeAdapterKind === "fallback")
+                return "subgraph";
+            return resolvedVaultTypeAdapterKind;
+        })();
+        const vaultTypeSubgraphUrls = mergeNumberRecords(defaultAccountVaultsAdapterConfig.subgraphURLs, envConfig.vaultTypeSubgraphUrls, vaultTypeAdapterConfig && "subgraphURLs" in vaultTypeAdapterConfig
+            ? vaultTypeAdapterConfig.subgraphURLs
+            : undefined, config?.vaultTypeSubgraphUrls);
+        const vaultTypeV3Config = resolveV3AdapterConfig(defaultVaultTypeAdapterConfig, {
+            explicitConfig: vaultTypeAdapterConfig &&
+                !("subgraphURLs" in vaultTypeAdapterConfig)
+                ? {
+                    ...vaultTypeAdapterConfig,
+                    ...maybeField("typeMap", mergeStringRecords(envConfig.vaultTypeV3TypeMap, vaultTypeAdapterConfig.typeMap, config?.vaultTypeV3TypeMap)),
+                }
+                : {
+                    ...maybeField("typeMap", mergeStringRecords(envConfig.vaultTypeV3TypeMap, undefined, config?.vaultTypeV3TypeMap)),
+                },
+            explicitV3ApiKey: v3ApiKey,
+            envConfig,
+            config,
+            envEndpoint: envConfig.vaultTypeV3ApiUrl,
+            configEndpoint: config?.vaultTypeV3ApiUrl,
+            envApiKey: envConfig.vaultTypeV3ApiKey,
+            configApiKey: config?.vaultTypeV3ApiKey,
+        });
+        const canBuildVaultTypeV3 = !!vaultTypeV3Config.endpoint;
+        const canBuildVaultTypeSubgraph = Object.keys(vaultTypeSubgraphUrls).length > 0;
+        const buildVaultTypeV3 = () => new VaultTypeV3Adapter(vaultTypeV3Config, resolvedBuildQuery);
+        const buildVaultTypeSubgraph = () => new VaultTypeSubgraphAdapter({ subgraphURLs: vaultTypeSubgraphUrls }, resolvedBuildQuery);
+        let vaultTypeAdapter;
+        if (effectiveVaultTypeAdapterKind === "v3") {
+            if (!canBuildVaultTypeV3)
+                throw new Error("[buildEulerSDK] vaultTypeAdapter='v3' but no V3 endpoint is configured.");
+            vaultTypeAdapter = buildVaultTypeV3();
+        }
+        else if (effectiveVaultTypeAdapterKind === "subgraph") {
+            if (!canBuildVaultTypeSubgraph)
+                throw new Error("[buildEulerSDK] vaultTypeAdapter='subgraph' but no subgraph URLs are configured.");
+            vaultTypeAdapter = buildVaultTypeSubgraph();
+        }
+        else if (canBuildVaultTypeV3 && canBuildVaultTypeSubgraph) {
+            vaultTypeAdapter = createFallbackAdapter(buildVaultTypeV3(), buildVaultTypeSubgraph(), {
+                methods: ["fetchVaultType", "fetchVaultFactories", "fetchVaultTypes"],
+                adapterNames: {
+                    primary: "vaultTypeV3",
+                    secondary: "vaultTypeSubgraph",
+                },
+                onFallback,
+            });
+        }
+        else if (canBuildVaultTypeV3) {
+            console.warn("[buildEulerSDK] vaultTypeAdapter fallback disabled: subgraph URLs not configured. Using V3 only.");
+            vaultTypeAdapter = buildVaultTypeV3();
+        }
+        else if (canBuildVaultTypeSubgraph) {
+            console.warn("[buildEulerSDK] vaultTypeAdapter fallback disabled: V3 endpoint not configured. Using subgraph only.");
+            vaultTypeAdapter = buildVaultTypeSubgraph();
+        }
+        else {
+            throw new Error("[buildEulerSDK] cannot build vault type adapter: neither V3 endpoint nor subgraph URLs are configured.");
+        }
         const allVaultServices = [
             {
                 type: VaultType.EVault,
@@ -469,22 +632,64 @@ export async function buildEulerSDK(options = {}) {
     // Build rewards service if not overridden
     const rewardsService = servicesOverrides?.rewardsService ??
         (() => {
-            const resolvedRewardsServiceAdapter = pickConfigValue(config?.rewardsServiceAdapter, rewardsServiceConfig?.adapter, envConfig.rewardsServiceAdapter, "v3");
+            const resolvedRewardsServiceAdapter = pickConfigValue(config?.rewardsServiceAdapter, rewardsServiceConfig?.adapter, envConfig.rewardsServiceAdapter) ?? "fallback";
+            const effectiveRewardsServiceAdapter = (() => {
+                if (!disableV3)
+                    return resolvedRewardsServiceAdapter;
+                if (resolvedRewardsServiceAdapter === "v3") {
+                    console.warn("[buildEulerSDK] disableV3 is set but rewardsServiceAdapter='v3'; forcing 'direct'.");
+                    return "direct";
+                }
+                if (resolvedRewardsServiceAdapter === "fallback")
+                    return "direct";
+                return resolvedRewardsServiceAdapter;
+            })();
             const directAdapterConfig = resolveRewardsDirectAdapterConfig(rewardsServiceConfig, envConfig, config);
+            // directAdapter is always constructed because RewardsService also reads
+            // merkl/fuul addresses from it, regardless of which adapter serves data.
             const directAdapter = new RewardsDirectAdapter(directAdapterConfig, resolvedBuildQuery);
-            const rewardsAdapter = resolvedRewardsServiceAdapter === "direct"
-                ? directAdapter
-                : new RewardsV3Adapter(resolveV3AdapterConfig(defaultRewardsV3AdapterConfig, {
-                    explicitConfig: rewardsServiceConfig?.v3AdapterConfig,
-                    explicitV3ApiKey: v3ApiKey,
-                    envConfig,
-                    config,
-                    envEndpoint: envConfig.rewardsV3ApiUrl,
-                    configEndpoint: config?.rewardsV3ApiUrl,
-                    envApiKey: envConfig.rewardsV3ApiKey,
-                    configApiKey: config?.rewardsV3ApiKey,
-                }), resolvedBuildQuery);
-            return new RewardsService(rewardsAdapter, resolvedRewardsServiceAdapter === "direct" ? undefined : directAdapter, {
+            const rewardsV3Config = resolveV3AdapterConfig(defaultRewardsV3AdapterConfig, {
+                explicitConfig: rewardsServiceConfig?.v3AdapterConfig,
+                explicitV3ApiKey: v3ApiKey,
+                envConfig,
+                config,
+                envEndpoint: envConfig.rewardsV3ApiUrl,
+                configEndpoint: config?.rewardsV3ApiUrl,
+                envApiKey: envConfig.rewardsV3ApiKey,
+                configApiKey: config?.rewardsV3ApiKey,
+            });
+            const canBuildRewardsV3 = !!rewardsV3Config.endpoint;
+            const buildRewardsV3 = () => new RewardsV3Adapter(rewardsV3Config, resolvedBuildQuery);
+            let rewardsAdapter;
+            if (effectiveRewardsServiceAdapter === "direct") {
+                rewardsAdapter = directAdapter;
+            }
+            else if (effectiveRewardsServiceAdapter === "v3") {
+                if (!canBuildRewardsV3)
+                    throw new Error("[buildEulerSDK] rewardsServiceAdapter='v3' but no V3 endpoint is configured.");
+                rewardsAdapter = buildRewardsV3();
+            }
+            else if (canBuildRewardsV3) {
+                rewardsAdapter = createFallbackAdapter(buildRewardsV3(), directAdapter, {
+                    methods: [
+                        "fetchVaultRewards",
+                        "fetchChainRewards",
+                        "fetchUserRewards",
+                        "fetchFuulTotals",
+                        "fetchFuulClaimChecks",
+                    ],
+                    adapterNames: {
+                        primary: "rewardsV3",
+                        secondary: "rewardsDirect",
+                    },
+                    onFallback,
+                });
+            }
+            else {
+                console.warn("[buildEulerSDK] rewardsService fallback disabled: V3 endpoint not configured. Using direct only.");
+                rewardsAdapter = directAdapter;
+            }
+            return new RewardsService(rewardsAdapter, {
                 merklDistributorAddress: directAdapter.getMerklDistributorAddress(),
                 fuulManagerAddress: directAdapter.getFuulManagerAddress(),
                 fuulFactoryAddress: directAdapter.getFuulFactoryAddress(),
@@ -532,6 +737,8 @@ export async function buildEulerSDK(options = {}) {
             ...maybeField("feeFlowControllerUtilAddress", config?.feeFlowControllerUtilAddress),
             ...maybeField("defaultBuyDeadlineSeconds", config?.feeFlowDefaultBuyDeadlineSeconds),
         }, resolvedBuildQuery);
+    const reulLockService = servicesOverrides?.reulLockService ??
+        new REULLockService(providerService, deploymentService);
     if (executionService instanceof ExecutionService) {
         executionService.setProviderService(providerService);
         executionService.setVaultMetaService(vaultMetaService);
@@ -613,6 +820,7 @@ export async function buildEulerSDK(options = {}) {
         intrinsicApyService,
         oracleAdapterService,
         feeFlowService,
+        reulLockService,
         plugins,
     });
     if (executionService instanceof ExecutionService) {