Skip to content

Latest commit

 

History

History
197 lines (173 loc) · 4.37 KB

swap.md

File metadata and controls

197 lines (173 loc) · 4.37 KB
description
Integrate Swap seamlessly into your dApp

Swap

How to use

  1. If from token is ERC20 token, need to check if user has approved enough amount for the swap contract to use by calling particle_swap_checkApprove
  2. (Optional) Sign, send and wait for the approve tx confirmed
  3. Get quote by calling particle_swap_getQuote
  4. Get swap by calling particle_swap_getSwap
  5. Sign, send and wait for the swap tx confirmed

📢 For Native token like ETH, use this address
0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee

Supported Chains

  1. Ethereum Mainnet
  2. BNB Chain Mainnet
  3. Polygon Mainnet
  4. Optimism Mainnet
  5. Arbitrum One
  6. Avalanche C-Chain Mainnet
  7. Fantom Mainnet
  8. Aurora Mainnet
  9. Gnosis Mainnet
  10. Klaytn Mainet
  11. zkSync Era Mainnet
  12. Mantle Mainnet
  13. OKTC Mainnet
  14. Moonriver Mainnet
  15. Moonbeam Mainnet
  16. Celo Mainnet
  17. Cronos Mainnet

Underlying DEXs

  1. 1inch: https://1inch.io/
  2. izi-swap: https://izumi.finance/
  3. lifi: https://li.fi/

particle_swap_checkApprove

Request

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "particle_swap_checkApprove",
  "params": [
    "0x369aa8a7a7BE683E1a46d9A056806B2B3FD778C8", // wallet address
    {
      "tokenAddress": "0x111111111117dc0aa78b770fa6a738034120c302", // from token address
      "amount": "1000000000"
    }
  ]
}

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": {
    "approved": true
  },
  "chainId": 1
}
{
  "jsonrpc": "2.0",
  "id": 0,
  "result": {
    "approved": false,
    "tx": { // Construct a complete transaction on the client side.
      "to": "0x111111111117dC0aa78b770fA6A738034120C302",
      "data": "0x095ea7b30000000000000000000000001111111254fb6c44bac0bed2854e76f90643097d000000000000000000000000000000000000000000000000000000003b9aca00",
      "value": "0x0",
    }
  },
  "chainId": 1
}

particle_swap_getQuote

Request

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "particle_swap_getQuote",
  "params": [
    "0x369aa8a7a7BE683E1a46d9A056806B2B3FD778C8", // wallet address
    {
      "fromTokenAddress": "0x111111111117dc0aa78b770fa6a738034120c302",
      "toTokenAddress": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
      "amount": "1000000000"
    }
  ]
}

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": {
    "fromToken": {
      "chainId": 1,
      "address": "0x111111111117dC0aa78b770fA6A738034120C302",
      "symbol": "1INCH",
      "name": "1INCHToken",
      "decimals": 18,
      "logoURI": "https://static.particle.network/token-list/ethereum/0x111111111117dC0aa78b770fA6A738034120C302.png"
    },
    "toToken": {
      "chainId": 1,
      "address": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
      "symbol": "DAI",
      "name": "DaiStablecoin",
      "decimals": 18,
      "logoURI": "https://static.particle.network/token-list/ethereum/0x6B175474E89094C44Da98b954EedeAC495271d0F.png"
    },
    "toTokenAmount": "781970036",
    "fromTokenAmount": "1000000000",
    "estimatedGas": "0x4079f"
  },
  "chainId": 1
}

particle_swap_getSwap

Request

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "particle_swap_getSwap",
  "params": [
    "0x369aa8a7a7BE683E1a46d9A056806B2B3FD778C8",
    {
      "fromTokenAddress": "0x111111111117dc0aa78b770fa6a738034120c302",
      "toTokenAddress": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
      "amount": "1000000000",
      "slippage": 1
    }
  ]
}

Response

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": {
    "fromToken": {
      "chainId": 1,
      "address": "0x111111111117dC0aa78b770fA6A738034120C302",
      "symbol": "1INCH",
      "name": "1INCHToken",
      "decimals": 18,
      "logoURI": "https://static.particle.network/token-list/ethereum/0x111111111117dC0aa78b770fA6A738034120C302.png"
    },
    "toToken": {
      "chainId": 1,
      "address": "0x6B175474E89094C44Da98b954EedeAC495271d0F",
      "symbol": "DAI",
      "name": "DaiStablecoin",
      "decimals": 18,
      "logoURI": "https://static.particle.network/token-list/ethereum/0x6B175474E89094C44Da98b954EedeAC495271d0F.png"
    },
    "toTokenAmount": "781970036",
    "fromTokenAmount": "1000000000",
    "tx": { // Construct a complete transaction on the client side.
      "to": "0x1111111254fb6c44bAC0beD2854e76F90643097d",
      "data": "0x000",
      "value": "0x0",
    }
  },
  "chainId": 1
}