Moonwell

Moonwell Core Market first supply walkthrough with withdrawal limits

Supplying a supported asset to a Moonwell Core Market creates an mToken position that accrues the market's variable base interest. For a first supply, choose the correct market, approve the token when an allowance is required and then submit the separate supply transaction. Confirm completion through the wallet receipt and visible position. A later withdrawal redeems mTokens, but the available amount depends on unborrowed market liquidity and whether the position supports an active loan.

Key takeaway: A successful first supply in a Moonwell Core Market creates an mToken position, while withdrawal capacity depends on unborrowed liquidity and any collateral-backed debt.

Choose between a supply-only and collateral position

The first decision is whether the supplied asset will earn interest only or also support borrowing. A supply-only position doesn't need collateral enabled. Keeping those functions separate avoids adding account-level borrowing constraints to a deposit whose purpose is simply to supply liquidity.

Collateral can be enabled through a separate transaction if the position will support a loan. Once debt relies on that asset, withdrawing it can reduce the account's borrowing capacity. A withdrawal that would leave the loan outside its permitted collateral limits won't complete. Repaying debt or adding eligible collateral may be necessary before the supplied asset can be removed.

This choice doesn't lock the asset into one role forever. The collateral setting can change while the resulting account still satisfies the market's risk parameters. Review the intended role before the first supply. If the asset later backs a loan, a withdrawal must also preserve the account's collateral limits.


Token approval is separate from supply when required

When a token allowance is required, approval authorizes the relevant contract to transfer up to the approved amount of that asset from the wallet. It doesn't place that asset into the lending market. After approval confirms, the supply action must still be submitted and executed.

An existing sufficient allowance may let the interface proceed directly to supply. Otherwise, the wallet can show two confirmations: one for approval and another for the deposit. Read each request before signing. The selected network, asset and amount should match the intended market, and the wallet may need funds for each transaction fee.

The supply transaction moves the selected asset into the market and creates the corresponding position. Closing the approval window early, rejecting the second request or seeing only an approval receipt means the deposit hasn't finished. This distinction matters when diagnosing a missing position because repeating approval alone won't create one.

What confirms a completed supply?

A completed supply has a successful transaction receipt and a matching supplied position in the connected account. The position should identify the asset and show its supplied value or balance. The underlying wallet balance also changes by the amount transferred, apart from any applicable transaction fee.

A pending transaction isn't final evidence. Wait until the network records a successful execution, then refresh the portfolio state if the interface hasn't updated. If the receipt shows failure, the expected position wasn't created even if the wallet displayed an earlier approval as successful.

The displayed annual percentage yield is a live estimate rather than a rate fixed at deposit time. Base interest accrues through the supplied position as market conditions change. The proof of entry is therefore the confirmed position, not the rate that happened to appear before submission.


mTokens connect the deposit to redemption

mTokens are ERC-20 tokens that track supplied positions in Moonwell Core Markets. Each supported Core Market has its own corresponding mToken. Supplying mints that representation, while withdrawing redeems it for the underlying asset and burns the corresponding mTokens. The position's underlying value can grow as base interest accrues because the exchange rate between mTokens and the underlying asset changes. Treat an mToken as the onchain record of the market position, not as an unrelated reward token.

Why can the withdrawable amount be lower than the supplied balance?

The withdrawable amount can be lower because a displayed position and immediately available market liquidity measure different things. A supplier owns a claim represented by mTokens, while some underlying assets may currently be borrowed by other accounts.

A withdrawal can complete only when the market has enough unborrowed liquidity for the requested amount. Liquidity can rise when another supplier adds assets or when borrowers repay. A smaller withdrawal may fit the available balance when a full redemption doesn't, although the market state can change before the transaction executes.

An active loan adds a second boundary. If the supplied asset is enabled as collateral, removing too much of it can reduce credit remaining beyond the permitted level. Available market liquidity doesn't override that account constraint. Both the market's cash position and the account's collateral state must support the requested withdrawal.

A reversible path after a rejected withdrawal

The normal path ends with a successful transaction and the underlying asset returning to the connected wallet. The mToken position decreases by the redeemed portion, while any unredeemed balance remains supplied.

A failed transaction shows that no withdrawal completed, but it doesn't identify the cause by itself. Check that the transaction is final rather than pending, then confirm that the supplied position remains present before changing the request.

