Swap

This page provides practical examples for executing token swaps using the Moromoro SDK.

Basic Swap: Native to ERC20

Swap native HYPE tokens to USDT on HyperEVM.

const { MoroBestRate } = require('@moromoro/moro-sdk')
const { ethers } = require('ethers')

async function swapHYPEtoUSDT() {
  // Setup
  const provider = new ethers.providers.JsonRpcProvider(
    'https://rpc.hyperliquid.xyz/evm'
  )
  const signer = new ethers.Wallet(process.env.PRIVATE_KEY, provider)
  const moroClient = new MoroBestRate(provider, 'hyperevm')

  // Token addresses
  const HYPE = '0x5555555555555555555555555555555555555555'
  const USDT = '0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb'

  // Swap parameters
  const amountIn = ethers.utils.parseUnits('10', 18) // 10 HYPE
  const gasPrice = ethers.BigNumber.from('5000000000') // 5 gwei

  try {
    // Get quote
    console.log('Getting best rate...')
    const quote = await moroClient.getQuote(
      HYPE,
      USDT,
      amountIn,
      gasPrice,
      { enableSplit: false }
    )

    console.log('Quote received:')
    console.log('- Amount Out:', ethers.utils.formatUnits(quote.amountOut, 6), 'USDT')
    console.log('- Type:', quote.type)

    // Calculate minimum output with 1% slippage
    const minAmountOut = ethers.BigNumber.from(quote.amountOut)
      .mul(99)
      .div(100)

    console.log('- Min Amount Out:', ethers.utils.formatUnits(minAmountOut, 6), 'USDT')

    // Execute swap
    console.log('\nExecuting swap...')
    const tx = await moroClient.swap(
      signer,
      HYPE,
      USDT,
      amountIn,
      minAmountOut,
      quote
    )

    console.log('Transaction submitted:', tx.hash)

    // Wait for confirmation
    const receipt = await tx.wait()
    console.log('✓ Swap confirmed in block', receipt.blockNumber)

  } catch (error) {
    console.error('Swap failed:', error.message)
    throw error
  }
}

swapHYPEtoUSDT()

ERC20 to ERC20 Swap

Swap USDT to another ERC20 token. Requires token approval.

const { MoroBestRate } = require('@moromoro/moro-sdk')
const { ethers } = require('ethers')

async function swapUSDTtoToken() {
  const provider = new ethers.providers.JsonRpcProvider(
    'https://rpc.hyperliquid.xyz/evm'
  )
  const signer = new ethers.Wallet(process.env.PRIVATE_KEY, provider)
  const moroClient = new MoroBestRate(provider, 'hyperevm')

  const USDT = '0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb'
  const DEST_TOKEN = '0x...' // Your destination token
  const amountIn = ethers.utils.parseUnits('100', 6) // 100 USDT
  const gasPrice = ethers.BigNumber.from('5000000000')

  try {
    // Step 1: Approve token
    console.log('Approving USDT...')
    const approveTx = await moroClient.approve(signer, USDT, amountIn)
    if (approveTx) {
      await approveTx.wait()
      console.log('✓ Token approved')
    }

    // Step 2: Get quote
    console.log('Getting quote...')
    const quote = await moroClient.getQuote(
      USDT,
      DEST_TOKEN,
      amountIn,
      gasPrice
    )

    console.log('Best rate:', ethers.utils.formatUnits(quote.amountOut, 18))

    // Step 3: Execute swap
    const minAmountOut = ethers.BigNumber.from(quote.amountOut)
      .mul(99)
      .div(100)

    const swapTx = await moroClient.swap(
      signer,
      USDT,
      DEST_TOKEN,
      amountIn,
      minAmountOut,
      quote
    )

    console.log('Swap tx:', swapTx.hash)
    await swapTx.wait()
    console.log('✓ Swap complete')

  } catch (error) {
    console.error('Error:', error.message)
  }
}

swapUSDTtoToken()

ERC20 to Native Swap

Swap ERC20 tokens back to native HYPE.

const { MoroBestRate } = require('@moromoro/moro-sdk')
const { ethers } = require('ethers')

async function swapUSDTtoHYPE() {
  const provider = new ethers.providers.JsonRpcProvider(
    'https://rpc.hyperliquid.xyz/evm'
  )
  const signer = new ethers.Wallet(process.env.PRIVATE_KEY, provider)
  const moroClient = new MoroBestRate(provider, 'hyperevm')

  const USDT = '0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb'
  const HYPE = '0x5555555555555555555555555555555555555555'
  const amountIn = ethers.utils.parseUnits('50', 6) // 50 USDT
  const gasPrice = ethers.BigNumber.from('5000000000')

  // Approve USDT
  const approveTx = await moroClient.approve(signer, USDT, amountIn)
  if (approveTx) await approveTx.wait()

  // Get quote
  const quote = await moroClient.getQuote(USDT, HYPE, amountIn, gasPrice)

  console.log('Will receive:', ethers.utils.formatEther(quote.amountOut), 'HYPE')

  // Swap
  const minOut = ethers.BigNumber.from(quote.amountOut).mul(98).div(100) // 2% slippage
  const tx = await moroClient.swap(signer, USDT, HYPE, amountIn, minOut, quote)

  await tx.wait()
  console.log('✓ Swapped to HYPE')
}

