@defisaver/positions-sdk 2.1.79 → 2.1.80

package/esm/services/utils.js

@@ -31,7 +31,7 @@ export const mapRange = (input, minInput, maxInput, minOutput, maxOutput) => {
 // eslint-disable-next-line no-bitwise
 export const isEnabledOnBitmap = (bitmap, assetId) => (BigInt(bitmap) >> BigInt(assetId)) & BigInt(1);
 export const MAXUINT = '115792089237316195423570985008687907853269984665640564039457584007913129639935';
-export const isMaxuint = (amount) => compareAddresses(MAXUINT, amount);
+export const isMaxUint = (amount) => compareAddresses(MAXUINT, amount);
 export const isMainnetNetwork = (network) => network === NetworkNumber.Eth;
 export const DEFAULT_TIMEOUT = 2000; // 2 seconds
 export const LONGER_TIMEOUT = 5000; // 5 seconds

package/esm/types/aaveV4.d.ts

@@ -0,0 +1,159 @@
+import { EthAddress, IncentiveData, LeverageType, NetworkNumber } from './common';
+export declare enum AaveV4HubsType {
+    AaveV4CoreHub = "aave_v4_core_hub",
+    AaveV4PlusHub = "aave_v4_plus_hub",
+    AaveV4PrimeHub = "aave_v4_prime_hub"
+}
+export declare enum AaveV4SpokesType {
+    AaveV4BluechipSpoke = "aave_v4_bluechip_spoke",
+    AaveV4EthenaCorrelatedSpoke = "aave_v4_ethena_correlated_spoke",
+    AaveV4EthenaEcosystemSpoke = "aave_v4_ethena_ecosystem_spoke",
+    AaveV4EtherfiSpoke = "aave_v4_etherfi_spoke",
+    AaveV4ForexSpoke = "aave_v4_forex_spoke",
+    AaveV4GoldSpoke = "aave_v4_gold_spoke",
+    AaveV4KelpSpoke = "aave_v4_kelp_spoke",
+    AaveV4LidoSpoke = "aave_v4_lido_spoke",
+    AaveV4LombardBtcSpoke = "aave_v4_lombard_btc_spoke",
+    AaveV4MainSpoke = "aave_v4_main_spoke"
+}
+export interface AaveV4HubInfo {
+    chainIds: NetworkNumber[];
+    label: string;
+    value: AaveV4HubsType;
+    address: EthAddress;
+}
+export interface AaveV4HubAssetOnChainData {
+    assetId: number;
+    drawnRate: bigint;
+    liquidity: bigint;
+    liquidityFee: number;
+    swept: bigint;
+    totalDrawn: bigint;
+    totalDrawnShares: bigint;
+    totalPremiumShares: bigint;
+}
+export interface AaveV4HubOnChainData {
+    assets: Record<number, AaveV4HubAssetOnChainData>;
+}
+export interface AaveV4SpokeInfo {
+    chainIds: NetworkNumber[];
+    label: string;
+    value: AaveV4SpokesType;
+    url: string;
+    address: EthAddress;
+    hubs: EthAddress[];
+}
+export interface AaveV4SpokeData {
+    assetsData: AaveV4AssetsData;
+    oracle: EthAddress;
+    oracleDecimals: number;
+    address: EthAddress;
+}
+export interface AaveV4ReserveAssetOnChain {
+    underlying: EthAddress;
+    hub: EthAddress;
+    assetId: number;
+    decimals: number;
+    paused: boolean;
+    frozen: boolean;
+    borrowable: boolean;
+    collateralRisk: number;
+    collateralFactor: number;
+    maxLiquidationBonus: number;
+    liquidationFee: number;
+    price: bigint;
+    totalSupplied: bigint;
+    totalDrawn: bigint;
+    totalPremium: bigint;
+    totalDebt: bigint;
+    supplyCap: bigint;
+    borrowCap: bigint;
+    deficitRay: bigint;
+    spokeActive: boolean;
+    spokeHalted: boolean;
+}
+export interface AaveV4ReserveAssetData {
+    symbol: string;
+    underlying: EthAddress;
+    hub: EthAddress;
+    hubName: string;
+    assetId: number;
+    reserveId: number;
+    paused: boolean;
+    frozen: boolean;
+    borrowable: boolean;
+    collateralRisk: number;
+    collateralFactor: number;
+    liquidationFee: number;
+    maxLiquidationBonus: number;
+    price: string;
+    totalSupplied: string;
+    totalDrawn: string;
+    totalPremium: string;
+    totalDebt: string;
+    supplyCap: string;
+    borrowCap: string;
+    spokeActive: boolean;
+    spokeHalted: boolean;
+    drawnRate: string;
+    supplyRate: string;
+    borrowRate: string;
+    supplyIncentives: IncentiveData[];
+    borrowIncentives: IncentiveData[];
+    canBeBorrowed: boolean;
+    canBeSupplied: boolean;
+    canBeWithdrawn: boolean;
+    canBePayBacked: boolean;
+    utilization: string;
+}
+export type AaveV4AssetsData = Record<string, AaveV4ReserveAssetData>;
+export interface AaveV4UsedReserveAsset {
+    symbol: string;
+    hubName: string;
+    assetId: number;
+    reserveId: number;
+    supplied: string;
+    suppliedUsd: string;
+    drawn: string;
+    drawnUsd: string;
+    premium: string;
+    premiumUsd: string;
+    borrowed: string;
+    borrowedUsd: string;
+    isSupplied: boolean;
+    isBorrowed: boolean;
+    collateral: boolean;
+    collateralFactor: number;
+}
+export interface AaveV4AggregatedPositionData {
+    suppliedUsd: string;
+    suppliedCollateralUsd: string;
+    borrowLimitUsd: string;
+    liquidationLimitUsd: string;
+    borrowedUsd: string;
+    drawnUsd: string;
+    premiumUsd: string;
+    leftToBorrowUsd: string;
+    ratio: string;
+    collRatio: string;
+    liqRatio: string;
+    liqPercent: string;
+    leveragedType: LeverageType;
+    leveragedAsset: string;
+    liquidationPrice: string;
+    minCollRatio: string;
+    collLiquidationRatio: string;
+    minHealthRatio: string;
+    healthRatio: string;
+    netApy: string;
+    incentiveUsd: string;
+    totalInterestUsd: string;
+    currentVolatilePairRatio?: string;
+    minRatio: string;
+}
+export type AaveV4UsedReserveAssets = Record<string, AaveV4UsedReserveAsset>;
+export interface AaveV4AccountData extends AaveV4AggregatedPositionData {
+    usedAssets: AaveV4UsedReserveAssets;
+    healthFactor: string;
+    riskPremiumBps: number;
+}

package/esm/types/aaveV4.js

@@ -0,0 +1,19 @@
+export var AaveV4HubsType;
+(function (AaveV4HubsType) {
+    AaveV4HubsType["AaveV4CoreHub"] = "aave_v4_core_hub";
+    AaveV4HubsType["AaveV4PlusHub"] = "aave_v4_plus_hub";
+    AaveV4HubsType["AaveV4PrimeHub"] = "aave_v4_prime_hub";
+})(AaveV4HubsType || (AaveV4HubsType = {}));
+export var AaveV4SpokesType;
+(function (AaveV4SpokesType) {
+    AaveV4SpokesType["AaveV4BluechipSpoke"] = "aave_v4_bluechip_spoke";
+    AaveV4SpokesType["AaveV4EthenaCorrelatedSpoke"] = "aave_v4_ethena_correlated_spoke";
+    AaveV4SpokesType["AaveV4EthenaEcosystemSpoke"] = "aave_v4_ethena_ecosystem_spoke";
+    AaveV4SpokesType["AaveV4EtherfiSpoke"] = "aave_v4_etherfi_spoke";
+    AaveV4SpokesType["AaveV4ForexSpoke"] = "aave_v4_forex_spoke";
+    AaveV4SpokesType["AaveV4GoldSpoke"] = "aave_v4_gold_spoke";
+    AaveV4SpokesType["AaveV4KelpSpoke"] = "aave_v4_kelp_spoke";
+    AaveV4SpokesType["AaveV4LidoSpoke"] = "aave_v4_lido_spoke";
+    AaveV4SpokesType["AaveV4LombardBtcSpoke"] = "aave_v4_lombard_btc_spoke";
+    AaveV4SpokesType["AaveV4MainSpoke"] = "aave_v4_main_spoke";
+})(AaveV4SpokesType || (AaveV4SpokesType = {}));

package/esm/types/index.d.ts

@@ -14,3 +14,4 @@ export * from './merit';
 export * from './merkl';
 export * from './savings';
 export * from './common';
+export * from './aaveV4';

package/esm/types/index.js

@@ -14,3 +14,4 @@ export * from './merit';
 export * from './merkl';
 export * from './savings';
 export * from './common';
+export * from './aaveV4';

package/esm/types/portfolio.d.ts

@@ -1,4 +1,5 @@
 import { AaveV2PositionData, AaveV3PositionData, AaveVersions } from './aave';
+import { AaveV4AccountData, AaveV4SpokesType } from './aaveV4';
 import { EthAddress } from './common';
 import { CompoundV2PositionData, CompoundV3PositionData, CompoundVersions } from './compound';
 import { CrvUSDUserData, CrvUSDVersions } from './curveUsd';
@@ -51,6 +52,9 @@ export interface PortfolioPositionsDataForAddress {
             [key: string]: FluidVaultData;
         };
     };
