DropSwap User Manual

👋 Introduction

DropSwap is a multi-chain decentralized exchange (DEX) aggregator that lets you swap tokens across 26+ blockchains from a single interface - without manually switching apps or researching routes.

Instead of building isolated liquidity, DropSwap queries dozens of DEX aggregators and bridges simultaneously to find you the best rate available.

🦊 Connecting a Wallet

DropSwap works with any EVM-compatible wallet (MetaMask, Rabby, Coinbase Wallet) and Phantom/Solflare for Solana swaps.

1. Click "Connect Wallet" in the top-right corner of the app.
2. Select your wallet from the list (MetaMask, WalletConnect, Coinbase Wallet, etc.).
3. Approve the connection request in your wallet extension.
4. Your wallet address and balance will appear in the header.

Adding a new chain to MetaMask

If MetaMask doesn't have the target chain configured, DropSwap will prompt you to add it automatically. Click "Add chain" in the MetaMask popup and confirm - the RPC and explorer details are pre-filled for you.

⛓️ Supported Chains

DropSwap currently supports swaps on 26+ chains. The DROP token is deployed natively on 6 of these:

Arbitrum One

Base

BNB Chain

Robinhood Chain

Monad

Avalanche

All other chains (Ethereum, Polygon, Optimism, Solana, Sei, Berachain, HyperEVM, Linea, Scroll, Blast, Soneium, and more) are supported for swapping only via the aggregation layer.

🔄 How to Swap

1. Select the source chain from the chain dropdown at the top of the swap panel.
2. Click the input token (YOU PAY) and search by name, symbol, or paste a contract address.
3. Click the output token (YOU RECEIVE) and select the token you want.
4. Enter the amount you want to swap. A live quote will appear automatically.
5. Review the rate, price impact, and minimum received shown below the swap button.
6. Click Swap and confirm the transaction in your wallet.

Basic vs. Advanced mode

Toggle between Basic (simplified view) and Advanced (shows market price, price impact, route details) using the mode switch above the swap panel.

Using MAX

Click MAX next to your balance to fill the full amount. For native gas tokens (ETH, AVAX, etc.), a small reserve is kept automatically to cover the transaction gas fee.

💸 Fees & Slippage

Slippage

Slippage is the difference between the quoted price and the actual execution price. DropSwap sets default slippage automatically. Adjust it in swap settings (⚙️). For volatile tokens or low-liquidity pairs, increase to 1–2%.

🛡️ Token Security

Every token in DropSwap's swap list is filtered through GoPlus Security scanning. Spam tokens and honeypot contracts are automatically excluded.

What GoPlus checks

• Honeypot detection (token that can be bought but not sold)
• Suspicious or non-renounced ownership
• Mint function present (unlimited supply risk)
• Trading cooldowns or abnormal tax rates
• Proxy contracts with hidden upgrade risk

What is DROP?

DROP is the native utility token of the DropSwap ecosystem. It is omnichain - deployed at the exact same contract address on 6 chains via LayerZero OFT (burn-and-mint).

How DROP becomes scarcer over time

Every swap on DropSwap contributes 0.25% in fees. Of that, 35% funds an automated burn - the Burn Wallet calls burn() on the DROP contract, permanently reducing total supply. Every burn is verifiable on Arbiscan.

DROP across chains

When DROP moves between chains, the sending chain burns the tokens and LayerZero instructs the receiving chain to mint the same amount. Global total never changes: always 100,000,000 minus permanently burned tokens.

🌉 Bridge DROP

Move DROP between any two supported chains without leaving DropSwap.

1. Open DROP Bridge from the main menu.
2. Select the source chain (where your DROP is).
3. Select the destination chain (where you want it).
4. Enter the amount. A real-time LayerZero relay fee is shown (paid in native gas).
5. Click Bridge and confirm two transactions: approve + send.
6. Bridge completes in 20–60 seconds. Track at layerzeroscan.com.

