Skip to main content
A deposit funds an account inside your app. A withdrawal sends funds back out. On Mayan both are a single cross-chain transfer with the conversion built in. On the way in, a user funds from any supported token on any supported chain, and your app receives the asset it settles in. On the way out, they choose the chain and the token they receive, and it goes straight to their wallet. Neither direction asks the user to acquire your settlement asset or move to your chain first.

How it works

Pass your app’s address as destinationAddress and the asset your app accepts as toToken. Whatever the user holds is converted in transit and arrives as one transfer.
Withdrawals invert it: your app is the source, and the user supplies the destination chain and token.

Two ways to take deposits

  • Per-transfer. The standard flow above. The user requests a quote and signs once for each deposit.
  • Permanent address. For users who fund repeatedly, Mayan can issue an address that does not expire. They send to it like an ordinary transfer, with no wallet connection, signature or approval. Set mpsDeposit: true alongside your destinationAddress on the quote request, and the response returns an mpsDepositAddress. See deposit addresses.

Where it fits

  • A DEX lets users fund from the asset they already hold rather than the one it settles in.
  • An exchange with internal balances removes the conversion step users otherwise do by hand.
  • An onramp or checkout accepts whatever the user brings and settles in one asset.
  • A vault accepts deposits in assets it does not otherwise support.
  • A product that pays users out lets them receive in the asset and on the chain they choose.

Case studies

  • Hyperliquid takes deposits and withdrawals in one move, from any chain and any asset, with Mayan. See HyperCore deposit & withdraw for the integration.
  • Predikt funds prediction market trades from any chain instantly with Mayan.
  • Manic Trade unlocked deposits from any chain with Mayan.

Next steps

Deposit Addresses

A permanent address for users who fund repeatedly.

HyperCore Deposit & Withdraw

The worked integration behind the Hyperliquid case study.

Quickstart

Quote, sign and execute a first transfer.