+    aaveV4: {
+        [key in AaveV4SpokesType]?: PortfolioProtocolData<AaveV4AccountData>;
+    };
 }
 export interface PortfolioPositionsData {
     [key: EthAddress]: PortfolioPositionsDataForAddress;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defisaver/positions-sdk",
-  "version": "2.1.79",
+  "version": "2.1.80",
   "description": "",
   "main": "./cjs/index.js",
   "module": "./esm/index.js",
@@ -21,7 +21,7 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "@defisaver/tokens": "^1.7.26",
+    "@defisaver/tokens": "^1.7.27",
     "@types/lodash": "^4.17.15",
     "@types/memoizee": "^0.4.12",
     "decimal.js": "^10.6.0",

package/src/aaveV4/index.ts

@@ -0,0 +1,223 @@
+import { Client } from 'viem';
+import Dec from 'decimal.js';
+import { assetAmountInEth, getAssetInfoByAddress } from '@defisaver/tokens';
+import { getViemProvider } from '../services/viem';
+import {
+  AaveV4AccountData,
+  AaveV4HubAssetOnChainData,
+  AaveV4HubOnChainData,
+  AaveV4ReserveAssetData,
+  AaveV4ReserveAssetOnChain,
+  AaveV4SpokeData,
+  AaveV4SpokeInfo,
+  AaveV4UsedReserveAssets,
+  EthAddress,
+  EthereumProvider,
+  IncentiveData,
+  IncentiveKind,
+  NetworkNumber,
+} from '../types';
+import { AaveV4ViewContractViem } from '../contracts';
+import { getStakingApy, STAKING_ASSETS } from '../staking';
+import { isMaxUint, wethToEth } from '../services/utils';
+import { aaveV4GetAggregatedPositionData, calcUserRiskPremiumBps } from '../helpers/aaveV4Helpers';
+import { getAaveV4HubByAddress } from '../markets/aaveV4';
+import { aprToApy } from '../moneymarket';
+
+export * as lend from './lend';
+
+const fetchHubData = async (viewContract: ReturnType<typeof AaveV4ViewContractViem>, hubAddress: EthAddress): Promise<AaveV4HubOnChainData> => {
+  const hubData = await viewContract.read.getHubAllAssetsData([hubAddress]);
+  return {
+    assets: hubData.reduce((acc: Record<number, AaveV4HubAssetOnChainData>, assetOnChainData) => {
+      acc[assetOnChainData.assetId] = {
+        assetId: assetOnChainData.assetId,
+        drawnRate: assetOnChainData.drawnRate,
+        liquidity: assetOnChainData.liquidity,
+        liquidityFee: assetOnChainData.liquidityFee,
+        swept: assetOnChainData.swept,
+        totalDrawn: assetOnChainData.totalDrawn,
+        totalDrawnShares: assetOnChainData.totalDrawnShares,
+        totalPremiumShares: assetOnChainData.totalPremiumShares,
+      };
+      return acc;
+    }, {}),
+  };
+};
+
+
+const formatReserveAsset = async (reserveAsset: AaveV4ReserveAssetOnChain, hubAsset: AaveV4HubAssetOnChainData, reserveId: number, oracleDecimals: number, network: NetworkNumber): Promise<AaveV4ReserveAssetData> => {
+  const assetInfo = getAssetInfoByAddress(reserveAsset.underlying, network);
+  const symbol = wethToEth(assetInfo.symbol);
+  const hubInfo = getAaveV4HubByAddress(network, reserveAsset.hub);
+  if (!hubInfo) {
+    throw new Error(`Hub not found with address: ${reserveAsset.hub}`);
+  }
+
+  const isStakingAsset = STAKING_ASSETS.includes(symbol);
+  const supplyIncentives: IncentiveData[] = [];
+  const borrowIncentives: IncentiveData[] = [];
+
+  if (isStakingAsset) {
+    const yieldApy = await getStakingApy(symbol, network as NetworkNumber);
+    supplyIncentives.push({
+      apy: yieldApy,
+      token: symbol,
+      incentiveKind: IncentiveKind.Staking,
+      description: `Native ${symbol} yield.`,
+    });
+    if (reserveAsset.borrowable) {
+      // When borrowing assets whose value increases over time
+      borrowIncentives.push({
+        apy: new Dec(yieldApy).mul(-1).toString(),
+        token: symbol,
+        incentiveKind: IncentiveKind.Reward,
+        description: `Due to the native yield of ${symbol}, the value of the debt would increase over time.`,
+      });
+    }
+  }
+
+  const totalSuppliedRaw = reserveAsset.totalSupplied ?? 0;
+  const totalDrawnRaw = reserveAsset.totalDrawn ?? 0;
+  const totalPremiumRaw = reserveAsset.totalPremium ?? 0;
+  const totalDebtRaw = reserveAsset.totalDebt ?? 0;
+  const supplyCapRaw = reserveAsset.supplyCap ?? 0;
+  const borrowCapRaw = reserveAsset.borrowCap ?? 0;
+  const totalSuppliedDec = isMaxUint(totalSuppliedRaw.toString()) ? new Dec(0) : new Dec(totalSuppliedRaw.toString());
+  const totalDrawnDec = isMaxUint(totalDrawnRaw.toString()) ? new Dec(0) : new Dec(totalDrawnRaw.toString());
+  const utilization = totalSuppliedDec.isZero() ? '0' : totalDrawnDec.times(100).div(totalSuppliedDec).toString();
+
+  /** @DEV Hub related calculations */
+  const drawnRate = new Dec(hubAsset.drawnRate.toString()).div(new Dec(10).pow(27));
+  const borrowApr = drawnRate.mul(100);
+  const totalDrawn = new Dec(hubAsset.totalDrawn.toString());
+  const liquidity = new Dec(hubAsset.liquidity.toString());
+  const swept = new Dec(hubAsset.swept.toString());
+  const hubUtilizationDenominator = totalDrawn.add(swept).add(liquidity);
+  const hubUtilization = hubUtilizationDenominator.isZero() ? new Dec(0) : totalDrawn.div(hubUtilizationDenominator);
+  const liquidityFee = new Dec(hubAsset.liquidityFee.toString()).div(new Dec(10).pow(4));
+  const totalDrawnShares = new Dec(hubAsset.totalDrawnShares.toString());
+  const totalPremiumShares = new Dec(hubAsset.totalPremiumShares.toString());
+  const premiumMultiplier = totalDrawnShares.isZero() ? new Dec(1) : totalDrawnShares.add(totalPremiumShares).div(totalDrawnShares);
+  const supplyApr = borrowApr.mul(hubUtilization).mul(premiumMultiplier).mul(new Dec(1).minus(liquidityFee));
+
+  return ({
+    symbol,
+    underlying: reserveAsset.underlying,
+    hub: hubInfo.address,
+    hubName: hubInfo?.label,
+    assetId: reserveAsset.assetId,
+    reserveId,
+    paused: reserveAsset.paused,
+    frozen: reserveAsset.frozen,
+    borrowable: reserveAsset.borrowable,
+    collateralRisk: new Dec(reserveAsset.collateralRisk).div(10000).toNumber(),
+    collateralFactor: new Dec(reserveAsset.collateralFactor).div(10000).toNumber(),
+    liquidationFee: new Dec(reserveAsset.liquidationFee).div(10000).toNumber(),
+    maxLiquidationBonus: new Dec(reserveAsset.maxLiquidationBonus).div(10000).toNumber(),
+    price: new Dec(reserveAsset.price).div(new Dec(10).pow(oracleDecimals)).toString(),
+    totalSupplied: isMaxUint(totalSuppliedRaw.toString()) ? totalSuppliedRaw.toString() : assetAmountInEth(totalSuppliedRaw.toString(), symbol),
+    totalDrawn: isMaxUint(totalDrawnRaw.toString()) ? totalDrawnRaw.toString() : assetAmountInEth(totalDrawnRaw.toString(), symbol),
+    totalPremium: isMaxUint(totalPremiumRaw.toString()) ? totalPremiumRaw.toString() : assetAmountInEth(totalPremiumRaw.toString(), symbol),
+    totalDebt: isMaxUint(totalDebtRaw.toString()) ? totalDebtRaw.toString() : assetAmountInEth(totalDebtRaw.toString(), symbol),
+    supplyCap: isMaxUint(supplyCapRaw.toString()) ? supplyCapRaw.toString() : assetAmountInEth(supplyCapRaw.toString(), symbol),
+    borrowCap: isMaxUint(borrowCapRaw.toString()) ? borrowCapRaw.toString() : assetAmountInEth(borrowCapRaw.toString(), symbol),
+    spokeActive: reserveAsset.spokeActive,
+    spokeHalted: reserveAsset.spokeHalted,
+    drawnRate: drawnRate.toString(),
+    borrowRate: aprToApy(borrowApr.toString()),
+    supplyRate: aprToApy(supplyApr.toString()),
+    supplyIncentives,
+    borrowIncentives,
+    canBeBorrowed: reserveAsset.spokeActive && !reserveAsset.spokeHalted && !reserveAsset.paused && !reserveAsset.frozen && reserveAsset.borrowable,
+    canBeSupplied: reserveAsset.spokeActive && !reserveAsset.spokeHalted && !reserveAsset.paused && !reserveAsset.frozen,
+    canBeWithdrawn: reserveAsset.spokeActive && !reserveAsset.spokeHalted && !reserveAsset.paused,
+    canBePayBacked: reserveAsset.spokeActive && !reserveAsset.spokeHalted && !reserveAsset.paused,
+    utilization,
+  });
+};
+
+export async function _getAaveV4SpokeData(provider: Client, network: NetworkNumber, market: AaveV4SpokeInfo, blockNumber: 'latest' | number = 'latest'): Promise<AaveV4SpokeData> {
+  const viewContract = AaveV4ViewContractViem(provider, network, blockNumber);
+
+  const hubsData: Record<EthAddress, AaveV4HubOnChainData> = {};
+  const [spokeData] = await Promise.all([
+    viewContract.read.getSpokeDataFull([market.address]),
+    ...market.hubs.map(async (hubAddress) => {
+      hubsData[hubAddress] = await fetchHubData(viewContract, hubAddress);
+    }),
+  ]);
+
+  const reserveAssetsArray = await Promise.all(spokeData[1].map(async (reserveAssetOnChain: AaveV4ReserveAssetOnChain, index: number) => formatReserveAsset(reserveAssetOnChain, hubsData[reserveAssetOnChain.hub].assets[reserveAssetOnChain.assetId], index, +spokeData[0].oracleDecimals.toString(), network)));
+
+  return {
+    assetsData: reserveAssetsArray.reduce((acc: Record<string, AaveV4ReserveAssetData>, reserveAsset: AaveV4ReserveAssetData) => {
+      acc[`${reserveAsset.symbol}-${reserveAsset.reserveId}`] = reserveAsset;
+      return acc;
+    }, {}),
+    oracle: spokeData[0].oracle,
+    oracleDecimals: +spokeData[0].oracleDecimals.toString(),
+    address: market.address,
+  };
+}
+
+export async function getAaveV4SpokeData(provider: EthereumProvider, network: NetworkNumber, spoke: AaveV4SpokeInfo, blockNumber: 'latest' | number = 'latest'): Promise<AaveV4SpokeData> {
+  return _getAaveV4SpokeData(getViemProvider(provider, network), network, spoke, blockNumber);
+}
+
+export async function _getAaveV4AccountData(provider: Client, network: NetworkNumber, spokeData: AaveV4SpokeData, address: EthAddress, blockNumber: 'latest' | number = 'latest'): Promise<AaveV4AccountData> {
+  const viewContract = AaveV4ViewContractViem(provider, network, blockNumber);
+
+  const loanData = await viewContract.read.getLoanData([spokeData.address, address]);
+
+  const healthFactorFromContract = new Dec(loanData.healthFactor.toString());
+  const healthFactor = isMaxUint(healthFactorFromContract.toString()) ? 'Infinity' : healthFactorFromContract.div(1e18).toString();
+  const usedAssets = loanData.reserves.reduce((acc: AaveV4UsedReserveAssets, usedReserveAsset) => {
+    const identifier = `${wethToEth(getAssetInfoByAddress(usedReserveAsset.underlying, network).symbol)}-${+usedReserveAsset.reserveId.toString()}`;
+    const reserveData = spokeData.assetsData[identifier];
+    const price = reserveData.price;
+    const supplied = isMaxUint(usedReserveAsset.supplied.toString()) ? usedReserveAsset.supplied.toString() : assetAmountInEth(usedReserveAsset.supplied.toString(), reserveData.symbol);
+    const drawn = isMaxUint(usedReserveAsset.drawn.toString()) ? usedReserveAsset.drawn.toString() : assetAmountInEth(usedReserveAsset.drawn.toString(), reserveData.symbol);
+    const premium = isMaxUint(usedReserveAsset.premium.toString()) ? usedReserveAsset.premium.toString() : assetAmountInEth(usedReserveAsset.premium.toString(), reserveData.symbol);
+    const borrowed = isMaxUint(usedReserveAsset.totalDebt.toString()) ? usedReserveAsset.totalDebt.toString() : assetAmountInEth(usedReserveAsset.totalDebt.toString(), reserveData.symbol);
+    acc[identifier] = {
+      symbol: reserveData.symbol,
+      hubName: reserveData.hubName,
+      assetId: reserveData.assetId,
+      reserveId: +usedReserveAsset.reserveId.toString(),
+      supplied,
+      suppliedUsd: new Dec(supplied).mul(price).toString(),
+      drawn,
+      drawnUsd: new Dec(drawn).mul(price).toString(),
+      premium,
+      premiumUsd: new Dec(premium).mul(price).toString(),
+      borrowed,
+      borrowedUsd: new Dec(borrowed).mul(price).toString(),
+      isSupplied: !new Dec(supplied).eq(0),
+      isBorrowed: usedReserveAsset.isBorrowing,
+      collateral: usedReserveAsset.isUsingAsCollateral,
+      collateralFactor: new Dec(usedReserveAsset.collateralFactor).div(10000).toNumber(),
+    };
+    return acc;
+  }, {});
+
+  const aggregated = aaveV4GetAggregatedPositionData({
+    usedAssets,
+    assetsData: spokeData.assetsData,
+    network,
+    useUserCollateralFactor: true,
+  });
+
+  const riskPremiumBps = calcUserRiskPremiumBps(usedAssets, spokeData.assetsData);
+
+  return {
+    ...aggregated,
+    usedAssets,
+    healthFactor,
+    riskPremiumBps,
+  };
+}
+
+export async function getAaveV4AccountData(provider: EthereumProvider, network: NetworkNumber, marketData: AaveV4SpokeData, address: EthAddress, blockNumber: 'latest' | number = 'latest'): Promise<any> {
+  return _getAaveV4AccountData(getViemProvider(provider, network), network, marketData, address, blockNumber);
+}

package/src/aaveV4/lend.ts

@@ -0,0 +1,185 @@
+import { assetAmountInEth, getAssetInfoByAddress } from '@defisaver/tokens';
+import { AaveV4ViewContractViem } from '../contracts';
+import { getViemProvider } from '../services/viem';
+import { wethToEth } from '../services/utils';
+import {
+  EthAddress,
+  EthereumProvider,
+  NetworkNumber,
+} from '../types/common';
+
+export interface AaveV4TokenizationSpokeData {
+  underlyingAsset: EthAddress;
+  assetId: string;
+  decimals: number;
+  spoke: EthAddress;
+  spokeActive: boolean;
+  spokeHalted: boolean;
+  spokeDepositCap: string;
+  spokeTotalAssets: string;
+  spokeTotalShares: string;
+  hub: EthAddress;
+  hubLiquidity: string;
+  hubDrawnRate: string;
+  convertToShares: string;
+  convertToAssets: string;
+  user: EthAddress;
+  userSuppliedAssets: string;
+  userSuppliedShares: string;
+}
+
+export const AAVE_V4_TOKENIZED_SPOKES: Record<string, EthAddress> = {
+  EURC_CORE: '0x6D9e2Cdd61CaF69af99b275704B6e272C41c6718',
+  GHO_CORE: '0x58C14a5E061c9bC6926c5b853445290F296C2F7B',
+  RLUSD_CORE: '0xC8a125AE4275a78AADc53B46Ca10566Bc9B249E0',
+  USDC_CORE: '0x531E90a2376902DE8915789Fcc1075e3B0c153E7',
+  USDG_CORE: '0xAC2435E3C25e8246870D33ce0a26988A46d5DB68',
+  USDT_CORE: '0x5eC44a70F309854fe04d495cFE1B5dA63DD1cc73',
+  WBTC_CORE: '0x82A9CC4656784E55Ef2E78F704028B5E1Bfc1732',
+  WETH_CORE: '0x7320CF22Ac095bA2a2e0a652F77efB836c2E751b',
+  cbBTC_CORE: '0x33B41B74366F55327d959FfF6D6b6fBc2853dbB1',
+  frxUSD_CORE: '0x2226749630775ee20230Ad65214fB339087eF30D',
+
+  GHO_PLUS: '0xA54382db40EC602c0a173A08f9E86Ed40F9D4D10',
+  USDC_PLUS: '0xc94bdd83D2c7655C280655D60954e79E88D4F949',
+  USDT_PLUS: '0x80835EB50694EE0e519743f67e5401e6FD300006',
+  USDe_PLUS: '0x502Cd81da6a8F1785eb2eEE72713B7388E16A854',
+
+  GHO_PRIME: '0x900fD46d565d1ac8995928c0179052ec02a6D0E1',
+  USDC_PRIME: '0x486415fb1F8b062c89ED548f871cf64304AACb31',
+  USDT_PRIME: '0x46c588DD8453aC259c1f6a54b4C9A93C2aC3762D',
+};
+
+export const AAVE_V4_TOKENIZED_SPOKE_ADDRESSES: Partial<Record<NetworkNumber, EthAddress[]>> = {
+  [NetworkNumber.Eth]: Object.values(AAVE_V4_TOKENIZED_SPOKES),
+};
+
+export type AaveV4TokenizedHubKey = 'CORE' | 'PLUS' | 'PRIME';
+
+export const aaveV4GetTokenizedHubKey = (hubNameOrKey?: string | null): AaveV4TokenizedHubKey | null => {
+  if (!hubNameOrKey) return null;
+  const normalized = hubNameOrKey.trim().toUpperCase();
+
+  if (normalized === 'CORE' || normalized === 'CORE HUB') return 'CORE';
+  if (normalized === 'PLUS' || normalized === 'PLUS HUB') return 'PLUS';
+  if (normalized === 'PRIME' || normalized === 'PRIME HUB') return 'PRIME';
+
+  if (normalized.includes('CORE')) return 'CORE';
+  if (normalized.includes('PLUS')) return 'PLUS';
+  if (normalized.includes('PRIME')) return 'PRIME';
+
+  return null;
+};
+
+export const aaveV4GetTokenizedVaultKey = (
+  symbol: string,
+  hubNameOrKey?: string | null,
+): string | null => {
+  if (!symbol) return null;
+  const hubKey = aaveV4GetTokenizedHubKey(hubNameOrKey);
+  if (!hubKey) return null;
+
+  const normalizedSymbol = symbol.trim().replace(/-/g, '_');
+
+  return `${normalizedSymbol}_${hubKey}`;
+};
+
+export const aaveV4GetTokenizedVaultAddress = (
+  network: NetworkNumber,
+  symbol: string,
+  hubNameOrKey?: string | null,
+): EthAddress | undefined => {
+  if (network !== NetworkNumber.Eth) return undefined;
+  const key = aaveV4GetTokenizedVaultKey(symbol, hubNameOrKey);
+  if (!key) return undefined;
+  return AAVE_V4_TOKENIZED_SPOKES[key];
+};
+
+/** Parsed tokenization spoke data with human-readable supplied amounts for display */
+export interface AaveV4TokenizationSpokeDataParsed {
+  vaultAddress: EthAddress;
+  key: string | null;
+  symbol: string;
+  hubKey: string;
+  // ---- Spoke ----
+  spokeActive: boolean;
+  spokeHalted: boolean;
+  /** Deposit cap in asset units (wei string) */
+  spokeDepositCap: string;
+  /** Total assets currently in spoke in asset units (wei string) */
+  spokeTotalAssets: string;
+  // ---- Hub ----
+  /** Available hub liquidity in asset units (wei string) */
+  hubLiquidity: string;
+  /** The conversion rate from assets to shares expressed in asset units. */
+  convertToShares: string;
+  // ---- User ----
+  userSuppliedAssetsEth: string;
+  userSuppliedSharesEth: string;
+  userSuppliedAssets: string;
+  userSuppliedShares: string;
+  underlyingAsset: EthAddress;
+  spoke: EthAddress;
+  decimals: number;
+}
+
+const AAVE_V4_TOKENIZED_SPOKE_ADDRESS_TO_KEY: Record<string, string> = Object.entries(
+  AAVE_V4_TOKENIZED_SPOKES,
+).reduce((acc, [k, v]) => {
+  acc[v.toLowerCase()] = k;
+  return acc;
+}, {} as Record<string, string>);
+
+/**
+ * Fetches tokenization vault data for the given user via getTokenizationSpokesData.
+ * Returns parsed data including userSuppliedAssets in human-readable form for each vault.
+ */
+export async function getAaveV4TokenizationSpokesData(
+  provider: EthereumProvider,
+  network: NetworkNumber,
+  userAddress: EthAddress,
+): Promise<AaveV4TokenizationSpokeDataParsed[]> {
+  const spokes = AAVE_V4_TOKENIZED_SPOKE_ADDRESSES[network] ?? [];
+  if (spokes.length === 0) return [];
+
+  const client = getViemProvider(provider, network);
+  const viewContract = AaveV4ViewContractViem(client, network);
+  const raw = await viewContract.read.getTokenizationSpokesData([spokes, userAddress]);
+
+  return raw.map((r: any, i: number) => {
+    const vaultAddress = spokes[i];
+    const key = AAVE_V4_TOKENIZED_SPOKE_ADDRESS_TO_KEY[vaultAddress.toLowerCase()] ?? null;
+    const symbol = wethToEth(getAssetInfoByAddress(r.underlyingAsset, network).symbol);
+    if (symbol === '?') { // unsupported asset
+      return null;
+    }
+    const hubKey = key ? key.split('_').pop() ?? '' : '';
+    const decimals = Number(r.decimals ?? 18);
+    const userSuppliedAssetsRaw = r.userSuppliedAssets ?? 0;
+    const userSuppliedSharesRaw = r.userSuppliedShares ?? 0;
+
+    const userSuppliedAssetsEth = assetAmountInEth(userSuppliedAssetsRaw.toString(), symbol);
+    const userSuppliedSharesEth = assetAmountInEth(userSuppliedSharesRaw.toString(), symbol);
+    return {
+      vaultAddress,
+      key,
+      symbol,
+      hubKey,
+      spokeActive: r.spokeActive ?? true,
+      spokeHalted: r.spokeHalted ?? false,
+      spokeDepositCap: (r.spokeDepositCap ?? 0).toString(),
+      spokeTotalAssets: (r.spokeTotalAssets ?? 0).toString(),
+      hubLiquidity: (r.hubLiquidity ?? 0).toString(),
+      convertToShares: (r.convertToShares ?? 0).toString(),
+      userSuppliedAssetsEth,
+      userSuppliedSharesEth,
+      userSuppliedAssets: userSuppliedAssetsRaw.toString(),
+      userSuppliedShares: userSuppliedSharesRaw.toString(),
+      underlyingAsset: r.underlyingAsset,
+      spoke: r.spoke,
+      decimals,
+    };
+  }).filter(item => item != null);
+}
+
+