🛒 Buy DROP - Direct Sale

Buy DROP directly from the DropSwap Treasury at a transparent, market-referenced price - with zero price impact and zero slippage.

How the price is set

The contract uses a 30-minute TWAP from the Arbitrum liquidity pool. If the market price falls below the floor (~$0.01), the floor is used instead.

1. Open Direct Sale from the main menu.
2. Connect your wallet on Arbitrum.
3. Enter the ETH amount. The DROP you'll receive is shown in real time.
4. Click Buy DROP and confirm in your wallet.

🔥 Burn Mechanism

Every qualifying swap contributes to an automated DROP burn funded by 35% of the 0.25% integrator fee.

1. A swap is made - DropSwap collects 0.25% fee in the "from" token.
2. Platform calculates a DROP-equivalent burn amount based on fee USD value and current DROP price.
3. When accumulated burns exceed the threshold, the Burn Wallet calls burn(amount) on the DROP contract.
4. Tokens are permanently destroyed - totalSupply decreases on all block explorers.

🎁 Swap Rewards

Active swappers earn DROP tokens automatically for qualifying trades (minimum $1 USD value) on any supported chain.

1. Open Swap Rewards from the main menu.
2. Connect your wallet. Pending DROP balance is shown.
3. Click Claim when you have at least 1 DROP pending.
4. DROP is sent to your wallet on Arbitrum from the Campaign Wallet.

📈 Staking

Stake DROP to earn a share of the daily DROP reward pool. Fixed emissions - a set amount of DROP distributed per day, proportional to your share of the pool.

1. Open Staking from the main menu.
2. Select chain (Arbitrum, Robinhood, or BNB).
3. Enter the amount of DROP to stake (minimum 100 DROP).
4. Approve DROP spend and confirm the stake transaction.
5. Pending rewards accumulate in real time as a live counter.

Claim, Compound & Unstake

• Claim: min 1 DROP pending - sends rewards to your wallet.
• Compound: min 100 DROP pending - re-stakes rewards in one transaction.
• Unstake: no lock period - withdraw at any time.
• Emergency withdraw: forfeits pending rewards, always returns staked principal.

🪂 Airdrop

DropSwap periodically distributes DROP to community members and early supporters via airdrop waves.

1. Open Airdrop from the main menu.
2. Connect your wallet and select the chain to receive DROP on.
3. Enter your Twitter/X handle and Tweet URL (required).
4. Click Register. One registration per address per chain.

🏦 What is DropSwap V2 DEX?

DropSwap V2 DEX is a native permissionless exchange (constant-product AMM, x·y=k). Fully owned, on-chain protocol separate from the aggregator layer.

➕ Create a Pool

Create a liquidity pool for any ERC-20 token pair - no approval needed.

1. Open Create Pool from the menu.
2. Select the chain (Arbitrum or Robinhood Chain).
3. Select Token 1 - search by name or paste a contract address.
4. Select Token 2 - same process.
5. Enter amounts. The ratio you set becomes the initial price.
6. Click Check ratio to compare against market price. A warning appears if ratio differs by more than 5%.
7. Click Create Pool and confirm the transactions.

🔭 Explore Pools

Browse all active liquidity pools on DropSwap V2 DEX across all chains - with real-time TVL, APY, and reserves.

• Browse pools sorted by TVL or APY.
• Search by token name, symbol, or contract address.
• Add liquidity to any pool directly from the list.
• Swap within a specific pool.
• View on DexScreener for price charts and trade history.

📊 My Pool Positions

See all pools where you hold DS-V2 LP tokens - across all chains, in one place.

• Your share: exact token amounts + percentage of pool
• USD value of your position
• APY based on 24h trading volume
• Toggle Card view / List view - preference saved automatically

Round-trip test (RT)

The RT button runs an automated round-trip swap - swaps 5% of the pool A→B then immediately B→A. Pool ratio is restored, only the 0.6% fee stays (your LP earnings). Use this to verify the pool works correctly without risking imbalance.

