The home for Hyperlane core contracts, sdk packages, and other infrastructure
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
hyperlane-monorepo/typescript/sdk
Lee eb23e77296
feat: Create EvmCoreModule with create() (#3737)
6 months ago
..
logos Implement WarpCore and Token classes (#3272) 9 months ago
scripts Replace Fallback/Retry providers with SmartProvider (#3032) 12 months ago
src feat: Create EvmCoreModule with create() (#3737) 6 months ago
.eslintrc Graduate to yarn 4 🧶 (#2899) 1 year ago
.gitignore Update sdk gitignore 2 years ago
.mocharc.json Convert packages from CJS to ESM (#3531) 8 months ago
.npmignore Remove abacus- prefix from directories (#267) 3 years ago
CHANGELOG.md chore: Merge branch 'main' into noah/cli-2.0 (#3809) 7 months ago
README.md Convert packages from CJS to ESM (#3531) 8 months ago
hardhat.config.cts Convert packages from CJS to ESM (#3531) 8 months ago
package.json chore: Merge branch 'main' into noah/cli-2.0 (#3809) 7 months ago
tsconfig.json Convert packages from CJS to ESM (#3531) 8 months ago

README.md

Hyperlane SDK

The Hyperlane SDK helps developers create and manage interchain applications.

For more details on Hyperlane concepts, see the documentation

Install

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

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

Note, this package uses ESM Modules

Contents

Constants

The names and relevant metadata for all Hyperlane-supported chains are included in this SDK, including public RPC and Explorer urls. It also includes the addresses for all Hyperlane core contracts and middleware.

Classes for development, deployment, and testing

The SDK includes various classes for building, deploying, and testing multi-chain applications. Different abstractions serve different use cases. A few common utilities include:

  • MultiProvider / MultiProtocolProvider: A utility for managing chain metadata, and RPC providers.
  • HyperlaneApp / MultiProtocolApp: A base to extend for a multi-chain app.
  • HyperlaneCore / MultiProtocolCore: A class for common interactions with Hyperlane core deployments.
  • HyperlaneDeployer: The base class for executing multi-chain contract deployments.
  • Token & WarpCore: Utilities for interacting with Warp Route deployments.

Chain Logos

The SDK contains SVG files for all Hyperlane-supported chains. They can be imported from the /logos folder.

import ArbitrumBlack from '@hyperlane-xyz/sdk/logos/black/arbitrum.svg';
import ArbitrumColor from '@hyperlane-xyz/sdk/logos/color/arbitrum.svg';

License

Apache 2.0