MoroRouterV1

The Moromoro Router is the main smart contract for executing swaps on supported networks.

Contract Addresses

HyperEVM

MoroRouter V1

• Address: 0x3e1c48732b2dff04e83bd7fc1cf618584693d23f

• View on HyperEVM Scan

Contract Interface

The router contract provides the following main functions:

swap()

Executes a token swap based on the quote provided by the SDK.

Function Signature:

function swap(
    address swapAddress,
    bytes calldata data,
    address depositAddress,
    address srcToken,
    uint256 amountIn,
    address destToken,
    uint256 minAmountOut,
    address receiver,
    uint256 partnerId,
    uint256 metadata
) external payable returns (uint256 amountOut)

Parameters:

• swapAddress: The DEX wrapper contract address to execute the swap

• data: Encoded swap data from the quote

• depositAddress: The deposit address for the specific DEX

• srcToken: Source token address (0x5555...5555 for native HYPE)

• amountIn: Amount of source tokens to swap

• destToken: Destination token address

• minAmountOut: Minimum acceptable output amount (for slippage protection)

• receiver: Address to receive the output tokens

• partnerId: Partner ID for profit sharing (use 0 if not applicable)

• metadata: Reserved for future use (use 0)

Returns:

• amountOut: Actual amount of destination tokens received

Usage Example

JavaScript/TypeScript

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

// Import the router ABI
const moroRouterAbi = require('./MoroRouterV1.abi.json')
const MORO_ROUTER_ADDRESS = '0x3e1c48732b2dff04e83bd7fc1cf618584693d23f'

// Setup provider and signer
const provider = new ethers.providers.JsonRpcProvider('https://rpc.hyperliquid.xyz/evm')
const signer = new ethers.Wallet(YOUR_PRIVATE_KEY, provider)

// Initialize SDK
const moroClient = new MoroBestRate(provider, 'hyperevm')

// Get quote
const src = '0x5555555555555555555555555555555555555555' // HYPE
const dest = '0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb' // USDT0
const amountIn = ethers.utils.parseUnits('10', 18)
const gasFee = ethers.BigNumber.from('5000000000')

const quote = await moroClient.getQuote(src, dest, amountIn, gasFee, { enableSplit: false })

// Add 1% slippage tolerance
const minAmountOut = ethers.BigNumber.from(quote.amountOut).mul(99).div(100)

// Create router contract instance
const moroContract = new ethers.Contract(MORO_ROUTER_ADDRESS, moroRouterAbi, signer)

// Execute swap
const swapTx = await moroContract.swap(
    quote.swapAddress,
    quote.data,
    quote.depositAddress,
    src,
    amountIn,
    dest,
    minAmountOut,
    signer.address,
    0, // Partner ID
    0  // Metadata
)

console.log(`Swap transaction: ${swapTx.hash}`)
await swapTx.wait()

Using SDK Helper Methods

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

const provider = new ethers.providers.JsonRpcProvider('https://rpc.hyperliquid.xyz/evm')
const signer = new ethers.Wallet(YOUR_PRIVATE_KEY, provider)
const moroClient = new MoroBestRate(provider, 'hyperevm')

const src = '0x5555555555555555555555555555555555555555'
const dest = '0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb'
const amountIn = ethers.utils.parseUnits('10', 18)
const gasFee = ethers.BigNumber.from('5000000000')

// Get quote
const quote = await moroClient.getQuote(src, dest, amountIn, gasFee)

// Approve token if needed (skip for native token)
if (src !== '0x5555555555555555555555555555555555555555') {
    const approveTx = await moroClient.approve(signer, src, amountIn)
    await approveTx.wait()
}

// Execute swap with SDK helper
const minAmountOut = ethers.BigNumber.from(quote.amountOut).mul(99).div(100)
const swapTx = await moroClient.swap(
    signer,
    src,
    dest,
    amountIn,
    minAmountOut,
    quote
)

console.log(`Swap completed: ${swapTx.hash}`)

Slippage Protection

Always set an appropriate minAmountOut to protect against slippage:

// 1% slippage tolerance
const minAmountOut = quote.amountOut.mul(99).div(100)

// 0.5% slippage tolerance
const minAmountOut = quote.amountOut.mul(995).div(1000)

// 2% slippage tolerance
const minAmountOut = quote.amountOut.mul(98).div(100)

Gas Considerations

HyperEVM

Default gas price on HyperEVM is typically 5 gwei:

const gasFee = ethers.BigNumber.from('5000000000') // 5 gwei

Token Addresses

Native Token

On HyperEVM, the native token (HYPE) uses a special address:

const HYPE = '0x5555555555555555555555555555555555555555'

When swapping FROM native token, send the value with the transaction:

await moroContract.swap(...params, { value: amountIn })

Events

The router contract emits events for tracking swaps. Check the contract ABI for specific event signatures.

Security

• Always verify the router contract address before interacting

• Use appropriate slippage protection

• Test with small amounts first

• Ensure you understand the gas costs involved

Getting the ABI

1

From HyperEVM Scan

Find the ABI on the contract page on HyperEVM Scan: https://hyperevmscan.io/address/0x3e1c48732b2dff04e83bd7fc1cf618584693d23f#code

2

From the contract repository

Look for the ABI in the contract repository (if available).

3

Download from the block explorer

Download the ABI directly from the block explorer.

See Also

• HyperEVM Contracts

• Quick Start Guide

• API Reference