Listed / Unlisted

Each pool has a Listed badge that controls whether it is visible to all users in Explore Pools.

• Listed - pool is publicly visible in Explore Pools. Anyone can discover it, add liquidity and trade.
• Unlisted - pool is hidden from Explore Pools. It remains fully functional on-chain - you can still add/remove liquidity and swap from Pool Positions. Use this while the pool is not ready for public discovery.

Click the Listed badge in Pool Positions to toggle. The change takes effect immediately and is secured by a wallet signature.

💧 Add / Remove Liquidity

Adding liquidity

1. Find the pool in Explore Pools or Pool Positions and click +.
2. Enter amount for Token A - Token B fills automatically based on current ratio.
3. Click Max to use full balance (gas reserve kept for native tokens).
4. Click Add Liquidity and confirm (approve + addLiquidity).
5. You receive DS-V2 LP tokens proportional to your contribution.

Removing liquidity

1. Open Pool Positions and click − on your pool.
2. Select percentage to remove (25%, 50%, 75%, 100%) or enter custom amount.
3. Click Remove Liquidity and confirm (approve LP token + removeLiquidity).
4. Your tokens are returned to your wallet immediately.

Gas reserve for native token

When adding liquidity to an ETH pool (or any native token pool), DropSwap keeps a 0.002 ETH gas reserve when you click Max. This ensures you always have enough native token to pay for the transaction gas fee.

• Balance display - always shows your full wallet balance
• Max button - sets your balance minus 0.002 ETH gas reserve
• If your balance is below 0.002 ETH - Max clears the input. You need more native token to cover gas.
• Non-ETH tokens (DROP, USDC etc.) - no gas reserve is deducted

📋 Contract Addresses

DROP Token (all chains)

DropSwap V2 DEX

🔌 DEX Integration API

DropSwap V2 exposes a public quote endpoint for DEX aggregators and other third-party integrations on Arbitrum One and Robinhood Chain.

API endpoint: https://dropswap.finance/lifi-dex/quote

Supported chains

Request parameters

Example request

GET /lifi-dex/quote
?chain=robinhood
&tokenIn=0x9C0E3165B44AA9b5D3569a8F31ce754FCb98F2b8
&tokenOut=0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73
&amountIn=1000000000000000000
&recipient=0xEcC74EDf0f1B02019567b1dCBDa7c52bcFB2022C
&slippageBps=50

Response

{
  "chain": "robinhood",
  "chainId": 4663,
  "router": "0x50A79E4f576D873ad1b637b2Ec073b6F09D5d893",
  "tokenIn": "0x...",
  "tokenOut": "0x...",
  "amountIn": "1000000000000000000",
  "amountOut": "...",
  "amountOutMin": "...",
  "slippageBps": 50,
  "transactionRequest": {
    "to": "0x...",
    "data": "0x...",
    "value": "0",
    "from": "0x..."
  },
  "gasEstimate": "180000"
}

gasEstimate currently contains a conservative fallback gas limit for transaction construction. Integrators may perform their own gas estimation before submitting the transaction.

Execution

The endpoint returns calldata for the DropSwap V2 swapExactTokensForTokens router function. Quotes are calculated directly from the active DropSwap V2 liquidity pools.

DropSwap V2 uses standard Uniswap V2 constant-product pricing with a total swap fee of 0.30%.

DEX contracts

Factory: 0xDCed5445409398dc609C2f87849B44bc9479664A

Pair init code hash: 0x5a06c73619cafbdf06047031713728e845441be833a0050893b05ad35d3bc10d

Public token list: https://dropswap.finance/tokenlist.json

🧩 Launchpad Liquidity Gateway

DropSwap Launchpad Liquidity Gateway is a non-custodial liquidity handoff layer for token launchpads. Your launchpad keeps its launch flow and wallet. DropSwap handles liquidity preflight, transaction preparation, execution routing and the verifiable Liquidity Receipt.