swapUSDTtoHYPE()

Swap with Custom Receiver

Send output tokens to a different address.

async function swapToCustomReceiver() {
  const provider = new ethers.providers.JsonRpcProvider(
    'https://rpc.hyperliquid.xyz/evm'
  )
  const signer = new ethers.Wallet(process.env.PRIVATE_KEY, provider)
  const moroClient = new MoroBestRate(provider, 'hyperevm')

  const HYPE = '0x5555555555555555555555555555555555555555'
  const USDT = '0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb'
  const amountIn = ethers.utils.parseUnits('5', 18)
  const gasPrice = ethers.BigNumber.from('5000000000')

  // Address to receive output tokens
  const receiverAddress = '0x1234567890123456789012345678901234567890'

  const quote = await moroClient.getQuote(HYPE, USDT, amountIn, gasPrice)
  const minOut = ethers.BigNumber.from(quote.amountOut).mul(99).div(100)

  const tx = await moroClient.swap(
    signer,
    HYPE,
    USDT,
    amountIn,
    minOut,
    quote,
    0,                  // partnerId
    0,                  // metaData
    receiverAddress     // custom receiver
  )

  await tx.wait()
  console.log(`✓ Tokens sent to ${receiverAddress}`)
}

swapToCustomReceiver()

Swap with Gas Limit Override

Set a custom gas limit for the transaction.

async function swapWithCustomGas() {
  const provider = new ethers.providers.JsonRpcProvider(
    'https://rpc.hyperliquid.xyz/evm'
  )
  const signer = new ethers.Wallet(process.env.PRIVATE_KEY, provider)
  const moroClient = new MoroBestRate(provider, 'hyperevm')

  const HYPE = '0x5555555555555555555555555555555555555555'
  const USDT = '0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb'
  const amountIn = ethers.utils.parseUnits('10', 18)
  const gasPrice = ethers.BigNumber.from('5000000000')

  const quote = await moroClient.getQuote(HYPE, USDT, amountIn, gasPrice)
  const minOut = ethers.BigNumber.from(quote.amountOut).mul(99).div(100)

  const tx = await moroClient.swap(
    signer,
    HYPE,
    USDT,
    amountIn,
    minOut,
    quote,
    0,
    0,
    ethers.constants.AddressZero,
    {
      gasLimit: 500000,           // Custom gas limit
      gasPrice: gasPrice          // Can also override gas price
    }
  )

  await tx.wait()
  console.log('✓ Swap completed with custom gas settings')
}

swapWithCustomGas()

Checking Balance Before Swap

Always verify sufficient balance before executing a swap.

const { MoroBestRate } = require('@moromoro/moro-sdk')
const { ethers } = require('ethers')

async function swapWithBalanceCheck() {
  const provider = new ethers.providers.JsonRpcProvider(
    'https://rpc.hyperliquid.xyz/evm'
  )
  const signer = new ethers.Wallet(process.env.PRIVATE_KEY, provider)
  const moroClient = new MoroBestRate(provider, 'hyperevm')

  const HYPE = '0x5555555555555555555555555555555555555555'
  const USDT = '0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb'
  const amountIn = ethers.utils.parseUnits('10', 18)
  const gasPrice = ethers.BigNumber.from('5000000000')

  // Check balance
  const balance = await signer.getBalance()
  console.log('Current balance:', ethers.utils.formatEther(balance), 'HYPE')

  // Estimate gas cost
  const estimatedGas = ethers.BigNumber.from('200000') // Conservative estimate
  const gasCost = estimatedGas.mul(gasPrice)

  const totalNeeded = amountIn.add(gasCost)

  if (balance.lt(totalNeeded)) {
    throw new Error(
      `Insufficient balance. Need ${ethers.utils.formatEther(totalNeeded)} HYPE, ` +
      `but have ${ethers.utils.formatEther(balance)} HYPE`
    )
  }

  // Proceed with swap
  const quote = await moroClient.getQuote(HYPE, USDT, amountIn, gasPrice)
  const minOut = ethers.BigNumber.from(quote.amountOut).mul(99).div(100)

  const tx = await moroClient.swap(signer, HYPE, USDT, amountIn, minOut, quote)
  await tx.wait()

  // Check new balance
  const newBalance = await signer.getBalance()
  console.log('New balance:', ethers.utils.formatEther(newBalance), 'HYPE')
}

swapWithBalanceCheck()

Error Handling

Comprehensive error handling for swaps.

