v0.2.2-beta.0

v0.2.2-beta.0 Release

This release adds config details to the Register.sol for all CCIP v1.5 testnet lanes.

Added

• Added CCIP v1.5 config details to Register.sol for all available testnet lanes

Testing the release

To test this release install @chainlink-local using the following commands:

Foundry (git)

forge install smartcontractkit/chainlink-local@v0.2.2-beta.0

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

Hardhat (npm)

npm install @chainlink/local@v0.2.2-beta.0

and then create the following contract and compile it:

// SPDX-License-Identifier: MIT
pragma solidity 0.8.24;

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

Remix IDE

// SPDX-License-Identifier: MIT
pragma solidity 0.8.24;

import {CCIPLocalSimulator} from "https://github.com/smartcontractkit/chainlink-local/blob/v0.2.2-beta.0/src/ccip/CCIPLocalSimulator.sol";

PRs included

• CCIP v1.5 testnet lanes by @andrejrakic in #21

Full Changelog: v0.2.2-beta...v0.2.2-beta.0

v0.2.2-beta

v0.2.2-beta Release

This release adds a tentative support for CCIP v1.5.

Added

• Support for Chainlink CCIP v1.5 (bumped @chainlink/contracts-ccip to
  1.5.0-beta.0)
• Set EVM Version strictly to paris for all contracts
• Added supportNewTokenViaOwner and supportNewTokenViaGetCCIPAdmin functions
  to CCIPLocalSimulator.sol instead of supportNewToken function
• Added rmnProxyAddress, tokenAdminRegistryAddress and
  registryModuleOwnerCustomAddress to the NetworkDetails struct of the
  Register.sol smart contract
• Added unit tests for new functions in the CCIPLocalSimulator.sol contract
• Added e2e test for new changes in the CCIPLocalSimulatorFork.sol contract.
  There is a test with ERC-20 token with an owner() function implemented and
  Burn & Mint Pool, and test with ERC-20 token with a getCCIPAdmin() function
  implemented and Lock & Release Pool

Changed

• Bumped Solidity compiler version from 0.8.19 to 0.8.24
• The getSupportedTokens() function now only exists in the
  CCIPLocalSimulator.sol contract, it has been removed from the CCIP's
  Router.sol contract. Calling that function from the Router.sol contract in
  the Forking mode will now revert
• Added uint32[] memory tokenGasOverrides as function parameter to the
  executeSingleMessage function in the CCIPLocalSimulatorFork.sol contract
  to reflect new changes in the CCIP's EVM2EVMOffRamp.sol smart contract
• Bumped pragma solidity version of BasicTokenSender.sol,
  CCIPReceiver_Unsafe.sol, ProgrammableTokenTransfers and
  ProgrammableDefensiveTokenTransfers.sol contracts from the src/test folder
  from 0.8.19 to 0.8.24

Removed

• Removed supportNewToken function from CCIPLocalSimulator.sol
• Removed CCIPLocalSimulatorV0.sol and MockEvm2EvmOffRamp.sol contracts as
  they have not being used for a while

Testing the release

To test this release install @chainlink-local using the following commands:

Foundry (git)

forge install smartcontractkit/chainlink-local@v0.2.2-beta

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

Hardhat (npm)

npm install @chainlink/local@v0.2.2-beta

and then create the following contract and compile it:

// SPDX-License-Identifier: MIT
pragma solidity 0.8.24;

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

Remix IDE

// SPDX-License-Identifier: MIT
pragma solidity 0.8.24;

import {CCIPLocalSimulator} from "https://github.com/smartcontractkit/chainlink-local/blob/v0.2.2-beta/src/ccip/CCIPLocalSimulator.sol";

PRs included

• Automated API Reference Generation and Index File Creation by @aelmanaa in #14
• Support for CCIP v1.5 and preparing for 0.2.2-beta release by @andrejrakic in #19

New Contributors

• @aelmanaa made their first contribution in #14

Full Changelog: v0.2.1...v0.2.2-beta

v0.2.1

v0.2.1 Release - 5 July 2024

This release adds support for Chainlink Data Feeds to Chainlink Local.

Documentation for this release is available at:

