#8133af165a Thanks @Foulks-Plb! - Add ReallocationData.getAvailableLiquidityToUtilization (with a utilization parameter) and deprecate the previous getAvailableLiquidityToTargetUtilization / targetUtilization naming.
The target utilization wording wrongly suggested a market's configured supply-target utilization, whereas the argument is just an arbitrary utilization ceiling the caller wants to bring the market to. The old method is kept as a @deprecated alias that delegates to the new one (to be removed in the next major), so existing consumers keep working. Behavior is unchanged.
Note: This package is in beta. Please test in a dev setup first.
A WDK lending module for Morpho on EVM chains. It keeps the same package shape as the Aave WDK lending module, but delegates Morpho vault and market transaction construction to @morpho-org/morpho-sdk.
About WDK
This module follows Wallet Development Kit lending protocol conventions and accepts WDK-compatible EVM wallet accounts.
Features
Deposit into Morpho Vault V2 earn targets.
Withdraw from Morpho Vaults V2.
Supply and withdraw collateral in Morpho Blue market.
Borrow and repay from a configured Morpho Blue market.
pnpm installpnpm --filter @morpho-org/wdk-protocol-lending-morpho-evm test
Quick Start
import MorphoProtocolEvm from '@morpho-org/wdk-protocol-lending-morpho-evm'// Use any WDK-compatible EVM wallet account instance.const morpho = new MorphoProtocolEvm(account, { presets: { earn: 'sky-money-usdt-savings', borrow: 'wsteth' }})// Send approval requirements first when returned by the Morpho SDK.const requirements = await morpho.getSupplyRequirements({ token: '0xdAC17F958D2ee523a2206206994597C13D831ec7', amount: 1000000n})// Then send the vault deposit transaction.await morpho.supply({ token: '0xdAC17F958D2ee523a2206206994597C13D831ec7', amount: 1000000n})
Configuration
new MorphoProtocolEvm(account, options)
Options:
chainId (number | bigint): required when using explicit Morpho targets; guards transaction building against wallet chain switches.
Built-in presets already carry their expected chain id. If you use earnVaultAddress, borrowMarketParams, or borrowMarketId directly, pass chainId so the adapter can fail before building transactions after a browser-wallet chain switch.
For vault deposits and collateral supply, pass either amount, nativeAmount, or both. nativeAmount follows Morpho SDK semantics and is only valid when the configured vault asset or collateral token is the wrapped native token for the chain.
Methods
Method
Description
supply(options, config?)
Deposit assets into the configured vault
getSupplyRequirements(options)
Return SDK requirements for vault deposit
quoteSupply(options, config?)
Quote vault deposit
withdraw(options, config?)
Withdraw assets from the configured vault
quoteWithdraw(options, config?)
Quote vault withdrawal
supplyCollateral(options, config?)
Supply collateral to the configured market
getSupplyCollateralRequirements(options)
Return SDK requirements for collateral supply
quoteSupplyCollateral(options, config?)
Quote collateral supply
borrow(options, config?)
Borrow from the configured market
getBorrowRequirements(options)
Return SDK authorization requirements for borrow
quoteBorrow(options, config?)
Quote borrow
repay(options, config?)
Repay by assets, or pass amount: 'max' to repay current borrow shares
getRepayRequirements(options)
Return SDK requirements for repay
quoteRepay(options, config?)
Quote repay
withdrawCollateral(options, config?)
Withdraw collateral from the configured market
quoteWithdrawCollateral(options, config?)
Quote collateral withdrawal
getVaultPosition(account?)
Read configured vault position
getMarketPosition(account?)
Read configured market position
getAccountData(account?)
Read combined configured vault and market position
Presets
Earn presets target Ethereum mainnet USDT vaults:
Preset
Vault
sky-money-usdt-savings
sky.money USDT Savings V2
steakhouse-prime-instant
Steakhouse Prime Instant V2
This module only builds Morpho Vault V2 earn flows. pnpm run check:vault-v2 verifies that code, docs, and tests do not reintroduce Morpho Vault V1 usage or an earn-flow selector.
Morpho SDK actions can require approvals, permit/permit2 signatures, or Morpho authorization before the final action. This module exposes those requirements through get*Requirements methods rather than reimplementing allowance or authorization logic.
For ERC-4337 accounts you can choose to batch the returned requirement transactions with the final transaction using your account-level flow. For EOA accounts, send requirements before the final operation.
Requirement entries are one of:
Approval transaction: send the returned transaction before the final action.
Morpho authorization transaction: send the returned setAuthorization transaction before borrow flows that require GeneralAdapter1 authorization.
Signature request: call the returned requirement's sign(client, userAddress) method, then pass the resulting requirementSignature to supply, repay, or supplyCollateral.
Morpho SDK enforces a builder/executor invariant for bundled actions. For that reason, onBehalfOf and vault/collateral withdrawal to must equal the connected wallet address in this WDK adapter.
Fork E2E Test
The regular unit test suite is fully mocked and runs as part of the workspace's pnpm test command. The Anvil-fork integration suite under tests/integration/ is gated on MAINNET_RPC_URL being set; the corresponding tests are skipped otherwise. To execute the real vault deposit path against a mainnet fork:
The fork test impersonates a USDT holder, funds the local test wallet, sends SDK requirements, and executes a Morpho Vault V2 deposit against forked mainnet state.
MAINNET_RPC_URL="https://eth-mainnet.g.alchemy.com/v2/<key>" pnpm test --project wdk-protocol-lending-morpho-evm
