Migrator API

API for Migration calls.

To get the token balances of an address on a specific chain.

POSThttps://migrator.aarc.xyz/migrator/balances

Header parameters

Body

application/json

addressstring

The address for which the balances are to be fetched

Example: "0x98150396C356C55a848B2baBA6aC7614615a595b"

chainIdstring

The chain id for which the balances are to be fetched

Example: "1"

onlyBalancesboolean

If true, only the balances are returned else additional information is also returned

Example: false

Response

200

Successful Response

Body

application/json

codeinteger

Example: 200

dataarray of TokenData (object)

messagestring

Example: "Success"

Request

JavaScriptCurlPython

const response = await fetch('https://migrator.aarc.xyz/migrator/balances', {
    method: 'POST',
    headers: {
      "x-api-key": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200

{
  "code": 200,
  "data": [
    {
      "decimals": 6,
      "native_token": false,
      "name": "Tether USD",
      "symbol": "USDT",
      "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "balance": "1000000000000000000",
      "type": "stablecoin",
      "nft_data": "text",
      "permit2Allowance": "0",
      "isGasless": false,
      "permitExist": false
    }
  ],
  "message": "Success"
}

Forward Transactions (pay with Stables)

Generate calldata

To generate the forward calldata for migration.

POSThttps://migrator.aarc.xyz/migrate/forward-calldata

Header parameters

Body

application/json

chainIdstring

The chain id for which the forward calldata is to be generated

Example: "137"

ownerstring

The owner of the tokens

Example: "0x98150396C356C55a848B2baBA6aC7614615a595b"

receiverAddressstring

The receiver address for the tokens

Example: "0x98150396C356C55a848B2baBA6aC7614615a595b"

tokenListarray of TokenAmountData (object)

The list of tokens to be migrated

Response

200

Successful Response

Body

application/json

codeinteger

dataForwardCallDataReponseBody_data (object)

messagestring

Request

JavaScriptCurlPython

const response = await fetch('https://migrator.aarc.xyz/migrate/forward-calldata', {
    method: 'POST',
    headers: {
      "x-api-key": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200

{
  "code": 200,
  "data": {
    "forwardCallDataResponse": [
      {
        "target": "0x000000000022D473030F116dDEE9F6B43aC78BA3",
        "tokenAddress": [
          "0xc8c53856eb36a55b92f4b005672443ecf945fbda",
          "0xc8c53856eb36a55b92f4b005672443ecf945fbda"
        ],
        "data": "{\"permitBatchTransferFrom\":{\"permitted\":[{\"token\":\"0xc8c53856eb36a55b92f4b005672443ecf945fbda\",\"amount\":\"49997809030\"},{\"token\":\"0xc8c53856eb36a55b92f4b005672443ecf945fbda\",\"amount\":\"2190970\"}],\"spender\":\"0x75ba5af8effdcfca32e1e288806d54277d1fde99\",\"deadline\":1707830776,\"nonce\":4564},\"tokenPermissions\":[{\"to\":\"0x786e6045eacb96cae0259cd761e151b68b85bda7\",\"requestedAmount\":\"49997809030\"},{\"to\":\"0xfa59d56b4bb6bdbd28883eef1b7bdf504a124f64\",\"requestedAmount\":\"2190970\"}],\"owner\":\"0x4186cac380734d5da981d702a4bfffb41bc626a6\"}",
        "txType": "PERMIT2_BATCH",
        "amount": "0",
        "message": "Permit Batch",
        "eip712Struct": {
          "domain": {
            "name": "Permit2",
            "chainId": 137,
            "verifyingContract": "0x000000000022D473030F116dDEE9F6B43aC78BA3"
          },
          "types": {
            "PermitBatchTransferFrom": [
              {
                "name": "permitted",
                "type": "TokenPermissions[]"
              },
              {
                "name": "spender",
                "type": "address"
              },
              {
                "name": "nonce",
                "type": "uint256"
              },
              {
                "name": "deadline",
                "type": "uint256"
              }
            ],
            "TokenPermissions": [
              {
                "name": "token",
                "type": "address"
              },
              {
                "name": "amount",
                "type": "uint256"
              }
            ]
          },
          "value": {
            "permitted": [
              {
                "token": "0xc8c53856eb36a55b92f4b005672443ecf945fbda",
                "amount": "49997809030"
              },
              {
                "token": "0xc8c53856eb36a55b92f4b005672443ecf945fbda",
                "amount": "2190970"
              }
            ],
            "spender": "0x75ba5af8effdcfca32e1e288806d54277d1fde99",
            "deadline": 1707830776,
            "nonce": 4564
          }
        },
        "tokenInfo": [
          {
            "tokenAddress": "0xc8c53856eb36a55b92f4b005672443ecf945fbda",
            "amount": "49997809030"
          },
          {
            "tokenAddress": "0xc8c53856eb36a55b92f4b005672443ecf945fbda",
            "amount": "2190970"
          }
        ]
      },
      {
        "target": "",
        "tokenAddress": [
          "0x0537a0f2e1373886a3d4f0e2b24c026ffa6f16f7"
        ],
        "data": "",
        "txType": "ERC20_TRANSFER",
        "amount": "0x0110d9316ec000",
        "message": "Token not supported for forward"
      }
    ],
    "txIndexes": [
      1
    ]
  },
  "message": "Success"
}

Execute calldata

After receiving the calldata from the /migrate/forward-calldata, it needs to be signed by the signer for different approvals.

To do that, you will need to get each item in the forwardCallDataReponse signed by the signer and then passed as trxList and the txnIndexes with it. Learn how to do this here.

To execute the forward calldata for migration.

POSThttps://migrator.aarc.xyz/migrate/forward-calldata-trx

Header parameters

Body

application/json

chainId*string

trxList*array of ExecuteCalldatTrxListItem (object)

txIndexes*array of integer

Response

200

Successful Response

Body

application/json

codeinteger

messagestring

dataarray of ExecuteCallDataResponseBodyDataItem (object)

Request

JavaScriptCurlPython

const response = await fetch('https://migrator.aarc.xyz/migrate/forward-calldata-trx', {
    method: 'POST',
    headers: {
      "x-api-key": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "trxList": [
        {
          "target": "0x000000000022D473030F116dDEE9F6B43aC78BA3",
          "tokenAddress": [
            "0x0000000000000000000000000000000000001010"
          ],
          "data": "{\"permitBatchTransferFrom\":{\"permitted\":[{\"token\":\"0x0537a0f2e1373886a3d4f0e2b24c026ffa6f16f7\",\"amount\":\"300000000000000\"},{\"token\":\"0xc8c53856eb36a55b92f4b005672443ecf945fbda\",\"amount\":\"50000000000\"}],\"spender\":\"0x75ba5af8effdcfca32e1e288806d54277d1fde99\",\"deadline\":1707235435,\"nonce\":4042},\"tokenPermissions\":[{\"to\":\"0x0537a0f2e1373886a3d4f0e2b24c026ffa6f16f7\",\"requestedAmount\":\"300000000000000\"},{\"to\":\"0xc8c53856eb36a55b92f4b005672443ecf945fbda\",\"requestedAmount\":\"50000000000\"}],\"owner\":\"0x4186cac380734d5da981d702a4bfffb41bc626a6\",\"signature\":\"0xca733fd70e5c2d1b221a424866dbaf791a390b0b207702906529d8cb85b40c0c64956ea593a5aa807f60df675658f03371ecf812beee997ae0bc417368679aef1c\"}",
          "txType": "PERMIT2_BATCH",
          "amount": "0",
          "message": "Permit Batch",
          "eip712Struct": {
            "domain": {
              "name": "Permit2",
              "chainId": 137,
              "verifyingContract": "0x000000000022D473030F116dDEE9F6B43aC78BA3"
            },
            "types": {
              "PermitBatchTransferFrom": [
                {
                  "name": "permitted",
                  "type": "TokenPermissions[]"
                },
                {
                  "name": "spender",
                  "type": "address"
                },
                {
                  "name": "nonce",
                  "type": "uint256"
                },
                {
                  "name": "deadline",
                  "type": "uint256"
                }
              ],
              "TokenPermissions": [
                {
                  "name": "token",
                  "type": "address"
                },
                {
                  "name": "amount",
                  "type": "uint256"
                }
              ]
            },
            "value": {
              "permitted": [
                {
                  "token": "0x0537a0f2e1373886a3d4f0e2b24c026ffa6f16f7",
                  "amount": "300000000000000"
                },
                {
                  "token": "0xc8c53856eb36a55b92f4b005672443ecf945fbda",
                  "amount": "50000000000"
                }
              ],
              "spender": "0x75ba5af8effdcfca32e1e288806d54277d1fde99",
              "deadline": 1707235435,
              "nonce": 4042
            }
          }
        }
      ],
      "chainId": "137",
      "txIndexes": [
        1
      ]
    }),
});
const data = await response.json();

Response

200

{
  "code": 200,
  "data": [
    {
      "type": "PERMIT2_BATCH",
      "taskId": "1b9a02f4-ffbb-46be-8a5b-9475d412d2ab",
      "status": "Transaction Added to Queue"
    }
  ],
  "message": "success"
}

Gasless Transactions (pay NO Gas)

Generate calldata

To generate the gasless calldata for migration.

POSThttps://migrator.aarc.xyz/migrate/gasless-calldata

Header parameters

Body

application/json

chainIdstring

ownerstring

receiverAddressstring

Response

200

Successful Response

Body

application/json

codeinteger

dataarray of one of

messagestring

Request

JavaScriptCurlPython

const response = await fetch('https://migrator.aarc.xyz/migrate/gasless-calldata', {
    method: 'POST',
    headers: {
      "x-api-key": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "chainId": "137",
      "owner": "0x4186CaC380734D5dA981D702a4bFfFB41Bc626a6",
      "receiverAddress": "0x786E6045eacb96cAe0259cd761e151b68B85bdA7"
    }),
});
const data = await response.json();

Response

200

{
  "code": 200,
  "data": [
    {
      "tokenAddress": "0x0000000000000000000000000000000000001010",
      "data": "",
      "amount": "9922946298484695970",
      "txType": "NATIVE_TRANSFER",
      "message": "Native token transfer"
    },
    {
      "tokenAddress": [
        "0x0537a0f2e1373886a3d4f0e2b24c026ffa6f16f7",
        "0x5191950f9f0b364137d945e55e0d90bec88be48f",
        "0xb6d4b00f579513086be28d835293ddb74e0aabec",
        "0xc8c53856eb36a55b92f4b005672443ecf945fbda"
      ],
      "data": "{\"permitBatchTransferFrom\":{\"permitted\":[{\"token\":\"0x0537a0f2e1373886a3d4f0e2b24c026ffa6f16f7\",\"amount\":\"6999999999999999999999999999999999999999999999999999999998500000000000000\"},{\"token\":\"0x5191950f9f0b364137d945e55e0d90bec88be48f\",\"amount\":\"6000000000000000000000000000000000000000000000000000000000000000000000000\"}],\"spender\":\"0x75ba5af8effdcfca32e1e288806d54277d1fde99\",\"deadline\":1707736657,\"nonce\":3066}",
      "txType": "PERMIT2_BATCH",
      "amount": "0",
      "message": "Permit Batch",
      "domain": {
        "name": "Permit2",
        "chainId": 137,
        "verifyingContract": "0x000000000022D473030F116dDEE9F6B43aC78BA3"
      },
      "types": {
        "PermitBatchTransferFrom": [
          {
            "name": "permitted",
            "type": "TokenPermissions[]"
          },
          {
            "name": "spender",
            "type": "address"
          },
          {
            "name": "nonce",
            "type": "uint256"
          },
          {
            "name": "deadline",
            "type": "uint256"
          }
        ]
      },
      "value": {
        "permitted": [
          {
            "token": "0x0537a0f2e1373886a3d4f0e2b24c026ffa6f16f7",
            "amount": "6999999999999999999999999999999999999999999999999999999998500000000000000"
          },
          {
            "token": "0x5191950f9f0b364137d945e55e0d90bec88be48f",
            "amount": "6000000000000000000000000000000000000000000000000000000000000000000000000"
          }
        ]
      },
      "tokenInfo": [
        {
          "tokenAddress": "0x0537a0f2e1373886a3d4f0e2b24c026ffa6f16f7",
          "amount": "6999999999999999999999999999999999999999999999999999999998500000000000000"
        }
      ]
    }
  ],
  "message": "Success"
}

Execute calldata

After receiving the calldata from the /migrate/gasless-calldata, it needs to be signed by the signer for different approvals.

To do that, you will need to get each item in the forwardCallDataReponse signed by the signer and then passed as trxList and the txnIndexes with it. Learn how to do this here.

To execute the gasless calldata for migration.

POSThttps://migrator.aarc.xyz/migrate/gasless-calldata-trx

Header parameters

Body

application/json

chainId*string

trxList*array of ExecuteCalldatTrxListItem (object)

txIndexes*array of integer

Response

200

Successful Response

Body

application/json

codeinteger

messagestring

dataarray of ExecuteCallDataResponseBodyDataItem (object)

Request

JavaScriptCurlPython

const response = await fetch('https://migrator.aarc.xyz/migrate/gasless-calldata-trx', {
    method: 'POST',
    headers: {
      "x-api-key": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "trxList": [
        {
          "target": "0x000000000022D473030F116dDEE9F6B43aC78BA3",
          "tokenAddress": [
            "0x0000000000000000000000000000000000001010"
          ],
          "data": "{\"permitBatchTransferFrom\":{\"permitted\":[{\"token\":\"0x0537a0f2e1373886a3d4f0e2b24c026ffa6f16f7\",\"amount\":\"300000000000000\"},{\"token\":\"0xc8c53856eb36a55b92f4b005672443ecf945fbda\",\"amount\":\"50000000000\"}],\"spender\":\"0x75ba5af8effdcfca32e1e288806d54277d1fde99\",\"deadline\":1707235435,\"nonce\":4042},\"tokenPermissions\":[{\"to\":\"0x0537a0f2e1373886a3d4f0e2b24c026ffa6f16f7\",\"requestedAmount\":\"300000000000000\"},{\"to\":\"0xc8c53856eb36a55b92f4b005672443ecf945fbda\",\"requestedAmount\":\"50000000000\"}],\"owner\":\"0x4186cac380734d5da981d702a4bfffb41bc626a6\",\"signature\":\"0xca733fd70e5c2d1b221a424866dbaf791a390b0b207702906529d8cb85b40c0c64956ea593a5aa807f60df675658f03371ecf812beee997ae0bc417368679aef1c\"}",
          "txType": "PERMIT2_BATCH",
          "amount": "0",
          "message": "Permit Batch",
          "eip712Struct": {
            "domain": {
              "name": "Permit2",
              "chainId": 137,
              "verifyingContract": "0x000000000022D473030F116dDEE9F6B43aC78BA3"
            },
            "types": {
              "PermitBatchTransferFrom": [
                {
                  "name": "permitted",
                  "type": "TokenPermissions[]"
                },
                {
                  "name": "spender",
                  "type": "address"
                },
                {
                  "name": "nonce",
                  "type": "uint256"
                },
                {
                  "name": "deadline",
                  "type": "uint256"
                }
              ],
              "TokenPermissions": [
                {
                  "name": "token",
                  "type": "address"
                },
                {
                  "name": "amount",
                  "type": "uint256"
                }
              ]
            },
            "value": {
              "permitted": [
                {
                  "token": "0x0537a0f2e1373886a3d4f0e2b24c026ffa6f16f7",
                  "amount": "300000000000000"
                },
                {
                  "token": "0xc8c53856eb36a55b92f4b005672443ecf945fbda",
                  "amount": "50000000000"
                }
              ],
              "spender": "0x75ba5af8effdcfca32e1e288806d54277d1fde99",
              "deadline": 1707235435,
              "nonce": 4042
            }
          }
        }
      ],
      "chainId": "137",
      "txIndexes": [
        1
      ]
    }),
});
const data = await response.json();

Response

200

{
  "code": 200,
  "data": [
    {
      "type": "PERMIT2_BATCH",
      "taskId": "1b9a02f4-ffbb-46be-8a5b-9475d412d2ab",
      "status": "Transaction Added to Queue"
    }
  ],
  "message": "success"
}

Non-gasless Transactions (pay Gas)

To generate the non-gasless calldata for migration.

POSThttps://migrator.aarc.xyz/migrate/non-gasless-calldata

Header parameters

Body

application/json

chainIdstring

ownerstring

receiverAddressstring

Response

200

Successful Response

Body

application/json

codeinteger

dataarray of one of

messagestring

Request

JavaScriptCurlPython

const response = await fetch('https://migrator.aarc.xyz/migrate/non-gasless-calldata', {
    method: 'POST',
    headers: {
      "x-api-key": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "chainId": "137",
      "owner": "0x4186CaC380734D5dA981D702a4bFfFB41Bc626a6",
      "receiverAddress": "0x786E6045eacb96cAe0259cd761e151b68B85bdA7"
    }),
});
const data = await response.json();

Response

200

{
  "code": 200,
  "data": [
    {
      "tokenAddress": "0x0000000000000000000000000000000000001010",
      "data": "",
      "amount": "9922946298484695970",
      "txType": "NATIVE_TRANSFER",
      "message": "Native token transfer"
    },
    {
      "tokenAddress": [
        "0x0537a0f2e1373886a3d4f0e2b24c026ffa6f16f7",
        "0x5191950f9f0b364137d945e55e0d90bec88be48f",
        "0xb6d4b00f579513086be28d835293ddb74e0aabec",
        "0xc8c53856eb36a55b92f4b005672443ecf945fbda"
      ],
      "data": "{\"permitBatchTransferFrom\":{\"permitted\":[{\"token\":\"0x0537a0f2e1373886a3d4f0e2b24c026ffa6f16f7\",\"amount\":\"6999999999999999999999999999999999999999999999999999999998500000000000000\"},{\"token\":\"0x5191950f9f0b364137d945e55e0d90bec88be48f\",\"amount\":\"6000000000000000000000000000000000000000000000000000000000000000000000000\"}],\"spender\":\"0x75ba5af8effdcfca32e1e288806d54277d1fde99\",\"deadline\":1707736657,\"nonce\":3066}",
      "txType": "PERMIT2_BATCH",
      "amount": "0",
      "message": "Permit Batch",
      "domain": {
        "name": "Permit2",
        "chainId": 137,
        "verifyingContract": "0x000000000022D473030F116dDEE9F6B43aC78BA3"
      },
      "types": {
        "PermitBatchTransferFrom": [
          {
            "name": "permitted",
            "type": "TokenPermissions[]"
          },
          {
            "name": "spender",
            "type": "address"
          },
          {
            "name": "nonce",
            "type": "uint256"
          },
          {
            "name": "deadline",
            "type": "uint256"
          }
        ]
      },
      "value": {
        "permitted": [
          {
            "token": "0x0537a0f2e1373886a3d4f0e2b24c026ffa6f16f7",
            "amount": "6999999999999999999999999999999999999999999999999999999998500000000000000"
          },
          {
            "token": "0x5191950f9f0b364137d945e55e0d90bec88be48f",
            "amount": "6000000000000000000000000000000000000000000000000000000000000000000000000"
          }
        ]
      },
      "tokenInfo": [
        {
          "tokenAddress": "0x0537a0f2e1373886a3d4f0e2b24c026ffa6f16f7",
          "amount": "6999999999999999999999999999999999999999999999999999999998500000000000000"
        }
      ]
    }
  ],
  "message": "Success"
}