The recommended integration does not require the launchpad to understand DropSwap Factory/Router internals or manually construct Gateway calldata.

Supported Gateway deployments

🪙 Supported Quote Tokens

Launchpad Gateway quote tokens are chain-specific. These are not the only tokens that can be used with the Gateway. A launchpad can provide liquidity for a newly created, minted, or launched ERC-20 token. The quote tokens listed below are the supported assets that can be paired with that token when creating or seeding its DropSwap liquidity pool.

⚡ Gateway Quick Start

Set the Gateway API base URL supplied for your integration:

export GATEWAY_API="https://dropswap.finance/launchpad-api"

Partner access

Register your launchpad from the Launchpads Gateway panel in the DropSwap app. Connect the launchpad owner wallet, sign the registration challenge and submit the project for approval.

After approval, the same wallet can retrieve its reusable Partner ID and API key. Keep the API key on your server. Do not expose it in browser code.

Register / Manage Launchpad Access

export DROPSWAP_PARTNER_ID="lp_YOUR_PARTNER_ID"
export DROPSWAP_API_KEY="ds_lp_YOUR_API_KEY"

1. Discover chains

curl "$GATEWAY_API/v1/chains"

2. Discover approved quote tokens

curl "$GATEWAY_API/v1/quote-tokens?chain=arbitrum"

3. Preview liquidity

curl -X POST "$GATEWAY_API/v1/preview" \
  -H "Content-Type: application/json" \
  -d '{
    "chain": "arbitrum",
    "token": "TOKEN_ADDRESS",
    "quoteToken": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "tokenAmount": "TOKEN_AMOUNT_BASE_UNITS",
    "quoteAmount": "USDC_AMOUNT_BASE_UNITS"
  }'

Inspect ready, riskLevel, blockingIssues, warnings, pool, priceAnalysis and contractChecks.

4. Generate a unique integrationId

const integrationId = ethers.keccak256(
  ethers.toUtf8Bytes(
    `my-launchpad:${chainId}:${token}:${Date.now()}`
  )
);

The integrationId is generated by your launchpad. It must be a unique non-zero bytes32 and is passed to DropSwap unchanged. Gateway V2 uses it together with the launchpad wallet for replay protection. Never reuse an integration ID after successful execution.

5. Prepare the transaction plan

curl -X POST "$GATEWAY_API/v1/prepare" \
  -H "Content-Type: application/json" \
  -H "X-DropSwap-Partner: $DROPSWAP_PARTNER_ID" \
  -H "X-DropSwap-API-Key: $DROPSWAP_API_KEY" \
  -d '{
    "chain": "arbitrum",
    "launchpad": "LAUNCHPAD_WALLET_ADDRESS",
    "token": "TOKEN_ADDRESS",
    "quoteToken": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "tokenAmount": "TOKEN_AMOUNT_BASE_UNITS",
    "quoteAmount": "USDC_AMOUNT_BASE_UNITS",
    "integrationId": "0xYOUR_BYTES32_INTEGRATION_ID",
    "slippageBps": 100,
    "deadlineSeconds": 1200
  }'

Default slippage is 100 bps (1%). Default deadline is 1200 seconds. Maximum deadline is 86400 seconds.

6. Sign returned transactions

for (const txRequest of prepared.transactions) {
  const tx = await signer.sendTransaction({
    to: txRequest.to,
    data: txRequest.data,
    value: txRequest.value
  });

  await tx.wait();
}

Execute the returned transactions array exactly in order. The launchpad signs every transaction with its own wallet.

7. Read execution status

export LAUNCHPAD_WALLET="LAUNCHPAD_WALLET_ADDRESS"

curl "$GATEWAY_API/v1/status/$INTEGRATION_ID?chain=arbitrum&launchpad=$LAUNCHPAD_WALLET"

LAUNCHPAD_WALLET is the same wallet address supplied as launchpad to /v1/prepare.

