@continuumdao/ctm-mpc-defi 0.2.9 → 0.2.11

package/dist/protocols/evm/morpho/index.d.ts

@@ -0,0 +1,522 @@
+import { b as KeyGenSubsetForPermit, e as ProtocolModule } from '../../../types-BfjWdw1j.js';
+import { Address } from 'viem';
+
+declare const MORPHO_GRAPHQL_URL = "https://api.morpho.org/graphql";
+declare function morphoGql<T>(query: string, variables?: Record<string, unknown>): Promise<T>;
+type MorphoChainRow = {
+    id: number;
+    network?: string | null;
+};
+declare function fetchMorphoChains(): Promise<readonly MorphoChainRow[]>;
+declare function loadMorphoSupportedChainIds(): Promise<ReadonlySet<number>>;
+type MorphoAssetRef = {
+    address?: string | null;
+    symbol?: string | null;
+    decimals?: number | null;
+    price?: {
+        usd?: number | null;
+    } | null;
+};
+type MorphoMarketApiRow = {
+    marketId: string;
+    loanAsset: MorphoAssetRef;
+    collateralAsset: MorphoAssetRef;
+    lltv: string;
+    irmAddress: string;
+    oracle: {
+        address: string;
+    };
+    morphoBlue: {
+        address: string;
+    };
+    state?: {
+        supplyApy?: number | null;
+        borrowApy?: number | null;
+        netSupplyApy?: number | null;
+        netBorrowApy?: number | null;
+        supplyAssetsUsd?: number | null;
+        borrowAssetsUsd?: number | null;
+        collateralAssetsUsd?: number | null;
+        utilization?: number | null;
+        rewards?: readonly {
+            asset?: MorphoAssetRef | null;
+            supplyApr?: number | null;
+            borrowApr?: number | null;
+        }[] | null;
+    } | null;
+};
+type MorphoVaultApiRow = {
+    address: string;
+    symbol?: string | null;
+    name?: string | null;
+    listed?: boolean | null;
+    asset: MorphoAssetRef;
+    chain?: {
+        id: number;
+    } | null;
+    liquidity?: {
+        usd?: number | null;
+    } | null;
+    state?: {
+        apy?: number | null;
+        netApy?: number | null;
+        fee?: number | null;
+        totalAssetsUsd?: number | null;
+        allRewards?: readonly {
+            asset?: MorphoAssetRef | null;
+            supplyApr?: number | null;
+        }[] | null;
+    } | null;
+};
+/** Morpho Vault V2 — APY/TVL on the vault node (not nested `state`). */
+type MorphoVaultV2ApiRow = {
+    address: string;
+    symbol?: string | null;
+    name?: string | null;
+    asset: MorphoAssetRef;
+    chain?: {
+        id: number;
+    } | null;
+    listed?: boolean | null;
+    apy?: number | null;
+    netApy?: number | null;
+    totalAssetsUsd?: number | null;
+    liquidityUsd?: number | null;
+    performanceFee?: number | null;
+    managementFee?: number | null;
+    rewards?: readonly {
+        asset?: MorphoAssetRef | null;
+        supplyApr?: number | null;
+    }[] | null;
+};
+declare function morphoKeyForAssetRow(args: {
+    contractAddress: string;
+    nativeWrapped?: string | null;
+}): string | null;
+declare function formatMorphoApyPct(apy: number | null | undefined): string;
+/** Morpho fee fields are decimals (0.1 = 10%). */
+declare function formatMorphoFeePct(fee: number | null | undefined): string;
+declare function formatMorphoUsd(n: number | null | undefined): string;
+
+type MorphoMarketParams = {
+    loanToken: Address;
+    collateralToken: Address;
+    oracle: Address;
+    irm: Address;
+    lltv: bigint;
+};
+type ResolvedMorphoMarket = MorphoMarketApiRow & {
+    morphoBlueAddress: Address;
+    marketParams: MorphoMarketParams;
+};
+declare function marketParamsFromApiRow(row: MorphoMarketApiRow): MorphoMarketParams;
+declare function fetchMorphoMarketById(args: {
+    chainId: number;
+    marketId: string;
+}): Promise<ResolvedMorphoMarket | null>;
+
+type MorphoEarnOfferingRow = {
+    vaultAddress: string;
+    vaultSymbol: string;
+    vaultName: string;
+    underlyingAddress: string;
+    underlyingSymbol: string;
+    underlyingDecimals: number;
+    apyLabel: string;
+    netApyLabel: string;
+    performanceFeeLabel: string;
+    managementFeeLabel: string;
+    totalAssetsUsdLabel: string;
+    liquidityUsdLabel: string;
+    netApy7dLabel: string;
+    netApy30dLabel: string;
+    netApy90dLabel: string;
+    exposure: MorphoEarnVaultExposureRow[];
+    vaultId: string;
+    /** V1 meta-morpho vault vs Vault V2 (ERC-4626). */
+    vaultGeneration: 'v1' | 'v2';
+};
+type MorphoEarnVaultExposureRow = {
+    label: string;
+    allocatedUsdLabel: string;
+    allocationPercentLabel: string;
+};
+/** Agent/MCP-facing earn vault row (V1 + V2 unified; no generation field). */
+type MorphoEarnVaultDiscoveryRow = {
+    vaultAddress: string;
+    vaultName: string;
+    vaultSymbol: string;
+    underlyingAddress: string;
+    underlyingSymbol: string;
+    apy: string;
+    netApy: string;
+    netApy7d: string;
+    netApy30d: string;
+    netApy90d: string;
+    performanceFee: string;
+    managementFee: string | null;
+    totalDepositsUsd: string;
+    liquidityUsd: string;
+    exposure: MorphoEarnVaultExposureRow[];
+};
+declare function morphoEarnOfferingToDiscoveryRow(row: MorphoEarnOfferingRow): MorphoEarnVaultDiscoveryRow;
+/** Listed Morpho earn vaults (V1 + V2). Filter by deposit asset (symbol or address) and/or vault search query. */
+declare function searchMorphoListedEarnVaults(args: {
+    chainId: number;
+    underlying?: string;
+    query?: string;
+    limit?: number;
+}): Promise<MorphoEarnVaultDiscoveryRow[]>;
+declare function isMorphoVaultListed(args: {
+    chainId: number;
+    vaultAddress: string;
+}): Promise<boolean>;
+declare function fetchMorphoVaultsForChain(chainId: number, first?: number): Promise<readonly MorphoVaultApiRow[]>;
+declare function fetchMorphoVaultV2sForChain(chainId: number, first?: number, skip?: number): Promise<readonly MorphoVaultV2ApiRow[]>;
+declare function fetchMorphoVaultByAddress(args: {
+    chainId: number;
+    vaultAddress: string;
+}): Promise<(MorphoVaultApiRow | MorphoVaultV2ApiRow) | null>;
+declare function fetchMorphoEarnOfferingsForAsset(args: {
+    chainId: number;
+    contractAddress: string;
+    underlyingDecimals: number;
+    suppliedAssetSymbol?: string;
+}): Promise<MorphoEarnOfferingRow[]>;
+type ChainAssetCache = {
+    modesByUnderlying: Map<string, {
+        earn: boolean;
+        borrow: boolean;
+        collateral: boolean;
+    }>;
+    nativeWrapped: string | null;
+};
+declare function ensureMorphoChainAssetCache(chainId: number): Promise<ChainAssetCache>;
+
+type MorphoEarnVaultDetailFields = Pick<MorphoEarnOfferingRow, 'liquidityUsdLabel' | 'netApy7dLabel' | 'netApy30dLabel' | 'netApy90dLabel' | 'exposure'>;
+declare function emptyMorphoEarnVaultDetailFields(): MorphoEarnVaultDetailFields;
+/** Full detail fetch for one vault (period APYs, liquidity, exposure). Safe for UI expand / agent single-vault lookup. */
+declare function fetchMorphoEarnVaultDetails(args: {
+    chainId: number;
+    vaultAddress: string;
+    vaultGeneration: 'v1' | 'v2';
+}): Promise<MorphoEarnVaultDetailFields>;
+/** Light enrichment (liquidity + period APYs). No exposure — use fetchMorphoEarnVaultDetails for one vault. */
+declare function enrichMorphoEarnOfferingRows(chainId: number, rows: MorphoEarnOfferingRow[]): Promise<MorphoEarnOfferingRow[]>;
+/** MCP / agent: light enrichment plus per-vault exposure (chunked to stay under API complexity limits). */
+declare function enrichMorphoEarnOfferingRowsForAgent(chainId: number, rows: MorphoEarnOfferingRow[]): Promise<MorphoEarnOfferingRow[]>;
+
+/** MCP: Morpho-listed earn vaults (V1 + V2 merged). Filter by deposit asset and/or vault name. */
+declare function morphoFetchEarnVaultsSummary(args: {
+    chainId: number;
+    underlying?: string;
+    query?: string;
+    limit?: number;
+}): Promise<{
+    vaults: MorphoEarnVaultDiscoveryRow[];
+}>;
+/** Resolve vault by address when the agent already has one; rejects unlisted vaults. */
+declare function morphoResolveListedEarnVaultByAddress(args: {
+    chainId: number;
+    vaultAddress: string;
+}): Promise<MorphoEarnVaultDiscoveryRow | null>;
+
+type MorphoBorrowMarketRow = {
+    marketId: string;
+    morphoBlueAddress: string;
+    loanAssetAddress: string;
+    loanAssetSymbol: string;
+    loanAssetDecimals: number;
+    collateralAssetAddress: string;
+    collateralAssetSymbol: string;
+    collateralAssetDecimals: number;
+    borrowApyLabel: string;
+    supplyApyLabel: string;
+    borrowAssetsUsdLabel: string;
+    lltvLabel: string;
+    marketLabel: string;
+};
+declare function fetchMorphoMarketsForChain(chainId: number, first?: number): Promise<readonly MorphoMarketApiRow[]>;
+declare function morphoMarketToBorrowRow(m: MorphoMarketApiRow): MorphoBorrowMarketRow | null;
+declare function fetchMorphoBorrowMarketsForCollateral(args: {
+    chainId: number;
+    collateralAddress: string;
+}): Promise<MorphoBorrowMarketRow[]>;
+declare function fetchMorphoBorrowMarketsForLoan(args: {
+    chainId: number;
+    loanAddress: string;
+}): Promise<MorphoBorrowMarketRow[]>;
+
+type MorphoVaultPositionRow = {
+    vaultAddress: string;
+    vaultSymbol: string;
+    underlyingSymbol: string;
+    assetsHuman: string;
+    assetsUsdLabel: string;
+    shares: string;
+};
+type MorphoBluePositionRow = {
+    marketId: string;
+    marketLabel: string;
+    loanAssetSymbol: string;
+    collateralAssetSymbol: string;
+    collateralHuman: string;
+    borrowHuman: string;
+    healthFactorLabel: string;
+    borrowMarket: MorphoBorrowMarketRow;
+};
+declare function fetchMorphoUserVaultPositions(args: {
+    user: string;
+    chainId: number;
+}): Promise<MorphoVaultPositionRow[]>;
+declare function fetchMorphoUserBluePositions(args: {
+    user: string;
+    chainId: number;
+}): Promise<MorphoBluePositionRow[]>;
+declare function fetchMorphoUserPortfolioUsd(args: {
+    user: string;
+    chainId: number;
+}): Promise<{
+    vaultUsd: number;
+    borrowCollateralUsd: number;
+    totalUsd: number;
+}>;
+declare function formatMorphoMarketApySummary(apy: number | null | undefined): string;
+
+/**
+ * Morpho Midnight (fixed-rate, fixed-term) — scaffold types until mainnet contracts/API are live.
+ * @see https://morpho.org/blog/morpho-v2-liberating-the-potential-of-onchain-loans
+ */
+type MorphoMidnightLoanIntentStatus = 'coming_soon' | 'open' | 'matched' | 'active' | 'repaid' | 'cancelled';
+type MorphoMidnightLoanIntent = {
+    id: string;
+    status: MorphoMidnightLoanIntentStatus;
+    chainId: number;
+    /** Fixed annual rate (wad or human — TBD when API ships). */
+    fixedRate?: string | null;
+    /** Loan term in seconds. */
+    durationSeconds?: number | null;
+    loanAssetSymbol?: string | null;
+    collateralAssetSymbol?: string | null;
+    amountHuman?: string | null;
+};
+declare const MORPHO_MIDNIGHT_UNAVAILABLE_MESSAGE = "Morpho Midnight fixed-rate lending is not yet available on mainnet. This tab will activate after the progressive mainnet rollout.";
+/** Placeholder until Morpho exposes Midnight GraphQL queries. */
+declare function fetchMorphoMidnightIntents(_args: {
+    chainId: number;
+    user?: string;
+}): Promise<readonly MorphoMidnightLoanIntent[]>;
+
+declare function fetchMorphoVaultAssetDecimals(args: {
+    rpcUrl: string;
+    chainId: number;
+    vault: Address;
+}): Promise<number>;
+declare function fetchMorphoVaultMaxWithdrawWei(args: {
+    rpcUrl: string;
+    chainId: number;
+    vault: Address;
+    owner: Address;
+}): Promise<bigint>;
+
+declare function previewMorphoBlueHealthAfterCollateralWithdraw(args: {
+    rpcUrl: string;
+    chainId: number;
+    morphoBlue: Address;
+    marketId: `0x${string}`;
+    user: Address;
+    withdrawCollateralWei: bigint;
+}): Promise<{
+    healthy: boolean;
+    healthFactor: number | null;
+}>;
+
+declare const MORPHO_VAULT_DEPOSIT_FALLBACK_GAS = 950000n;
+type ChainRow$3 = {
+    legacy?: boolean;
+    gasLimit?: number;
+    gasMultiplier?: number;
+    gasPrice?: number;
+    baseFee?: number;
+    priorityFee?: number;
+    baseFeeMultiplier?: number;
+};
+/**
+ * Morpho Vault V2: optional WETH wrap, ERC-20 approve, then `deposit(assets, onBehalf)`.
+ */
+declare function buildEvmMultisignBodyMorphoVaultDepositBatch(args: {
+    keyGen: KeyGenSubsetForPermit;
+    chainId: number;
+    rpcUrl: string;
+    chainDetail: ChainRow$3;
+    useCustomGas: boolean;
+    customGasChainDetails?: Record<string, unknown> | null;
+    vault: Address;
+    underlying: Address;
+    isNativeIn: boolean;
+    nativeWrapped: Address;
+    amountHuman: string;
+    onBehalf: Address;
+    executorAddress: Address;
+    purposeText: string;
+    vaultMarketLabel: string;
+}): Promise<{
+    bodyForSign: Record<string, unknown>;
+    messageToSign: string;
+}>;
+
+declare const MORPHO_VAULT_WITHDRAW_FALLBACK_GAS = 900000n;
+type ChainRow$2 = {
+    legacy?: boolean;
+    gasLimit?: number;
+    gasMultiplier?: number;
+    gasPrice?: number;
+    baseFee?: number;
+    priorityFee?: number;
+    baseFeeMultiplier?: number;
+};
+declare function buildEvmMultisignBodyMorphoVaultWithdraw(args: {
+    keyGen: KeyGenSubsetForPermit;
+    chainId: number;
+    rpcUrl: string;
+    chainDetail: ChainRow$2;
+    useCustomGas: boolean;
+    customGasChainDetails?: Record<string, unknown> | null;
+    vault: Address;
+    amountHuman: string;
+    receiver: Address;
+    vaultShareOwner?: Address;
+    executorAddress: Address;
+    purposeText: string;
+    vaultMarketLabel: string;
+}): Promise<{
+    bodyForSign: Record<string, unknown>;
+    messageToSign: string;
+}>;
+
+declare const MORPHO_BLUE_COLLATERAL_DEPOSIT_FALLBACK_GAS = 1200000n;
+declare const MORPHO_BLUE_BORROW_FALLBACK_GAS = 1100000n;
+declare const MORPHO_BLUE_REPAY_FALLBACK_GAS = 1000000n;
+declare const MORPHO_BLUE_COLLATERAL_WITHDRAW_FALLBACK_GAS = 900000n;
+type ChainRow$1 = {
+    legacy?: boolean;
+    gasLimit?: number;
+    gasMultiplier?: number;
+    gasPrice?: number;
+    baseFee?: number;
+    priorityFee?: number;
+    baseFeeMultiplier?: number;
+};
+declare function buildEvmMultisignBodyMorphoBlueSupplyCollateralBatch(args: {
+    keyGen: KeyGenSubsetForPermit;
+    chainId: number;
+    rpcUrl: string;
+    chainDetail: ChainRow$1;
+    useCustomGas: boolean;
+    customGasChainDetails?: Record<string, unknown> | null;
+    morphoBlue: Address;
+    marketParams: MorphoMarketParams;
+    collateralToken: Address;
+    isNativeIn?: boolean;
+    nativeWrapped?: Address;
+    amountHuman: string;
+    onBehalf: Address;
+    executorAddress: Address;
+    purposeText: string;
+    marketLabel: string;
+}): Promise<{
+    bodyForSign: Record<string, unknown>;
+    messageToSign: string;
+}>;
+declare function buildEvmMultisignBodyMorphoBlueBorrowBatch(args: {
+    keyGen: KeyGenSubsetForPermit;
+    chainId: number;
+    rpcUrl: string;
+    chainDetail: ChainRow$1;
+    useCustomGas: boolean;
+    customGasChainDetails?: Record<string, unknown> | null;
+    morphoBlue: Address;
+    marketParams: MorphoMarketParams;
+    loanToken: Address;
+    amountHuman: string;
+    onBehalf: Address;
+    receiver: Address;
+    executorAddress: Address;
+    purposeText: string;
+    marketLabel: string;
+}): Promise<{
+    bodyForSign: Record<string, unknown>;
+    messageToSign: string;
+}>;
+declare function buildEvmMultisignBodyMorphoBlueRepayBatch(args: {
+    keyGen: KeyGenSubsetForPermit;
+    chainId: number;
+    rpcUrl: string;
+    chainDetail: ChainRow$1;
+    useCustomGas: boolean;
+    customGasChainDetails?: Record<string, unknown> | null;
+    morphoBlue: Address;
+    marketParams: MorphoMarketParams;
+    loanToken: Address;
+    amountHuman: string;
+    onBehalf: Address;
+    executorAddress: Address;
+    purposeText: string;
+    marketLabel: string;
+}): Promise<{
+    bodyForSign: Record<string, unknown>;
+    messageToSign: string;
+}>;
+declare function buildEvmMultisignBodyMorphoBlueWithdrawCollateralBatch(args: {
+    keyGen: KeyGenSubsetForPermit;
+    chainId: number;
+    rpcUrl: string;
+    chainDetail: ChainRow$1;
+    useCustomGas: boolean;
+    customGasChainDetails?: Record<string, unknown> | null;
+    morphoBlue: Address;
+    marketParams: MorphoMarketParams;
+    amountHuman: string;
+    collateralDecimals: number;
+    onBehalf: Address;
+    receiver: Address;
+    executorAddress: Address;
+    purposeText: string;
+    marketLabel: string;
+}): Promise<{
+    bodyForSign: Record<string, unknown>;
+    messageToSign: string;
+}>;
+
+type ChainRow = {
+    legacy?: boolean;
+    gasLimit?: number;
+    gasMultiplier?: number;
+    gasPrice?: number;
+    baseFee?: number;
+    priorityFee?: number;
+    baseFeeMultiplier?: number;
+};
+/** Merkl `Distributor.claim` — same calldata pattern as Euler v2 / Aave. */
+declare function buildEvmMultisignBodyMorphoMerklDistributorClaim(args: {
+    keyGen: KeyGenSubsetForPermit;
+    chainId: number;
+    rpcUrl: string;
+    chainDetail: ChainRow;
+    useCustomGas: boolean;
+    customGasChainDetails?: Record<string, unknown> | null;
+    to: Address;
+    data: `0x${string}`;
+    valueWei: bigint;
+    claimLeafCount: number;
+    executorAddress: Address;
+    purposeText: string;
+}): Promise<{
+    bodyForSign: Record<string, unknown>;
+    messageToSign: string;
+}>;
+
+declare const MORPHO_PROTOCOL_ID = "morpho";
+declare const morphoProtocolModule: ProtocolModule;
+
+export { MORPHO_BLUE_BORROW_FALLBACK_GAS, MORPHO_BLUE_COLLATERAL_DEPOSIT_FALLBACK_GAS, MORPHO_BLUE_COLLATERAL_WITHDRAW_FALLBACK_GAS, MORPHO_BLUE_REPAY_FALLBACK_GAS, MORPHO_GRAPHQL_URL, MORPHO_MIDNIGHT_UNAVAILABLE_MESSAGE, MORPHO_PROTOCOL_ID, MORPHO_VAULT_DEPOSIT_FALLBACK_GAS, MORPHO_VAULT_WITHDRAW_FALLBACK_GAS, type MorphoAssetRef, type MorphoBluePositionRow, type MorphoBorrowMarketRow, type MorphoChainRow, type MorphoEarnOfferingRow, type MorphoEarnVaultDetailFields, type MorphoEarnVaultDiscoveryRow, type MorphoEarnVaultExposureRow, type MorphoMarketApiRow, type MorphoMarketParams, type MorphoMidnightLoanIntent, type MorphoMidnightLoanIntentStatus, type MorphoVaultApiRow, type MorphoVaultPositionRow, type MorphoVaultV2ApiRow, type ResolvedMorphoMarket, buildEvmMultisignBodyMorphoBlueBorrowBatch, buildEvmMultisignBodyMorphoBlueRepayBatch, buildEvmMultisignBodyMorphoBlueSupplyCollateralBatch, buildEvmMultisignBodyMorphoBlueWithdrawCollateralBatch, buildEvmMultisignBodyMorphoMerklDistributorClaim, buildEvmMultisignBodyMorphoVaultDepositBatch, buildEvmMultisignBodyMorphoVaultWithdraw, emptyMorphoEarnVaultDetailFields, enrichMorphoEarnOfferingRows, enrichMorphoEarnOfferingRowsForAgent, ensureMorphoChainAssetCache, fetchMorphoBorrowMarketsForCollateral, fetchMorphoBorrowMarketsForLoan, fetchMorphoChains, fetchMorphoEarnOfferingsForAsset, fetchMorphoEarnVaultDetails, fetchMorphoMarketById, fetchMorphoMarketsForChain, fetchMorphoMidnightIntents, fetchMorphoUserBluePositions, fetchMorphoUserPortfolioUsd, fetchMorphoUserVaultPositions, fetchMorphoVaultAssetDecimals, fetchMorphoVaultByAddress, fetchMorphoVaultMaxWithdrawWei, fetchMorphoVaultV2sForChain, fetchMorphoVaultsForChain, formatMorphoApyPct, formatMorphoFeePct, formatMorphoMarketApySummary, formatMorphoUsd, isMorphoVaultListed, loadMorphoSupportedChainIds, marketParamsFromApiRow, morphoEarnOfferingToDiscoveryRow, morphoFetchEarnVaultsSummary, morphoGql, morphoKeyForAssetRow, morphoMarketToBorrowRow, morphoProtocolModule, morphoResolveListedEarnVaultByAddress, previewMorphoBlueHealthAfterCollateralWithdraw, searchMorphoListedEarnVaults };