This use case demonstrates how to connect the Graph API and Uniswap router using Chainlink Functions to implement a trading strategy.
In particular, the example demonstrates how to retrieve three-day trading volume data from the WETH-USD pool in Uniswap V3 through a subgraph. It then uses Chainlink Functions to evaluate the liquidity based on the trading volume data.
If the liquidity of the pair is increasing, Chainlink functions triggers a function in FunctionsConsumer.sol
to swap Wrapped Matic in the contract balance to Wrapped Ether.
Original idea behind the use case is that strong liquidity implies relatively safer assets as high liquidity assets are more easily traded and typically have lower price volatility. Therefore, decisions based on liquidity data from Uniswap pools can provide more reliable information to assess the risk asset swaps.
Under the scenario, using Chainlink Functions allows for a more accurate assessment of whether to exchange Wrapped Matic for WETH based on the current liquidity conditions, enabling better risk management.
In this use case, the reason for choosing to swap Wrapped matic to Wrapped Ether is that in the Polygon Mumbai testnet, only the the pair has sufficient liquidity for testing purposes. In production, you can choose any token pair to swap based on your needs and strategies.
- Node.js version 18
- Clone this repository to your local machine
- Open this directory in your command line, then run
npm install
to install all dependencies. - Aquire a Github personal access token which allows reading and writing Gists.
- Visit https://github.com/settings/tokens?type=beta and click "Generate new token"
- Name the token and enable read & write access for Gists from the "Account permissions" drop-down menu. Do not enable any additional permissions.
- Click "Generate token" and copy the resulting personal access token for step 4.
- Aquire a Graph key which allows reading data indexed by subgraphs. Please do not forget to claim queries and make sure
FREE REMAINING: 1000
displayed in column "QUERIES TOTAL" of the key. - Set the required environment variables.
- Set an encryption password for your environment variables to a secure password by running:
npx env-enc set-pw
- Use the command
npx env-enc set
to set the required environment variables (see Environment Variable Management):- GITHUB_API_TOKEN for your Github token obtained from step 3
- GRAPH_KEY for Graph key obtained from step 4
- PRIVATE_KEY for your development wallet
- POLYGON_MUMBAI_RPC_URL, ETHEREUM_SEPOLIA_RPC_URL
- If desired, the
POLYGONSCAN_API_KEY
can be set in order to verify contracts`.
- Set an encryption password for your environment variables to a secure password by running:
- There are two files to notice that the example will use:
- contracts/FunctionsConsumer.sol contains the smart contract that will receive the data and make the swap
- graph_request.js contains JavaScript code that will be executed by each node of the DON
- Test an end-to-end request and fulfillment locally by simulating it using:
npx hardhat functions-simulate-script
- Deploy and verify the client contract to an actual blockchain network by running:
npx hardhat functions-deploy-consumer --network polygonMumbai --verify true
Note: Make surePOLYGONSCAN_API_KEY
is set if using--verify true
, depending on which network is used. - Create, fund & authorize a new Functions billing subscription by running:
npx hardhat functions-sub-create --network polygonMumbai --amount 5 --contract <contract_address>
Note 1: You have to go to Chainlink CCIP app to sign the term of use in the first time. .
Note 2: Ensure your wallet has 5 LINK in your balance before running this command. Testnet LINK can be obtained at faucets.chain.link.
Note 3: Please make sure that you are using polygon mumbai testnet. If you want to use the contract in other networks, change the lineif (block.chainid != 80001)
in the fileFunctionsConsumer.sol
. - Transfer at least 0.1 WMATIC to contract FunctionsConsumer to make sure there is some WMATIC tokens in balance can be swapped. You need to add WMATIC into your Metamask before transfering, and the address of WMATIC on Polygon Mumbai is
0x9c3C9283D3e44854697Cd22D3Faa240Cfb032889
.
Matic on Mumbai can be obtained at alchemy faucet, and Matic can be swapped to Wrapped Matic(WMATIC) at Uniswap on Mumbai. - Make an on-chain request by running:
npx hardhat functions-request --network polygonMumbai --contract <contract_address> --subid <subId> --callbackgaslimit 300000
. Please make sure you add the parameter--gaslimit
and set it as 300k.
- Chainlink functions are still in beta test, please make sure the address you are using is in the allowlist.
- Please find Subgraph used in the use case here.
- Please find sample code for "Single Swaps" in Uniswap here.
- The repo is a fork of functions-hardhat-starter-kit, please find more use cases of Chainlink functions here. For more detailed tutorials and examples, check out the Chainlink Functions Tutorials to get started.