# Old Integration Guide (deprecated) Welcome to the Nabla integration guide. If you are new to Nabla, we recommend you start with the [Developer overview](/developers.md) section first. We will go through the steps to **get an on-chain swap quote** and show you how to **execute an ERC20-to-ERC20 swap** with Nabla. \ For this, we are going to call the following functions at the [NablaPortal ](/developers/contract-interfaces/nablaportal.md)contract as our entry point: * quoteSwapExactTokensForTokens and * swapExactTokensForTokens
*** ## Let's begin ### 1. Retrieve price update data Nabla is an oracle based DEX. {% hint style="warning" %} You need to submit **signed price update data** to Nabla contracts, for hubs either using **Pyth** or **Nabla Oracle** price feeds. {% endhint %} You can check what **price update data** is needed, either * Pyth price update data or * Nabla price update data for a pool ensemble/hub in the [deployed contracts section](/developers/contract-addresses.md) under "Router".
Pyth price update data #### Get the price feed ids (one time task) You can retrieve the Pyth price feed ids (bytes32) from the [PythAdapter](/developers/contract-interfaces/pythadapter.md) \`[getPriceFeedIdByAsset](https://docs.nabla.fi/developers/pythadapter#getpricefeedidbyasset)\` for the assets you are interested in.\ \ In case of USDC and WETH on Arbitrum: ``` # WETH cast call 0x4cC48Fde2296E49E7dA73159c0bf0f89Bd8AF4aa "getPriceFeedIdByAsset(address)(bytes32)" 0x82aF49447D8a07e3bd95BD0d56f35241523fBab1 --rpc-url $ARBITRUM_MAINNET_RPC_URL 0xff61491a931112ddf1bd8147cd1b641375f79f5825126d665480874634fd0ace # USDC cast call 0x4cC48Fde2296E49E7dA73159c0bf0f89Bd8AF4aa "getPriceFeedIdByAsset(address)(bytes32)" 0xaf88d065e77c8cC2239327C5EDb3A432268e5831 --rpc-url $ARBITRUM_MAINNET_RPC_URL 0xeaa020c61cc479712813461ce153894a96a6c00b21ed0cfc2798d1f9a9e9c94a ``` Basically these are the price feeds from Pyth, also listed here:\ #### Query Pyth's Hermes API Example (curl): ``` curl -X 'GET' \ 'https://hermes.pyth.network/v2/updates/price/latest?ids%5B%5D=0xff61491a931112ddf1bd8147cd1b641375f79f5825126d665480874634fd0ace&ids%5B%5D=0xeaa020c61cc479712813461ce153894a96a6c00b21ed0cfc2798d1f9a9e9c94a' \ -H 'accept: application/json' ``` Response (snippet, parsed section): ```json ... "parsed": [ { "id": "ff61491a931112ddf1bd8147cd1b641375f79f5825126d665480874634fd0ace", "price": { "price": "305192675883", "conf": "153073812", "expo": -8, "publish_time": 1737975905 }, ... { "id": "eaa020c61cc479712813461ce153894a96a6c00b21ed0cfc2798d1f9a9e9c94a", "price": { "price": "100003959", "conf": "117800", "expo": -8, "publish_time": 1737975905 }, ``` In this example the prices come with 8-decimal accuracy. {% hint style="warning" %} The `price` data field is needed for getting a most up-to-date **quote** {% endhint %} Full response: ```json { "binary": { "encoding": "hex", "data": [ "504e41550100000003b801000000040d005ac409b82275b0f4581f0b6811974cc248d573f0b3a2150fc51f29f34e3ce6590c5afbb6751d96c2b888181fd97e6666aa2f59c661129b744c68920b3440beab000283426c73cbe491cd752d30a69c45d9fde6fe23040743d9dcb228ebd96efd785e12a61d39fc0ede203846e4bc11000fea59cf15f68c8956a8e0b2ab1bd5cc9cf200035791c4ae302ea0981d6c59a24ad83c5c52f2de48327c8fd79a6844a17bcba8a061af7ec15cbb93fbabce85d57f85102efddb0f9eb2dfed3776861f113d320ffb00047edb291f562eae0298ecd3863759f225f6da140fc1abe75e8fb2193ffedfdaa44895da1874dc4d385e6ec248af4aedba7c44842cda59df01b8dc2cef61abd13c0006c077eab40dc27a24622075c3477e837c098678a498b435e2c0a51eaba38b833543ebc93e0580815df106f4c33b8af0be9ae2e57a1429d0168bdc13ad16cb859b0108b496b670f8287721c4ef47d59ea3d117310abf6954d952883e160ea3154372720b398175a5d58c78d24d13f22c3ee465bf2e74fad91762b9f13d489d8458a6e6010ac07ce5fd5d56c89128ac9b064e8ae776da3f79a30446755f4e01d4b4db709e7c7a859c15ef4e302720e2c1f80a35ad469069c1bed440a679cc827d4d7d60ab90000bf8d0ab54e8dabbb1b0e8e6ec94ffd9b26915f1eaea6248774d8d6da8e995ff3455bc287362498a534541516fd8e931a6f91b30aa9305326c8005297fd9ed76fb010ca3127f7d4232b16aaaf9b528445b6219f1c1fe1a045677ea3dd095428e2a5e356d7fa8e28d6ad9696ae2adaf5ced471d20f06411f9711ebbe6f5d9d7737e4848000dd57293c785f4e43f0078df31b9be587f1d1e72336a08387b38737337994ff54a170bacc2f512550fb37a99d2f603a6acd140536999da093239f58d92f0b01609010e49c95d1badf53ceef358c7ae2852e2db2fc6999111bdff9dfbf855baf05abe863af6c5f2205bcc457ffc59c9cd36aabf96493a886f08c1691bb0fdc6036b351b000fbc02a92c1d94ac517e5844882b37b24f5097ad3ae246e3db9197a518d028e600622634b66bdec568a1fcff7291abcd0eeda7d747a0461da2a79a545935eff1660011006e9c665f83b9f4c32ddfa015ad9b56adae4214155e0dcae1dc69d9b53266742491b2ec95acdcb223af499d911df177956d89c27157211c006815c8ac5b93e90067976c2a00000000001ae101faedac5851e32b9b23b5f9411a8c2bac4aae3ed4dd7b811dd1a72ea4aa71000000000684a2f8014155575600000000000b9189b30000271046ce0774a317ccaebc81d3c486f14d96faafbcc302005500ff61491a931112ddf1bd8147cd1b641375f79f5825126d665480874634fd0ace0000004760ec68200000000007fcfb98fffffff80000000067976c2a0000000067976c2900000047324fd2500000000009b2196a0bdc38644b353ef712c262043f6acf1aeca2ded131c37aab82271a1086e80957fcb03ff4707a920d2d5d62e4aad732b67f4ceb2192f61fe78e6e6ab46a15b45eac3728e4ad5f855960af2d10e512ef2e5cb57cb45eb93cb9b1b1cdfbc7bef79ca60599fbe8a67117d5bea1279f2ae39d350842484aeef2874c565559d6c4ab7693d98123b8600bd7acab21483545fa41c4d1e341fd2771f11395a2f8b67b78b7fd298439aa89bfedc10ecdc17d59ba2e6ae1a659d36ed3bdd02e40f9245ae51f15edf6e39ed91de880ed19773f8b7662cb6147e203afc1c5389e8ee83a005500eaa020c61cc479712813461ce153894a96a6c00b21ed0cfc2798d1f9a9e9c94a0000000005f5eb3f000000000001c939fffffff80000000067976c2a0000000067976c290000000005f5efd6000000000001b8190b9318da3665983c37b51bfe867db74406319810b9d0baa775344898275de3a5f93feaf82e9be5af47653daba796886dcd54f74c6b26dce797b455275d795ce318d7daa1cb788662a736d6f918bfe7021eb7e01606b69139ad4544ea31be423c2aef7a2f19ce4108c397c5e454d4194a4da0c005af34b9277dc07cd01a1ea4d832cd9d2159d5b1e17c8dd0f4ea45fa41c4d1e341fd2771f11395a2f8b67b78b7fd298439aa89bfedc10ecdc17d59ba2e6ae1a659d36ed3bdd02e40f9245ae51f15edf6e39ed91de880ed19773f8b7662cb6147e203afc1c5389e8ee83a" ] }, "parsed": [ { "id": "ff61491a931112ddf1bd8147cd1b641375f79f5825126d665480874634fd0ace", "price": { "price": "306568783904", "conf": "134019992", "expo": -8, "publish_time": 1737976874 }, "ema_price": { "price": "305786770000", "conf": "162666858", "expo": -8, "publish_time": 1737976874 }, "metadata": { "slot": 194087347, "proof_available_time": 1737976875, "prev_publish_time": 1737976873 } }, { "id": "eaa020c61cc479712813461ce153894a96a6c00b21ed0cfc2798d1f9a9e9c94a", "price": { "price": "100002623", "conf": "117049", "expo": -8, "publish_time": 1737976874 }, "ema_price": { "price": "100003798", "conf": "112665", "expo": -8, "publish_time": 1737976874 }, "metadata": { "slot": 194087347, "proof_available_time": 1737976875, "prev_publish_time": 1737976873 } } ] } ``` {% hint style="warning" %} The `data` field is the needed **price update data** for moving forward with a **swap**. {% endhint %} {% hint style="info" %} For Pyth price update data, there is also a SSE streaming endpoint available\ {% endhint %}
Nabla price update data **Get the price feed ids (one time task)** The price feed ids used for Nabla price update data are identical to Pyth. This is to ensure alignment with pool ensembles/hubs that still using Pyth price feeds and to ensure ease of integration. The price feed ids from Pyth are listed here:\ #### Query Nabla Quote API {% hint style="warning" %} Please contact us if you're interested in integrating Nabla Quote API {% endhint %} Response (snippet, parsed section): ```json ... { "id": "3fa4252848f9f0a1480be62745a4629d9eb1322aebab8a791e344b3b9c1adcf5", "metadata": { }, "price": { "price": 29225000, "publish_time": 1744383661422 } }, ... ``` In this example the prices come with 8-decimal accuracy. {% hint style="warning" %} The `price` data field is needed for getting a most up-to-date **quote** {% endhint %} Full response: ```json { "binary": { "data": [ string ], "encoding": "hex" }, "parsed": [ { "id": "3fa4252848f9f0a1480be62745a4629d9eb1322aebab8a791e344b3b9c1adcf5", "metadata": { }, "price": { "price": 29480000, "publish_time": 1744379324061 } } ] } ``` {% hint style="warning" %} The `data` field is the needed **price update data** for moving forward with a **swap**. {% endhint %} {% hint style="info" %} For Nabla price update data, there is also a SSE streaming endpoint available. {% endhint %}
### 2. Get an on-chain quote We have just received the price information about the assets we are interested in.\ Now we can feed the prices directly into the [NablaPortal](/developers/contract-interfaces/nablaportal.md) quoting function: ```solidity NablaPortal.quoteSwapExactTokensForTokens( uint256 _amountIn, address[] _tokenPath, address[] _routerPath, [priceTokenA, priceTokenB] ) external view returns (uint256 amountOut_) ``` Example quote with foundry's cast for 1k USDC (6 decimal precision) to WETH through [Nabla's Main Crypto Hub on Arbitrum](https://app.nabla.fi/): ```solidity cast call 0xcB94Eee869a2041F3B44da423F78134aFb6b676B \ "quoteSwapExactTokensForTokens(uint256 amountIn, address[] tokenPath, address[] routerPath, uint256[] tokenPrices)(uint256)" \ 1000000000 \ "[0xaf88d065e77c8cC2239327C5EDb3A432268e5831,0x272dF896f4D0c97F65e787f861bb6e882776a155]" \ "[0x7bcFc8b8ff61456ad7C5E2be8517D01df006d18d]" \ "[100003959,305192675883]" \ --rpc-url $(ARBITRUM_MAINNET_RPC_URL) ``` ### 3. Perform a swap We have received **price updata data** and are happy with the quote, we can now perform a swap through [NablaPortal](/developers/contract-interfaces/nablaportal.md).\ For this to work we need to feed the **price update data** into the swap function as \`[\_priceUpdateData](https://docs.nabla.fi/developers/nablaportal#swapexacttokensfortokens)\`. ```solidity NablaPortal.swapExactTokensForTokens( uint256 _amountIn, uint256 _amountOutMin, address[] calldata _tokenPath, address[] calldata _routerPath, address _to, uint256 _deadline, bytes[] calldata _priceUpdateData ) ``` {% hint style="warning" %} The **price updata data** is considered as valid if on-chain update is "not too old*"*.\ Also, if another bot or user updates the price on-chain that is newer than the one you have submitted, this newer price is taken. {% endhint %} If all requirements are met (e.g. minimum amount to accept & price update data not too old) the swap will execute successfully. :tada:
*** ## Done :relaxed: Thanks for integrating with Nabla :raised\_hands: \ If you have questions, please do not hesitate to get in contact and ask in our Discord or Telegram. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.nabla.fi/developers/old-integration-guide-deprecated.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.