🔌 Gateway API & Execution Modes

Public API

ERC20 / ERC20

ERC20 / native ETH

The second transaction carries the native quote amount in value.

Prepare safety checks

Before returning executable calldata, /v1/prepare verifies:

• the preflight result is not blocked,
• the Gateway is deployed,
• paused() == false,
• the integration ID is valid and non-zero,
• for Gateway V2 deployments, executedFor(launchpad, integrationId) == false,
• the launchpad address is valid,
• the selected quote token is approved by the Gateway.

💻 Copy / Paste Integration Example

This is a reusable backend integration example. Connect DropSwap once, then supply the launch-specific values dynamically for every new token created by your launchpad.

import { ethers } from "ethers";

const GATEWAY_API =
  "https://dropswap.finance/launchpad-api";

const DROPSWAP_PARTNER_ID =
  process.env.DROPSWAP_PARTNER_ID;

const DROPSWAP_API_KEY =
  process.env.DROPSWAP_API_KEY;

// ------------------------------------------------------------
// These values change for every launch
// ------------------------------------------------------------

const chain = launch.chain;

// Address returned after your launchpad deploys / creates the token
const token = newToken.address;

// Select from:
// GET /v1/quote-tokens?chain=<chain>
const quoteToken =
  selectedQuoteToken.address;

// Base units
const tokenAmount =
  liquidity.tokenAmount;

const quoteAmount =
  liquidity.quoteAmount;

// Launchpad wallet executing the Gateway transaction
const launchpad =
  launch.wallet;

// Unique ID for this launch
const integrationId =
  ethers.keccak256(
    ethers.toUtf8Bytes(
      `${chain}:${token}:${launchpad}:${Date.now()}`
    )
  );

const body = {
  chain,
  token,
  quoteToken,
  tokenAmount,
  quoteAmount,
  launchpad,
  integrationId,
  slippageBps: 100,
  deadlineSeconds: 1200
};

// ------------------------------------------------------------
// 1. Public preflight
// ------------------------------------------------------------

const previewResponse =
  await fetch(
    `${GATEWAY_API}/v1/preview`,
    {
      method: "POST",
      headers: {
        "Content-Type": "application/json"
      },
      body: JSON.stringify(body)
    }
  );

const preview =
  await previewResponse.json();

if (!previewResponse.ok || !preview.ready) {
  throw new Error(
    `DropSwap preflight blocked: ${
      JSON.stringify(
        preview.blockingIssues ||
        preview.error ||
        preview
      )
    }`
  );
}

// ------------------------------------------------------------
// 2. Authenticated prepare
// ------------------------------------------------------------

const prepareResponse =
  await fetch(
    `${GATEWAY_API}/v1/prepare`,
    {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "X-DropSwap-Partner":
          DROPSWAP_PARTNER_ID,
        "X-DropSwap-API-Key":
          DROPSWAP_API_KEY
      },
      body: JSON.stringify(body)
    }
  );

const prepared =
  await prepareResponse.json();

if (!prepareResponse.ok || !prepared.ready) {
  throw new Error(
    prepared.error ||
    "DropSwap prepare failed"
  );
}

// ------------------------------------------------------------
// 3. Execute returned transactions
// ------------------------------------------------------------

for (const txRequest of prepared.transactions) {
  const tx =
    await signer.sendTransaction({
      to: txRequest.to,
      data: txRequest.data,
      value: txRequest.value
    });

  await tx.wait();
}

// ------------------------------------------------------------
// 4. Read execution status
// ------------------------------------------------------------

const statusUrl =
  `${GATEWAY_API}/v1/status/${integrationId}` +
  `?chain=${encodeURIComponent(chain)}` +
  `&launchpad=${encodeURIComponent(launchpad)}`;

const result =
  await fetch(
    statusUrl
  ).then(r => r.json());

console.log(result);

Use the same integration for every new token

