Skip to content
Web3 developer infrastructure ยท oracles

Chainlink Hardhat plugin and Foundry toolkit

Chainlink is the oracle layer under a large share of on-chain finance, but a team adding a price feed, a VRF call, or an Automation upkeep to a contract had to wire Chainlink in by hand and test it against a real node. Protofire built two developer tools to reduce that friction: a Hardhat plugin and a Foundry toolkit that let developers call Chainlink Data Feeds, VRF, Automation, and Functions directly from the framework they already use, and spin up a local Chainlink node to test against before mainnet.

Protofire authored the original Hardhat plugin at protofire/hardhat-chainlink-plugin; the maintained tools now live in Chainlink's `smartcontractkit` GitHub organization: smartcontractkit/hardhat-chainlink and smartcontractkit/foundry-chainlink-toolkit.

Snapshot
Client
Chainlink
Sector
Web3 developer infrastructure / oracles

โ€œChainlink wanted its services as easy to adopt and test as any local library, inside the tools developers already use.โ€

02

Why testing against oracles was the harder half of the problem

Wiring the contract is only half the job. An oracle-dependent contract behaves differently depending on what the oracle returns, so a team cannot responsibly ship one without testing that behavior first. Before these tools there was no convenient way to exercise a Chainlink integration locally: developers either pointed at a live testnet, slow and flaky for iteration, or mocked the oracle, which does not test the real interaction.

That gap slowed iteration, made continuous integration harder, and left teams less confident a VRF callback or an Automation upkeep would fire as expected. Chainlink wanted its services as easy to adopt and test as any local library, inside the tools developers already use.

03

How Protofire built the Hardhat plugin and Foundry toolkit

Protofire built two standalone developer tools so a developer stays in one framework. The Hardhat plugin exposes Chainlink functionality through TypeScript tasks inside a Hardhat project; the Foundry toolkit provides atomic methods, driven by Forge, Make, and Solidity scripting, for the same services in a Foundry project.

Both cover the four core services: Data Feeds, VRF, Automation, and Functions. The part that closes the testing gap is a local sandbox: each tool can spin up a local Chainlink node, or a small cluster, so a team runs tests and simulations against a real node offline instead of a live testnet. A developer can create Chainlink jobs, deploy and call the related contracts, and do it from code or CLI in the framework they already run.

The work started in Protofire's own repositories and was subsequently adopted into the `smartcontractkit` organization, where the maintained tools now live. Each repository's contributor graph shows Protofire's contribution history.

04

Results

The verifiable artifacts are public. The Foundry toolkit is at smartcontractkit/foundry-chainlink-toolkit and the Hardhat tool at smartcontractkit/hardhat-chainlink; Protofire's original plugin is at protofire/hardhat-chainlink-plugin. The Hardhat plugin's README notes it is in a beta testing phase; check current status before relying on it in production.

Two developer tools built and open-sourced: a Hardhat plugin and a Foundry toolkit
Both maintained in Chainlink's `smartcontractkit` GitHub org; the Hardhat plugin was originally authored by Protofire at protofire/hardhat-chainlink-plugin
The Hardhat plugin Protofire authored, now maintained in `smartcontractkit`, is published on npm as `@chainlink/hardhat-chainlink` and reached several thousand downloads a year on npm, peaking above 8,000 in a single year, a reader-checkable adoption signal
Coverage for all four core services: Data Feeds, VRF, Automation, and Functions
Local Chainlink-node sandbox for offline testing and CI, in both tools

Technology stack

TypeScript (Hardhat)Forge / Make / Solidity scripting (Foundry)local Chainlink nodesSolidity
Build the same with us

FAQ

Did Protofire build Chainlink's oracle network?
No. Chainlink builds and runs the oracle network. Protofire built developer tooling around it: a Hardhat plugin and a Foundry toolkit that make Chainlink services easier to integrate and test inside standard smart-contract workflows. The tools are maintained in Chainlink's `smartcontractkit` GitHub organization, but the oracle network itself is Chainlink's.
What do the tools actually do?
Each tool lets a developer call Chainlink Data Feeds, VRF, Automation, and Functions from inside their framework, create Chainlink jobs, and deploy and interact with the related contracts, from code or CLI. Both can spin up a local Chainlink node so integrations can be tested and simulated offline before going to mainnet. The Hardhat plugin's README notes it is currently in a beta testing phase.
How can I verify this work?
It is open source. See smartcontractkit/foundry-chainlink-toolkit, smartcontractkit/hardhat-chainlink, and Protofire's original protofire/hardhat-chainlink-plugin. Each repository's contributor graph shows Protofire's commit history.

Book a call with Alejandro Losa

Schedule a call with our Web3 Solution Architect to receive practical recommendations and a prompt proposal for upgrading your solution.

Protofire 2026. All rights reserved

Message us on Telegram