API Version: v0.2.9 Not using latest version (v0.3.1)

Chainlink Local v0.2.9 API Reference

Integrate Chainlink Local into your project

If you use NPM, install the @chainlink/local NPM package:

npm install @chainlink/local@0.2.9

If you use Yarn, install the @chainlink/local NPM package:

yarn add @chainlink/local@0.2.9

If you use Foundry:

forge install smartcontractkit/chainlink-local@v0.2.9

and then set remappings to: @chainlink/local/=lib/chainlink-local/ in either remappings.txt or foundry.toml file

Import the CCIPLocalSimulator contract from the @chainlink/local package:

import {CCIPLocalSimulator} from "@chainlink/local@0.2.9/src/ccip/CCIPLocalSimulator.sol";

Chainlink Local v0.2.9 fixes CCIPLocalSimulatorFork.switchChainAndRouteMessage to pair the destination OffRamp with the source OnRamp by reading getSourceChainConfig (v1.6+) and getStaticConfig (pre-v1.6), with a fallback to other OffRamps with the same sourceChainSelector. This is the last release of the 0.2.x line and the one Hardhat 2 users stay on.

CCIP

These contracts provide Cross-Chain Interoperability Protocol (CCIP) functionality in a local testing environment:

CCIPLocalSimulator - Local CCIP simulator (no-fork mode)
CCIPLocalSimulatorFork - CCIP simulator for forked networks
CCIPLocalSimulatorFork JS - JavaScript helpers for fork routing
Register - CCIP network configuration registry

Data Streams

Contracts for simulating Chainlink Data Streams:

DataStreamsLocalSimulator - Local Data Streams simulator (no-fork mode)
DataStreamsLocalSimulatorFork - Data Streams simulator for forked networks
MockVerifier - Mock Data Streams verifier
MockVerifierProxy - Mock Data Streams verifier proxy
MockReportGenerator - Signed report generator for every report schema
MockFeeManager - Mock verifier fee manager
MockRewardManager - Mock reward manager
ReportVersions - Data Streams report schemas
Register (Data Streams) - Data Streams network configuration registry

Data Feeds

Contracts for simulating Chainlink Data Feeds:

AggregatorInterface - Basic price feed interface
AggregatorV2V3Interface - Combined V2/V3 price feed interface
AggregatorV3Interface - Extended price feed interface
MockOffchainAggregator - Mock implementation of off-chain aggregator
MockV3Aggregator - Mock implementation of V3 aggregator

Token Contracts

Standard token implementations for testing:

BurnMintERC677Helper - Helper contract for ERC677 token operations
LinkToken - LINK token implementation
WETH9 - Wrapped Ether implementation