Compare the requested amount with the market's available liquidity. If the request exceeds that liquidity, waiting for repayments or new supply preserves the position while conditions change. Requesting a smaller amount is another reversible check when sufficient liquidity exists for only part of the balance.

If liquidity appears sufficient, inspect whether the asset supports an active borrow. A collateral restriction calls for an account adjustment, not repeated submission of the same withdrawal. Repaying part of the debt or adding eligible collateral can change the available credit before another attempt.

  • Confirm whether the transaction failed, succeeded or remains pending.
  • Check that the supplied position hasn't already decreased.
  • Compare the requested amount with current unborrowed liquidity.
  • Review collateral status and credit remaining when debt is active.
  • Retry only after the blocking amount or account condition has changed.

The next successful receipt should align with two visible changes: more underlying assets in the wallet and fewer assets left in the supplied position. If either condition changes before a retry, check liquidity and collateral again before choosing the withdrawal amount.

Rates, rewards and transaction costs after supply

Base supply rates vary with utilization, so that component of the displayed APY can rise or fall after the first deposit. Base interest accrues through the mToken position without a separate claim. Incentive rewards, when offered, are distinct and require a manual claim. Approval, supply, withdrawal and reward claims can each involve network transactions, making fee conditions relevant to small positions. The cost depends on how many transactions the flow requires, the selected network and current gas conditions.

Rates, rewards and transaction costs after supply: Base supply rates vary with utilization, so that component of the displayed APY can rise or fall after the first deposit. Base interest accrues through the mToken position without a separate claim. Incentive rewards, when offered, are distinct and require a manual claim. Approval, supply, withdrawal and reward claims can each involve network transactions, making fee conditions relevant to small positions. The cost depends on how many transactions the flow requires, the selected network and current gas conditions.

View image file

Moonwell FAQ

Does revoking token approval undo an existing supply?

No, revoking an allowance doesn't remove an asset that has already been supplied. The completed supply is represented by mTokens, while the allowance governs future transfers from the wallet. Revocation can prevent another supply transaction from using that approval, so a later deposit may require a new allowance. It doesn't redeem the current position or return the underlying asset.

Will a partial withdrawal stop interest on the remaining position?

No, the portion left in the market remains supplied and continues accruing the variable base rate. The redeemed portion returns to the wallet and no longer participates in that lending market. After confirmation, the portfolio should show a smaller supplied position. Its future return still follows the market's utilization and rate model rather than the rate displayed when the original deposit was made.

Are incentive rewards returned automatically with a withdrawal?

Not necessarily. Base interest is reflected through the mToken position and is included when the corresponding underlying value is redeemed. Separate incentive rewards work differently and must be claimed through the rewards flow. Their availability and amount can change by market or program, so withdrawing the supplied asset doesn't claim any pending incentives.

Can one wallet hold several supplied assets?

Yes, one wallet can maintain positions in several supported Core Markets. Each supplied asset has its own mToken representation, variable rate and market liquidity. Approval and supply transactions are handled for the selected asset rather than as one combined deposit. Collateral status is also managed by asset, so using one position to support debt doesn't automatically give every supplied asset the same role.

Is a supply-only position exposed to liquidation?

A position that only supplies assets and doesn't support borrowing isn't subject to borrower liquidation. Liquidation becomes relevant when supplied collateral backs active debt and the account falls outside its permitted credit boundary. The supply still carries smart-contract and market-liquidity risks, but those are different from liquidation. Enabling collateral without an active borrow doesn't by itself create outstanding debt.

What happens to mTokens when a withdrawal transaction reverts?

A reverted withdrawal doesn't complete the redemption, so its state changes are rolled back and the mToken position should remain. Check the final transaction status and refresh the portfolio before submitting another request. If the position is unchanged, inspect available liquidity and any collateral-backed debt. Repeating the same transaction without changing a blocking condition can produce the same failure.

Do approval and supply require network gas?

When approval is required, it and the supply are separate onchain transactions, so each consumes network gas. The wallet must hold the selected network's native fee asset to pay those fees. Review the wallet's confirmation screen because a successful approval doesn't cover the separate supply action or guarantee that its fee requirements are met.

Must mTokens be redeemed rather than transferred?

No, mTokens follow the ERC-20 interface and can support transfers, but transferring them isn't the same as withdrawing the underlying asset. The recipient receives the tokenized position rather than the redeemed asset. A transfer may be restricted when the position is being used as collateral or when transfers are paused. Redemption also remains subject to available market liquidity and the account's collateral conditions.

Updated ยท