The home for Hyperlane core contracts, sdk packages, and other infrastructure

blockchain hyperlane interchain monorepo

History

Yorke Rhodes cb404cb85c feat: implement checkpoint fraud proofs (#4277 ) ### Description Implements 4 categories of checkpoint fraud proofs for use in future validator slashing protocol: 1. premature: if a checkpoint index is greater than the corresponding mailbox count, it is fraudulent 2. non local: if a checkpoint origin does not match the checkpoint's mailbox domain, it is fraudulent 3. message id: if a checkpoint message ID differs from the actual message ID (verified by merkle proof) at the checkpoint index, it is fraudulent 4. root: if a checkpoint root differs from the actual root (verified by merkle proof + root reconstruction) at the checkpoint index, it is fraudulent Notably this is implemented independently from signature verification to allow for multiple checkpoint signing schemes to reuse the same checkpoint logic. ### Related issues - Touches https://github.com/hyperlane-xyz/hyperlane-monorepo/issues/3799 - See https://github.com/hyperlane-xyz/hyperlane-monorepo/pull/2431 for previous discussions ### Backward compatibility Yes ### Testing Unit testing with fixtures in `vectors/merkle.json` that are generated by the rust merkle tree and proof code		4 months ago
..
.vscode	[Chore] Fix VSCode formatting and prettier precommit (#501 )	3 years ago
contracts	feat: implement checkpoint fraud proofs (#4277 )	4 months ago
lib	test: XERC20 and XERC20 Lockbox integration tests (#3849 )	6 months ago
script	feat: AVS upgrade for correct reporting on Eigenlayer UI (#4152 )	4 months ago
test	feat: implement checkpoint fraud proofs (#4277 )	4 months ago
.env.example	Merge core and app packages (#1169 )	2 years ago
.gas-snapshot	fix: `testNotOwnerEnrollRouter` (#3670 )	7 months ago
.gitignore	Multisig and Aggregation ISM Metadata Encoding (#3701 )	7 months ago
.solcover.js	v3 Router SDK changes (#2752 )	1 year ago
.solhint.json	feat: support xerc20 and xerc20Lockbox in CLI (#3753 )	6 months ago
.solhintignore	feat: support xerc20 and xerc20Lockbox in CLI (#3753 )	6 months ago
CHANGELOG.md	Version Packages (#4103 )	4 months ago
README.md	chore: update outdated info in Readme files (#3830 )	6 months ago
coverage.sh	test: XERC20 and XERC20 Lockbox integration tests (#3849 )	6 months ago
exportBuildArtifact.sh	Migrate SDK consts to Registry and use new registry utilities (#3615 )	7 months ago
foundry.toml	feat: implement checkpoint fraud proofs (#4277 )	4 months ago
hardhat.config.cts	fix: ignore warnings from fx-portal lib (#3761 )	7 months ago
package.json	Version Packages (#4103 )	4 months ago
remappings.txt	feat: support Arbitrum L2->L1 post dispatch hook (#3853 )	5 months ago
slither.config.json	Fix forge tests post V3 (#2661 )	1 year ago
storage.sh	Add storage layout diff checks (#2991 )	1 year ago
tsconfig.json	Convert packages from CJS to ESM (#3531 )	8 months ago
update_abis.sh	Relayer aggregation ism (#2411 )	1 year ago

README.md

Hyperlane Core

Hyperlane Core contains the contracts and typechain artifacts for the Hyperlane implementation for EVM.

Install

# Install with NPM
npm install @hyperlane-xyz/core

# Or with Yarn
yarn add @hyperlane-xyz/core

Note, this package uses ESM Modules

Build

yarn build

Test

yarn test

Fixtures

Some forge tests may generate fixtures. This allows the SDK tests to leverage forge fuzzing. These are git ignored and should not be committed.

License

Apache 2.0