Skip to content

Latest commit

 

History

History
160 lines (119 loc) · 6.59 KB

readme.md

File metadata and controls

160 lines (119 loc) · 6.59 KB

Ignite CLI

Ignite CLI

Ignite CLI is the all-in-one platform to build, launch, and maintain any crypto application on a sovereign and secured blockchain. It is a developer-friendly interface to the Cosmos SDK, the world's most widely-used blockchain application framework. Ignite CLI generates boilerplate code for you, so you can focus on writing business logic.

Quick start

Open Ignite CLI in your web browser (or open nightly version), or install the latest release.

To create and start a blockchain:

ignite scaffold chain mars

cd mars

ignite chain serve

Documentation

To learn how to use Ignite CLI, check out the Ignite CLI docs. To learn more about how to build blockchain apps with Ignite CLI, see the Ignite CLI Developer Tutorials.

To install Ignite CLI locally on GNU, Linux, or macOS, see Install Ignite CLI.

To learn more about building a JavaScript frontend for your Cosmos SDK blockchain, see ignite/web.

Questions

For questions and support, join the official Ignite Discord server. The issue list in this repo is exclusively for bug reports and feature requests.

Cosmos SDK compatibility

Blockchains created with Ignite CLI use the Cosmos SDK framework. To ensure the best possible experience, use the version of Ignite CLI that corresponds to the version of Cosmos SDK that your blockchain is built with. Unless noted otherwise, a row refers to a minor version and all associated patch versions.

Ignite CLI Cosmos SDK IBC Notes
v0.25.2 v0.46.6 v5.1.0 Bump Tendermint version to v0.34.24
v0.25.1 v0.46.3 v5.0.0 Includes Dragonberry security fix
v0.24.0 v0.46.0 v5.0.0 This version is deprecated due to a security fix in v0.25.0
v0.23.0 v0.45.5 v3.0.1
v0.21.1 v0.45.4 v2.0.3 Supports Cosmos SDK v0.46.0-alpha1 and above
v0.21.0 v0.45.4 v2.0.3
v0.20.0 v0.45.3 v2.0.3
v0.19 v0.44 v1.2.2
v0.18 v0.44 v1.2.2 ignite chain serve works with v0.44.x chains
v0.17 v0.42 Same with Cosmos SDK

To upgrade your blockchain to the newer version of Cosmos SDK, see the Migration guide.

Plugin system

Ignite CLI commands can be extended using plugins. A plugin is a program that uses github.com/hashicorp/go-plugin to communicate with the ignite binary.

Use a plugin

Plugins must be declared in the config.yml file, using the following syntax:

plugins:
  // path can be a repository or a local path
  // the directory must contain go code under a main package.
  // For repositories you can specify a suffix @branch or @tag to target a
  // specific git reference.
  - path: github.com/org/repo/my-plugin
    // Additional parameters can be passed to the plugin
    with:
      key: value

Once declared, the next time the ignite binary will be executed under this configuration, it will fetch, build and run the plugin. As a result, more commands should be available in the list of the ignite commands.

ignite plugin command allows to list the plugins and their status, and to update a plugin if you need to get the latest version.

Make a plugin

A plugin must implement plugin.Interface.

The easiest way to make a plugin is to use the ignite plugin scaffold command. For example:

$ cd /home/user/src
$ ignite plugin scaffold github.com/foo/bar

It will create a folder bar under /home/user/src and generate predefined go.mod and main.go. The code contains everything required to connect to the ignite binary via hashicorp/go-plugin. What need to be adapted is the implementation of the plugin.Interface (Commands and Execute methods).

To test your plugin, you only need to declare it under a chain config, for instance:

plugins:
  - path: /home/user/src/bar

Then run ignite, the plugin will compile and should be listed among the ignite commands. Each time ignite is executed, the plugin is recompiled if the files have changed since the last compilation. This allows fast and easy plugin development, you only care about code and ignite handles the compilation.

Contributing

We welcome contributions from everyone. The main branch contains the development version of the code. You can create a branch from main and create a pull request, or maintain your own fork and submit a cross-repository pull request.

Our Ignite CLI bounty program provides incentives for your participation and pays rewards. Track new, in-progress, and completed bounties on the Bounty board in GitHub.

Important Before you start implementing a new Ignite CLI feature, the first step is to create an issue on GitHub that describes the proposed changes.

If you're not sure where to start, check out contributing.md for our guidelines and policies for how we develop Ignite CLI. Thank you to everyone who has contributed to Ignite CLI!

Community

Ignite CLI is a free and open source product maintained by Ignite. Here's where you can find us. Stay in touch.