nico
04160a83dd
|
2 months ago | |
---|---|---|
.husky | 2 months ago | |
.yarn | 2 months ago | |
rust | 2 months ago | |
solidity | 2 months ago | |
tools/grafana | 2 months ago | |
typescript | 2 months ago | |
vectors | 2 months ago | |
.dockerignore | 2 months ago | |
.eslintignore | 2 months ago | |
.eslintrc | 2 months ago | |
.gitignore | 2 months ago | |
.gitmodules | 2 months ago | |
.lintstagedrc | 2 months ago | |
.prettierignore | 2 months ago | |
.prettierrc | 2 months ago | |
.yarnrc.yml | 2 months ago | |
CODE_OF_CONDUCT.md | 2 months ago | |
CONTRIBUTING.md | 2 months ago | |
DISCLAIMER.md | 2 months ago | |
Dockerfile | 2 months ago | |
LICENSE.md | 2 months ago | |
README.md | 2 months ago | |
mono.code-workspace | 2 months ago | |
package.json | 2 months ago | |
rust-toolchain | 2 months ago | |
tsconfig.json | 2 months ago | |
yarn.lock | 2 months ago |
README.md
Hyperlane
Versioning
Note this is the branch for Hyperlane v2.
V1 has since been deprecated in favor of V2, but if you are looking for code relating to the existing V1 deployments of the testnet2
or mainnet
environments, refer to the v1 branch.
Overview
Hyperlane is an interchain messaging protocol that allows applications to communicate between blockchains.
Developers can use Hyperlane to share state between blockchains, allowing them to build interchain applications that live natively across multiple chains.
To read more about interchain applications, how the protocol works, and how to integrate with Hyperlane, please see the documentation.
Working on Hyperlane
Workspaces
This monorepo uses Yarn Workspaces. Installing dependencies, building, testing, and running prettier for all packages can be done from the root directory of the repository.
-
Installing dependencies
yarn install
-
Building
yarn build
If you are using VSCode, you can launch the multi-root workspace with code mono.code-workspace
, install the recommended workspace extensions, and use the editor settings.
Rust
See rust/README.md
Publishing JS/TS Packages
Packages can be versioned and published all at once with commands from the root.
First, increment the version to the desired value:
# An example of a prerelease version
yarn version:prepare 1.1.0-beta0
# Or a release version
yarn version:prepare 1.1.0
Commit this preparation so that it is clear which commit the release is from.
Next, ensure packages are cleaned and rebuilt:
yarn clean && yarn build
Finally, publish the packages to NPM
# Note: If you have not yet logged in, first run yarn npm login
yarn publish:all --otp YOUR_OTP_HERE
# Or for a pre-release, include the tag
yarn publish:all --otp YOUR_OTP_HERE --tag beta
Tag the commit with the appropriate version, and then create a github release with a changelog against the previous version https://github.com/hyperlane-xyz/hyperlane-monorepo/releases/new
Release Agents
- Tag the commit with the current date in the format
agents-yyyy-mm-dd
; e.g.agents-2023-03-28
. - Create a Github Release with a changelog against the previous version titled
Agents MMMM DD, YYYY
, e.g.Agents March 28, 2023
. - Include the agent docker image tag in the description of the release
- Create a summary of change highlights
- Create a "breaking changes" section with any changes required
- Deploy agents with the new image tag (if it makes sense to)