@continuumdao/ctm-mpc-defi 0.2.0 → 0.2.2

package/dist/protocols/evm/aave-v4/index.d.ts

@@ -1,6 +1,5 @@
-import { d as ProtocolModule } from '../../../types-Ce2qNHai.js';
+import { b as KeyGenSubsetForPermit, e as ProtocolModule } from '../../../types-BfjWdw1j.js';
 import { Address } from 'viem';
-import { K as KeyGenSubsetForPermit } from '../../../keygen-DsINazx8.js';
 
 declare const AAVE_V4_GRAPHQL_URL = "https://api.v4.aave.com/graphql";
 declare function aaveV4Gql<T>(query: string, variables?: Record<string, unknown>): Promise<T>;
@@ -494,7 +493,423 @@ declare function isAaveV4DepositEvmSignRequest(detail: Record<string, unknown> |
  */
 declare function resolveAaveV4DepositGasUnitsFromSignRequest(detail: Record<string, unknown> | null | undefined, batchIndex?: number): bigint | null;
 
+type AaveV4ExchangeAmount = {
+    value: string;
+    name: string;
+    symbol: string;
+};
+type AaveV4SpokeLiquidationConfig = {
+    targetHealthFactor: string;
+    healthFactorForMaxBonus: string;
+};
+type AaveV4UserPositionRow = {
+    id: string;
+    user: string;
+    createdAt: string;
+    spoke: {
+        id: string;
+        name: string;
+        address: string;
+        chain: {
+            chainId: number;
+            name?: string | null;
+        };
+        liquidationConfig: AaveV4SpokeLiquidationConfig | null;
+    };
+    totalSupplied: {
+        current: AaveV4ExchangeAmount;
+    };
+    totalDebt: {
+        current: AaveV4ExchangeAmount;
+    };
+    netBalance: {
+        current: AaveV4ExchangeAmount;
+    };
+    healthFactor: {
+        current: string | null;
+        change: {
+            normalized: string;
+            value: string;
+        };
+    };
+    netApy: {
+        normalized: string;
+        value: string;
+    };
+};
+type AaveV4UserPositionDetail = {
+    id: string;
+    user: string;
+    createdAt: string;
+    spoke: AaveV4UserPositionRow['spoke'];
+    totalSupplied: {
+        current: AaveV4ExchangeAmount;
+        change: {
+            normalized: string;
+            value: string;
+        };
+    };
+    totalCollateral: {
+        current: AaveV4ExchangeAmount;
+        change: {
+            normalized: string;
+            value: string;
+        };
+    };
+    totalDebt: {
+        current: AaveV4ExchangeAmount;
+        change: {
+            normalized: string;
+            value: string;
+        };
+    };
+    netBalance: {
+        current: AaveV4ExchangeAmount;
+        change: {
+            normalized: string;
+            value: string;
+        };
+    };
+    netCollateral: {
+        current: AaveV4ExchangeAmount;
+        change: {
+            normalized: string;
+            value: string;
+        };
+    };
+    netApy: {
+        normalized: string;
+        value: string;
+    };
+    netSupplyApy: {
+        current: {
+            normalized: string;
+        };
+    };
+    netBorrowApy: {
+        current: {
+            normalized: string;
+        };
+    };
+    netAccruedInterest: AaveV4ExchangeAmount;
+    healthFactor: {
+        current: string | null;
+        change: {
+            normalized: string;
+            value: string;
+        };
+    };
+    maxBorrowingPower: AaveV4ExchangeAmount;
+    remainingBorrowingPower: AaveV4ExchangeAmount;
+    averageCollateralFactor: {
+        normalized: string;
+    };
+    liquidationPrice: AaveV4ExchangeAmount | null;
+    canUpdateDynamicConfig: boolean;
+    netBalancePercentChange: {
+        normalized: string;
+    };
+};
+type Erc20TokenInfo = {
+    symbol: string;
+    name: string;
+    icon: string | null;
+} | null;
+type AaveV4UserSupplyRow = {
+    id: string;
+    isCollateral: boolean;
+    principal: {
+        amount: {
+            value: string;
+        };
+        token: {
+            address: string;
+            info: Erc20TokenInfo;
+        };
+    };
+    balance: {
+        amount: {
+            value: string;
+        };
+        token: {
+            address: string;
+            info: {
+                symbol: string;
+                name?: string;
+            } | null;
+        };
+    };
+    withdrawable: {
+        amount: {
+            value: string;
+        };
+        token: {
+            address: string;
+            info: {
+                symbol: string;
+            } | null;
+        };
+    };
+    interest: {
+        amount: {
+            value: string;
+        };
+        token: {
+            address: string;
+            info: {
+                symbol: string;
+            } | null;
+        };
+    };
+    reserve: {
+        id: string;
+        onChainId?: string | null;
+        summary: {
+            supplyApy: {
+                normalized: string;
+                value: string;
+            } | null;
+        } | null;
+        asset: {
+            underlying: {
+                address: string;
+                info: Erc20TokenInfo;
+            };
+        };
+    };
+};
+declare function formatAaveV4ExchangeLabel(ex: {
+    name?: string;
+    symbol?: string;
+} | null | undefined): string;
+declare function formatAaveV4PositionPercent(normalized: string | undefined, value: string | undefined): string;
+declare function formatAaveV4PositionHealthFactor(raw: string | null | undefined): string;
+declare function fetchAaveV4UserPositionsForChain(args: {
+    user: string;
+    chainId: number;
+}): Promise<readonly AaveV4UserPositionRow[]>;
+type AaveV4UserPositionsByAsset = {
+    forAsset: readonly AaveV4UserPositionRow[];
+    other: readonly AaveV4UserPositionRow[];
+    filterUnderlying: `0x${string}` | null;
+};
+declare function fetchAaveV4UserPositionsByAssetOnChain(args: {
+    user: string;
+    chainId: number;
+    filterUnderlying: `0x${string}` | null;
+}): Promise<AaveV4UserPositionsByAsset>;
+declare function fetchAaveV4UserPositionById(positionId: string): Promise<AaveV4UserPositionDetail | null>;
+declare function fetchAaveV4UserSuppliesForPosition(userPositionId: string): Promise<readonly AaveV4UserSupplyRow[]>;
+/**
+ * True when the wallet has a positive supplied balance of `contextUnderlying` on this Spoke **and** the index marks
+ * it as used as collateral (`isCollateral`). Use this to gate **new borrows**; **repay** should rely on variable debt
+ * only, so users can repay after turning collateral off.
+ */
+declare function aaveV4UserHasAvailableBorrowCollateralForContextOnSpoke(args: {
+    user: `0x${string}`;
+    chainId: number;
+    contextUnderlying: `0x${string}`;
+    spokeAddress: `0x${string}`;
+}): Promise<boolean>;
+declare function formatAaveV4DecimalString(raw: string | undefined | null, maxFractionDigits?: number): string;
+/**
+ * For risk / borrow notional: show enough digits for small positive USD (or fiat) so values like
+ * 0.0034 don’t get lost; keep net balance in {@link formatAaveV4DecimalString} for larger numbers.
+ */
+declare function formatAaveV4RiskNotionalString(raw: string | undefined | null): string;
+declare function formatAaveV4HealthFactor(raw: string | null | undefined): string;
+type AaveV4WithdrawHealthGateResult = {
+    outcome: 'allow';
+} | {
+    outcome: 'block';
+    reason: string;
+} | {
+    outcome: 'confirm';
+    reason: string;
+    targetHealthFactor: number;
+    healthFactorForMaxBonus: number;
+};
+declare function aaveV4WithdrawHealthGate(args: {
+    resultingHealthFactor: number | null;
+    hasBorrowDebt: boolean;
+    liquidationConfig: AaveV4SpokeLiquidationConfig | null | undefined;
+}): AaveV4WithdrawHealthGateResult;
+/**
+ * After a **borrow** (or any action that lowers HF), use the same numeric gates as
+ * {@link aaveV4WithdrawHealthGate} for resulting health factor.
+ */
+declare function aaveV4BorrowHealthGate(args: {
+    resultingHealthFactor: number | null;
+    liquidationConfig: AaveV4SpokeLiquidationConfig | null | undefined;
+}): AaveV4WithdrawHealthGateResult;
+/**
+ * After **repay**, the protocol usually improves HF; we only block clearly dangerous previews.
+ * Pass `strict: true` to apply the same thresholds as {@link aaveV4WithdrawHealthGate}.
+ */
+declare function aaveV4RepayHealthGate(args: {
+    resultingHealthFactor: number | null;
+    liquidationConfig: AaveV4SpokeLiquidationConfig | null | undefined;
+    /** When true, apply the same 1.0 / max-bonus / target rules as a withdrawal (rare for repay). */
+    strict: boolean;
+}): AaveV4WithdrawHealthGateResult;
+
+/**
+ * Built in {@link AaveV4Dialog} and consumed by the multi-sign page handler (withdraw / Merkl claim).
+ */
+type AaveV4PositionActionPayload = {
+    kind: 'claim';
+    /** Purpose / gas for this Merkl request (own fields in the Positions tab, not the shared Aave v4 form state on the page). */
+    purposeText: string;
+    useCustomGas: boolean;
+} | {
+    kind: 'withdraw';
+    reserveGraphqlId: string;
+    /** GraphQL or RPC-resolved on-chain id for `Spoke.withdraw`, when available. */
+    reserveOnChainId: string | null;
+    underlying: `0x${string}`;
+    amountHuman: string;
+    withdrawRiskAck: boolean;
+    spokeAddress: `0x${string}`;
+    /** Spoke display name for sign-request metadata. */
+    spokeName: string;
+    liquidationConfig: AaveV4SpokeLiquidationConfig | null;
+    hasBorrowDebt: boolean;
+} | {
+    kind: 'borrow';
+    reserveGraphqlId: string;
+    reserveOnChainId: string | null;
+    underlying: `0x${string}`;
+    amountHuman: string;
+    borrowRiskAck: boolean;
+    spokeAddress: `0x${string}`;
+    spokeName: string;
+    liquidationConfig: AaveV4SpokeLiquidationConfig | null;
+} | {
+    kind: 'repay';
+    reserveGraphqlId: string;
+    reserveOnChainId: string | null;
+    underlying: `0x${string}`;
+    amountHuman: string;
+    spokeAddress: `0x${string}`;
+    spokeName: string;
+};
+declare function parseBigDecimalHf(s: string | null | undefined): number | null;
+/**
+ * @returns resulting HF `after` when preview is `PreviewUserPosition` with a variation, else `null` on error or unknown.
+ */
+declare function previewAaveV4WithdrawResultingHf(args: {
+    user: `0x${string}`;
+    reserveId: string;
+    amountExactHuman: string;
+}): Promise<{
+    resultingHf: number | null;
+    error: string | null;
+}>;
+/**
+ * @returns resulting HF `after` for a borrow preview, or error from the API.
+ */
+declare function previewAaveV4BorrowResultingHf(args: {
+    user: `0x${string}`;
+    reserveGraphqlId: string;
+    amountExactHuman: string;
+}): Promise<{
+    resultingHf: number | null;
+    error: string | null;
+}>;
+/**
+ * @returns resulting HF `after` for a repay preview.
+ */
+declare function previewAaveV4RepayResultingHf(args: {
+    user: `0x${string}`;
+    reserveGraphqlId: string;
+    amountExactHuman: string;
+}): Promise<{
+    resultingHf: number | null;
+    error: string | null;
+}>;
+type AaveV4MerklClaimableRewardRow = {
+    id: string;
+    tokenSymbol: string;
+    tokenName: string;
+    tokenAddress: string;
+    /** Human amount string from the API (reward token units). */
+    amountValue: string;
+    /** Approximate notional in `exchangeLabel` (often USD) when present. */
+    exchangeValue: string | null;
+    exchangeLabel: string;
+};
+declare function fetchAaveV4MerklClaimableRewardsForChain(args: {
+    user: `0x${string}`;
+    chainId: number;
+}): Promise<readonly AaveV4MerklClaimableRewardRow[]>;
+declare function fetchAaveV4MerklClaimRewardIdsForChain(args: {
+    user: `0x${string}`;
+    chainId: number;
+}): Promise<readonly string[]>;
+type AaveV4ClaimRewardsTx = {
+    to: `0x${string}`;
+    from: `0x${string}`;
+    data: `0x${string}`;
+    value: string;
+    chainId: string;
+};
+declare function fetchAaveV4ClaimRewardsCalldata(args: {
+    user: `0x${string}`;
+    chainId: number;
+    rewardIds: readonly string[];
+}): Promise<AaveV4ClaimRewardsTx | null>;
+
+/**
+ * Aave v4: supported EVM chain IDs from `https://api.v4.aave.com/graphql` (`chains` query).
+ * @see https://aave.com/docs/aave-v4/liquidity/chains
+ */
+declare function loadAaveV4SupportedChainIds(): Promise<ReadonlySet<number>>;
+
+type AavePercentValueLike = {
+    formatted: string;
+    value: string;
+} | null | undefined;
+type AaveDecimalValueLike = {
+    raw: string;
+    decimals: number;
+    value: string;
+} | null | undefined;
+type AaveSupplyInfoLike = {
+    apy?: AavePercentValueLike;
+    total?: AaveDecimalValueLike;
+} | null | undefined;
+type AaveBorrowInfoLike = {
+    total?: {
+        amount?: AaveDecimalValueLike;
+    } | null;
+} | null | undefined;
+/**
+ * Format Aave `PercentValue.formatted` for UI (e.g. supply/borrow APY), appending a % if missing.
+ */
+declare function formatAavePercentDisplay(p: AavePercentValueLike): string;
+/**
+ * Free liquidity in the reserve: supplied liquidity minus total borrowed (underlying, token units as string).
+ */
+declare function aaveAvailableLiquidityDisplay(supplyInfo: AaveSupplyInfoLike, borrowInfo: AaveBorrowInfoLike): string;
+/**
+ * Map Assets row / native to Aave market underlying. Native uses the chain’s wrapped token address from the API.
+ */
+declare function aaveUnderlyingAddressForContext(args: {
+    contextContract: string;
+    chainNativeWrapped: string | null | undefined;
+}): `0x${string}`;
+declare function isValidAaveChainId(assetsChainId: string | undefined | null): boolean;
+/**
+ * Per-reserve supply rows from the Aave client `market` call (shaped for read-only display).
+ */
+declare function aaveReadSupplyMetrics(reserve: unknown, symbolForDisplay: string): {
+    depositedAmount: string;
+    apy: string;
+    totalDeposits: string;
+    availableLiquidity: string;
+};
+
 declare const AAVE_V4_PROTOCOL_ID = "aave-v4";
 declare const aaveV4ProtocolModule: ProtocolModule;
 
-export { AAVE_V4_GRAPHQL_URL, AAVE_V4_PROTOCOL_ID, AAVE_V4_SPOKE_BORROW_DEFAULT_GAS_UNITS, AAVE_V4_SPOKE_REPAY_DEFAULT_GAS_UNITS, AAVE_V4_SPOKE_SUPPLY_DEFAULT_GAS_UNITS, AAVE_V4_SPOKE_WITHDRAW_DEFAULT_GAS_UNITS, type AaveV4BorrowTableRow, type AaveV4BorrowableDisplay, type AaveV4Hub, type AaveV4HubReserve, type AaveV4HubReserveSummary, type AaveV4SpokeOnChainReserveStatus, type AaveV4UiMarketId, MIN_AAVE_V4_DEPOSIT_GAS_EXEC, type V4ReservesListRow, aaveV4Gql, aaveV4KeyForNodeAssetRow, aaveV4ProtocolModule, aaveV4UiMarketIdForHubName, aggregateV4SupplyDisplay, borrowableAssetsFromHubReserves, buildAaveV4BorrowTableRowsFromHub, buildEvmMultisignBodyAaveV4DepositBatch, buildEvmMultisignBodyAaveV4MerklClaimRewards, buildEvmMultisignBodyAaveV4SpokeBorrow, buildEvmMultisignBodyAaveV4SpokeRepay, buildEvmMultisignBodyAaveV4SpokeWithdraw, buildEvmMultisignBodyEulerV2MerklDistributorClaim, buildEvmMultisignBodyEulerV2ReulUnlock, ensureAaveV4ChainTokenCache, fetchAaveV4Chains, fetchAaveV4HubReserves, fetchAaveV4HubsForChain, fetchAaveV4NativeWrappedToken, fetchAaveV4ReservesForUnderlying, fetchAaveV4SpokeReserveIdForUnderlying, fetchAaveV4SpokeReserveStatusForUnderlying, fetchAaveV4SupportedUnderlyingAddressSet, fetchAaveV4UserBorrowsDebtByUnderlyingForHub, findAaveV4HubReserveForChainUnderlying, findHubReserveForUnderlying, formatAaveV4AmountHumanFromApiString, formatAaveV4PercentDisplay, formatAaveV4ReserveLiquidityFromSummary, formatAaveV4RiskDisplay, formatAaveV4TokenAmount, isAaveV4DepositEvmSignRequest, loadAaveV4SupportedChainIdsFromV4Api, pickAaveV4ReserveRowForSpoke, resolveAaveV4DepositGasUnitsFromSignRequest, resolveAaveV4HubForUiMarket };
+export { AAVE_V4_GRAPHQL_URL, AAVE_V4_PROTOCOL_ID, AAVE_V4_SPOKE_BORROW_DEFAULT_GAS_UNITS, AAVE_V4_SPOKE_REPAY_DEFAULT_GAS_UNITS, AAVE_V4_SPOKE_SUPPLY_DEFAULT_GAS_UNITS, AAVE_V4_SPOKE_WITHDRAW_DEFAULT_GAS_UNITS, type AaveBorrowInfoLike, type AaveDecimalValueLike, type AavePercentValueLike, type AaveSupplyInfoLike, type AaveV4BorrowTableRow, type AaveV4BorrowableDisplay, type AaveV4ClaimRewardsTx, type AaveV4ExchangeAmount, type AaveV4Hub, type AaveV4HubReserve, type AaveV4HubReserveSummary, type AaveV4MerklClaimableRewardRow, type AaveV4PositionActionPayload, type AaveV4SpokeLiquidationConfig, type AaveV4SpokeOnChainReserveStatus, type AaveV4UiMarketId, type AaveV4UserPositionDetail, type AaveV4UserPositionRow, type AaveV4UserPositionsByAsset, type AaveV4UserSupplyRow, type AaveV4WithdrawHealthGateResult, MIN_AAVE_V4_DEPOSIT_GAS_EXEC, type V4ReservesListRow, aaveAvailableLiquidityDisplay, aaveReadSupplyMetrics, aaveUnderlyingAddressForContext, aaveV4BorrowHealthGate, aaveV4Gql, aaveV4KeyForNodeAssetRow, aaveV4ProtocolModule, aaveV4RepayHealthGate, aaveV4UiMarketIdForHubName, aaveV4UserHasAvailableBorrowCollateralForContextOnSpoke, aaveV4WithdrawHealthGate, aggregateV4SupplyDisplay, borrowableAssetsFromHubReserves, buildAaveV4BorrowTableRowsFromHub, buildEvmMultisignBodyAaveV4DepositBatch, buildEvmMultisignBodyAaveV4MerklClaimRewards, buildEvmMultisignBodyAaveV4SpokeBorrow, buildEvmMultisignBodyAaveV4SpokeRepay, buildEvmMultisignBodyAaveV4SpokeWithdraw, buildEvmMultisignBodyEulerV2MerklDistributorClaim, buildEvmMultisignBodyEulerV2ReulUnlock, ensureAaveV4ChainTokenCache, fetchAaveV4Chains, fetchAaveV4ClaimRewardsCalldata, fetchAaveV4HubReserves, fetchAaveV4HubsForChain, fetchAaveV4MerklClaimRewardIdsForChain, fetchAaveV4MerklClaimableRewardsForChain, fetchAaveV4NativeWrappedToken, fetchAaveV4ReservesForUnderlying, fetchAaveV4SpokeReserveIdForUnderlying, fetchAaveV4SpokeReserveStatusForUnderlying, fetchAaveV4SupportedUnderlyingAddressSet, fetchAaveV4UserBorrowsDebtByUnderlyingForHub, fetchAaveV4UserPositionById, fetchAaveV4UserPositionsByAssetOnChain, fetchAaveV4UserPositionsForChain, fetchAaveV4UserSuppliesForPosition, findAaveV4HubReserveForChainUnderlying, findHubReserveForUnderlying, formatAavePercentDisplay, formatAaveV4AmountHumanFromApiString, formatAaveV4DecimalString, formatAaveV4ExchangeLabel, formatAaveV4HealthFactor, formatAaveV4PercentDisplay, formatAaveV4PositionHealthFactor, formatAaveV4PositionPercent, formatAaveV4ReserveLiquidityFromSummary, formatAaveV4RiskDisplay, formatAaveV4RiskNotionalString, formatAaveV4TokenAmount, isAaveV4DepositEvmSignRequest, isValidAaveChainId, loadAaveV4SupportedChainIds, loadAaveV4SupportedChainIdsFromV4Api, parseBigDecimalHf, pickAaveV4ReserveRowForSpoke, previewAaveV4BorrowResultingHf, previewAaveV4RepayResultingHf, previewAaveV4WithdrawResultingHf, resolveAaveV4DepositGasUnitsFromSignRequest, resolveAaveV4HubForUiMarket };