https://github.com/protofire/hardhat-chainlink-plugin
https://github.com/protofire/hardhat-chainlink-plugin
Last synced: 10 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/protofire/hardhat-chainlink-plugin
- Owner: protofire
- License: mit
- Created: 2022-09-05T12:33:01.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2022-11-01T20:47:15.000Z (about 3 years ago)
- Last Synced: 2025-03-15T08:07:18.275Z (10 months ago)
- Language: Solidity
- Size: 683 KB
- Stars: 2
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Chainlink hardhat plugin
This plugin makes spinning up a local Chainlink node faster and easier, allowing developers to build smart contracts using the Chainlink services.
## Getting Started
### Prerequisites
- node > 16.X
- npm > 7
- docker
### Installation
**Step 1:**
Install `hardhat-chainlink-plugin` hardhat plugin.
```console
npm install hardhat-chainlink-plugin
```
**Step 2:**
Open Docker Desktop
**Step 3:**
Run hardhat node
```console
npx hardhat node
```
**Step 4:**
Spin up a chainlink node using the following command, which will set-up some env variables. Please do not start it from docker desktop.
```console
npx hardhat chainlink:run-node
```
IMPORTANT!
Each time this command runs it will remove all containers and re-create them (before running docker compose up we first run docker compose down)
This behavior is analogous to the hardhat EVM node losing all previous history each time it is restarted.
If you want to restart only pass an additional `true` parameter (restartOnly) like this `npx hardhat chainlink:run-node true`
If you visit http://127.0.0.1:6688 in your browser, you should see the chainlink node login page displayed.
You can use details: username **hardhatuser@protofire.io** and password **password123456789** to login to your local chainlink node.
To see the available tasks to interact with your node run
```console
npx hardhat
```
**Step 5:**
Next, for your chainlink node to fulfill request it needs to be funded with ETH. To fund your node first you need to get the node info.
Running the command below does just that.
```console
npx hardhat chainlink:node-info --network localhost
```
Output will look like this
```console
┌─────────┬──────────────────────────────────────────────┐
│ (index) │ Values │
├─────────┼──────────────────────────────────────────────┤
│ Address │ '0x786729C810294D47E935aE636F66f6cE35E9B99d' │
│ Balance │ '0.000000000000000000' │
│ ChainID │ '31337' │
└─────────┴──────────────────────────────────────────────┘
```
Copy the node address and replace it in the command below to fund your wallet.
```console
npx hardhat chainlink:fund-eth 0x244f78C560F6cfcB3baBEe375ae064C6e9259989 20 --network localhost
```
Now check the node info again, to see the updated balance.
```console
npx hardhat chainlink:node-info --network localhost
```
Output:
```console
┌─────────┬──────────────────────────────────────────────┐
│ (index) │ Values │
├─────────┼──────────────────────────────────────────────┤
│ Address │ '0x786729C810294D47E935aE636F66f6cE35E9B99d' │
│ Balance │ '20.000000000000000000' │
│ ChainID │ '31337' │
└─────────┴──────────────────────────────────────────────┘
```
If you login again to your Node UI from http://127.0.0.1:6688 or simply refresh the page if you are still login. You will see the node updated password on the dashboard.
**Step 6:**
Deploy Link token on hardhat. Link Token will be used by Consumer contract to pay for Oracle request.
```console
npx hardhat chainlink:deploy-link --network localhost
```
Output
```console
┌────────────────────┬──────────────────────────────────────────────┐
│ (index) │ Values │
├────────────────────┼──────────────────────────────────────────────┤
│ Link Token Address │ '0x5FbDB2315678afecb367f032d93F642f64180aa3' │
└────────────────────┴──────────────────────────────────────────────┘
```
**Step 7:**
Deploy Oracle contract.
Pass the chainlink node address as the first parameter and Link Token address as the second parameter.
```console
npx hardhat chainlink:deploy-oracle 0xBe576260A47175829f250732421522B7ec204D06 0x5FbDB2315678afecb367f032d93F642f64180aa3 --network localhost
```
Output
```console
┌────────────────┬──────────────────────────────────────────────┐
│ (index) │ Values │
├────────────────┼──────────────────────────────────────────────┤
│ Oracle Address │ '0x5FbDB2315678afecb367f032d93F642f64180aa3' │
└────────────────┴──────────────────────────────────────────────┘
```
**Step 8:**
Create a chainlink Job.
Pass your node username, password, deployed Oracle address and job type (direct | cron).
```console
npx hardhat chainlink:create-job 0x5FbDB2315678afecb367f032d93F642f64180aa3 direct
```
Output
```console
┌────────────┬────────────────────────────────────────┐
│ (index) │ Values │
├────────────┼────────────────────────────────────────┤
│ Status │ 'Success' │
│ Error │ null │
│ JobID │ '1' │
│ ExternalID │ '95cd6192-8dc8-4e1d-903d-3e7b885bc9d5' │
└────────────┴────────────────────────────────────────┘
```
TROUBLESHOOTING
--------
If you turn off the hardhat node all history will get wiped. In that case you will also need to run the chainlink node again using the `chainlink:run-node` command.
If the chainlink node becomes out of sync (info not updating) then you can run `chainlink:run-node true` which will restart the node without destroying the containers.
Take note of the ExternalID of the Job.
Running locally
===============
If you want to test out this commands in this repository you will need to change the initial setup a bit by first running `npm install && npm run build` and only after that will you be able to run the hardhat node from the root of this repository.