• https://cll-devrel.gitbook.io/chainlink-local-documentation/api-reference/mockv3aggregator.sol-api
• https://cll-devrel.gitbook.io/chainlink-local-documentation/api-reference/mockoffchainaggregator.sol-api

Testing the release

To test this release install @chainlink-local using the following commands:

Foundry (git)

forge install smartcontractkit/chainlink-local@v0.2.1

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

Hardhat (npm)

npm install @chainlink/local@v0.2.1

and then create the following contract and compile it:

pragma solidity ^0.8.0;

import {MockV3Aggregator} from "@chainlink/local/src/data-feeds/MockV3Aggregator.sol";

Remix IDE

pragma solidity ^0.8.0;

import {MockV3Aggregator} from "https://github.com/smartcontractkit/chainlink-local/blob/v0.2.1/src/data-feeds/MockV3Aggregator.sol";

Changelog

Dependencies

Package	Version
@chainlink/contracts-ccip	1.4.0
@chainlink/contracts	1.1.1

Services

• Chainlink CCIP
• Chainlink Data Feeds
• Chainlink VRF 2
• Chainlink VRF 2.5

Added

• Support for Chainlink Data Feeds by adding MockV3Aggregator.sol and MockOffchainAggregator.sol mock contracts
• Showcase tests for testing in a forking actual networks environment

v0.2.1-beta

v0.2.1-beta Release

This release fixes bugs from the v0.2.0-beta release that added support for Chainlink Data Feeds to Chainlink Local.

Documentation for this release is available at:

• https://cll-devrel.gitbook.io/chainlink-local-documentation/api-reference/mockv3aggregator.sol-api
• https://cll-devrel.gitbook.io/chainlink-local-documentation/api-reference/mockoffchainaggregator.sol-api

Testing the release

To test this release install @chainlink-local using the following commands:

Foundry (git)

forge install smartcontractkit/chainlink-local@v0.2.1-beta

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

Hardhat (npm)

npm install @chainlink/local@v0.2.1-beta

and then create the following contract and compile it:

pragma solidity ^0.8.0;

import {MockV3Aggregator} from "@chainlink/local/src/data-feeds/MockV3Aggregator.sol";

Remix IDE

pragma solidity ^0.8.0;

import {MockV3Aggregator} from "https://github.com/smartcontractkit/chainlink-local/blob/v0.2.1-beta/src/data-feeds/MockV3Aggregator.sol";

---

Full Changelog: v0.2.0-beta...v0.2.1-beta

v0.2.0-beta

v0.2.0-beta Release

This release adds support for Chainlink Data Feeds to Chainlink Local.

Testing the release

To test this release install @chainlink-local using the following commands:

Foundry (git)

forge install smartcontractkit/chainlink-local@v0.2.0-beta

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

Hardhat (npm)

npm install @chainlink/local@v0.2.0-beta

and then create the following contract and compile it:

pragma solidity ^0.8.0;

import {MockV3Aggregator} from "@chainlink/local/src/data-feeds/MockV3Aggregator.sol";

Remix IDE

pragma solidity ^0.8.0;

import {MockV3Aggregator} from "https://github.com/smartcontractkit/chainlink-local/blob/v0.2.0-beta/src/data-feeds/MockV3Aggregator.sol";

Initial release of the project

Developers Can Get Started in Seconds Using the CCIP Local Simulator

We’re excited to announce that the Chainlink Cross-Chain Interoperability Protocol (CCIP) has officially entered general availability (GA)!

We believe that enabling developers to build quicker helps the entire ecosystem grow faster. That’s why we’ve also developed a simulator that allows you to build with CCIP on your local machine directly in Remix IDE, Hardhat or Anvil (Foundry).

Previously, developers had to build with CCIP directly on a testnet, which often meant having to wait 10+ minutes just to test a single cross-chain message or token transfer. In this initial simulator version, you can now build, deploy, and execute CCIP token transfers and arbitrary messages on a local Remix, Hardhat or Anvil (Foundry) network, both with and without forking. This greatly speeds up development, as CCIP messaging and token transfer transaction times have now been reduced to seconds.

Read more at the blog post here and watch the 5-minute live presentation of Chainlink Local here.