Using Chainlink Local to Test CCIP in Your Hardhat Project

There are two comprehensive guides to help you test Chainlink CCIP in your Hardhat project using Chainlink Local - one for each mode (with and without forking). We recommend starting with the first guide (without forking) for initial development before advancing to the guide that demonstrates how to test in forked environments.

Guides

Using CCIP Local Simulator in your Hardhat project

This guide helps you set up and run CCIP in a localhost environment within your Hardhat project. It provides step-by-step instructions on :

  • Cloning the CCIP Hardhat Starter Kit
  • Installing necessary dependencies
  • Running tests for token transfers between two accounts

Using the local simulator without forking is ideal for initial development and testing in an isolated environment.

Using CCIP Local Simulator in your Hardhat project with forked environments

This guide extends your testing capabilities by demonstrating how to use the CCIP Local Simulator in a forked environment. It includes instructions on:

  • Setting up forks of real blockchain networks (e.g., Arbitrum Sepolia and Ethereum Sepolia)
  • Writing test cases
  • Running tests for cross-chain token transfers between two accounts

Using the local simulator with forked environments is ideal for testing in a more realistic yet controlled setting.

Get the latest Chainlink content straight to your inbox.