// Launch #1
token = TOKEN_A
quoteToken = USDC

// Launch #2
token = TOKEN_B
quoteToken = WETH

// Launch #3
token = TOKEN_C
quoteToken = WBTC

// Same DropSwap integration.
// Only the launch-specific values change.

Your launchpad does not need a separate DropSwap integration for each token or pair. The same backend flow can be reused for every launch.

🛡️ Security & Liquidity Receipt

Non-custodial execution

The launchpad retains control of its funds and signing keys. The Gateway receives assets only for the atomic liquidity operation and is designed not to retain execution funds after completion.

Replay protection

Gateway V2 scopes replay protection by launchpad wallet. Every successful execution marks the supplied integrationId as executed for that launchpad. This applies to both Arbitrum and Robinhood V2 deployments. The same launchpad cannot reuse an executed ID.

Permanent LP custody on Gateway V2

The Locker records the pair, launchpad, launch token, quote token, LP amount, integration ID and creation timestamp. The Locker is permanent and exposes no LP withdrawal or release function.

Why permanent locking? Permanent LP locking is a built-in launch quality signal your launchpad gets for free. When buyers see that liquidity is locked on-chain and cannot be withdrawn, it removes one of the biggest barriers to participation in new token launches. The Liquidity Receipt makes this verifiable - your launchpad can display it publicly as proof that the pool will stay liquid. Launchpads that offer this guarantee consistently see stronger community trust and higher participation rates at launch.

Status

curl "$GATEWAY_API/v1/status/$INTEGRATION_ID?chain=arbitrum&launchpad=$LAUNCHPAD_WALLET"

Normal V2 states:

Liquidity Receipt

A resolved receipt contains the verifiable execution result, including:

• launchpad address,
• launch token and quote token,
• DropSwap pair address,
• actual token and quote amounts,
• LP liquidity minted,
• permanent Locker recipient,
• whether the pool was newly created,
• transaction hash and block number.

✅ Live Verification Status

The public Launchpad Gateway Quickstart has been executed on-chain across all currently supported execution modes.

📥 Developer Downloads

Download the current Markdown documentation for your repository, IDE or internal integration notes.

Integration principle

❓ FAQ

Is DropSwap non-custodial?

Yes. DropSwap never takes custody of your funds. All swaps and liquidity operations execute directly from your wallet through smart contracts.

Which wallet should I use?

Any EVM wallet: MetaMask, Rabby, Coinbase Wallet, Trust Wallet, or WalletConnect-compatible. For Solana swaps, use Phantom or Solflare.

Why did my swap fail?

Common reasons: (1) Insufficient gas - increase gas limit. (2) Slippage too low - increase tolerance. (3) Token approval needed - approve first. (4) Route unavailable - try smaller amount or different token.

How do I add a token not in the list?

Click the token selector, paste the full contract address in the search box. DropSwap imports token details from on-chain. Always verify the contract address from the official project source.

What is the minimum to earn swap rewards?

Your swap must be worth at least $1 USD. Your wallet must also meet minimum age and transaction count requirements.

Can I create a pool for any two tokens?

Yes - DropSwap V2 DEX is fully permissionless. Any ERC-20 token pair on Arbitrum or Robinhood Chain. No listing fees, no approval required.

What is impermanent loss?

When you provide liquidity, prices change and the pool automatically rebalances. You may end up with more of the token that decreased in price. The difference vs. simply holding is called impermanent loss - it reverses if prices return to the original ratio.

How do I bridge DROP to another chain?

Use the built-in DROP Bridge. Select source and destination chain, enter amount, confirm. Completes in 20–60 seconds via LayerZero OFT burn-and-mint.

Is the team vesting verifiable?

Yes. 30,000,000 DROP is locked in an immutable cliff vesting contract on Arbitrum (0xB095af96e8f11Bda21689Bb0606546bBdBd8c512). Unlocks 2027-01-02. Verifiable on Arbiscan.

📖 Glossary