async function swapWithErrorHandling() {
  const provider = new ethers.providers.JsonRpcProvider(
    'https://rpc.hyperliquid.xyz/evm'
  )
  const signer = new ethers.Wallet(process.env.PRIVATE_KEY, provider)
  const moroClient = new MoroBestRate(provider, 'hyperevm')

  const HYPE = '0x5555555555555555555555555555555555555555'
  const USDT = '0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb'
  const amountIn = ethers.utils.parseUnits('10', 18)
  const gasPrice = ethers.BigNumber.from('5000000000')

  try {
    // Get quote
    const quote = await moroClient.getQuote(HYPE, USDT, amountIn, gasPrice)
    const minOut = ethers.BigNumber.from(quote.amountOut).mul(99).div(100)

    // Execute swap
    const tx = await moroClient.swap(signer, HYPE, USDT, amountIn, minOut, quote)
    console.log('Transaction submitted:', tx.hash)

    const receipt = await tx.wait()
    console.log('✓ Success! Block:', receipt.blockNumber)

    return receipt

  } catch (error) {
    // Handle specific error types
    if (error.code === 'INSUFFICIENT_FUNDS') {
      console.error('❌ Insufficient balance for transaction')
    } else if (error.code === 'UNPREDICTABLE_GAS_LIMIT') {
      console.error('❌ Transaction would fail, possibly due to slippage')
    } else if (error.message.includes('slippage')) {
      console.error('❌ Slippage exceeded, try increasing tolerance')
    } else if (error.message.includes('allowance')) {
      console.error('❌ Token not approved, run approve() first')
    } else if (error.code === 'NETWORK_ERROR') {
      console.error('❌ Network error, check RPC connection')
    } else {
      console.error('❌ Swap failed:', error.message)
    }

    throw error
  }
}

swapWithErrorHandling()

Complete Example with All Checks

Production-ready swap example with all safety checks.

const { MoroBestRate } = require('@moromoro/moro-sdk')
const { ethers } = require('ethers')

async function productionSwap(
  srcToken,
  destToken,
  amountIn,
  slippagePercent = 1
) {
  // Setup
  const provider = new ethers.providers.JsonRpcProvider(
    'https://rpc.hyperliquid.xyz/evm'
  )
  const signer = new ethers.Wallet(process.env.PRIVATE_KEY, provider)
  const moroClient = new MoroBestRate(provider, 'hyperevm')
  const gasPrice = ethers.BigNumber.from('5000000000')

  try {
    // 1. Validate inputs
    if (!ethers.utils.isAddress(srcToken)) {
      throw new Error('Invalid source token address')
    }
    if (!ethers.utils.isAddress(destToken)) {
      throw new Error('Invalid destination token address')
    }
    if (amountIn.lte(0)) {
      throw new Error('Amount must be greater than 0')
    }

    // 2. Check balance
    const isNative = srcToken === '0x5555555555555555555555555555555555555555'
    let balance

    if (isNative) {
      balance = await signer.getBalance()
    } else {
      const token = new ethers.Contract(
        srcToken,
        ['function balanceOf(address) view returns (uint256)'],
        provider
      )
      balance = await token.balanceOf(signer.address)
    }

    if (balance.lt(amountIn)) {
      throw new Error(
        `Insufficient balance. Have ${balance.toString()}, need ${amountIn.toString()}`
      )
    }

    // 3. Approve if ERC20
    if (!isNative) {
      console.log('Approving token...')
      const approveTx = await moroClient.approve(signer, srcToken, amountIn)
      if (approveTx) {
        await approveTx.wait()
        console.log('✓ Token approved')
      }
    }

    // 4. Get quote
    console.log('Getting best rate...')
    const quote = await moroClient.getQuote(
      srcToken,
      destToken,
      amountIn,
      gasPrice,
      { enableSplit: true }
    )

    console.log('Quote:')
    console.log('- Amount Out:', quote.amountOut)
    console.log('- Type:', quote.type)
    console.log('- Block:', quote.blockNumber)

    // 5. Calculate slippage
    const minOut = ethers.BigNumber.from(quote.amountOut)
      .mul(100 - slippagePercent)
      .div(100)

    console.log(`- Min Out (${slippagePercent}% slippage):`, minOut.toString())

    // 6. Execute swap
    console.log('Executing swap...')
    const tx = await moroClient.swap(
      signer,
      srcToken,
      destToken,
      amountIn,
      minOut,
      quote
    )

    console.log('Transaction hash:', tx.hash)

    // 7. Wait for confirmation
    const receipt = await tx.wait()
    console.log('✓ Swap confirmed!')
    console.log('  Block:', receipt.blockNumber)
    console.log('  Gas used:', receipt.gasUsed.toString())

    return {
      success: true,
      txHash: tx.hash,
      blockNumber: receipt.blockNumber,
      gasUsed: receipt.gasUsed.toString()
    }

  } catch (error) {
    console.error('Swap failed:', error.message)
    return {
      success: false,
      error: error.message
    }
  }
}

// Usage
const HYPE = '0x5555555555555555555555555555555555555555'
const USDT = '0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb'
const amount = ethers.utils.parseUnits('10', 18)

productionSwap(HYPE, USDT, amount, 1)
  .then(result => console.log('Result:', result))

See Also

• Split Trading Examples

• Multi-Chain Examples

• MoroBestRate API

• Quick Start Guide