cosmos/interchain-security

Interchain Security is an open sourced IBC application which allows cosmos blockchains to lease their proof-of-stake security to one another.

Go

194

1,158 commits

updated Sep 28, 2026

See the code

README

Interchain Security

Go Report Card

interchain-security contains a working and in-production implementation of the Interchain Security (ICS) protocol. ICS is an open sourced IBC application which allows cosmos blockchains to lease their proof-of-stake security to one another.

For more details on the Interchain Security protocol, take a look at the docs or technical specification.

For a list of currently active releases, see RELEASES.md.

For a list of major ICS features available in the currently active releases, see FEATURES.md.

Instructions

Prerequisites

## For OSX or Linux

# go 1.21 (https://formulae.brew.sh/formula/go)
brew install [email protected]
# jq (optional, for testnet) (https://formulae.brew.sh/formula/jq)
brew install jq
# docker (optional, for integration tests, testnet) (https://docs.docker.com/get-docker/)

Installing and running binaries

# install interchain-security-pd and interchain-security-cd binaries
make install
# run provider
interchain-security-pd
# run consumer
interchain-security-cd
# (if the above fail, ensure ~/go/bin on $PATH)
export PATH=$PATH:$(go env GOPATH)/bin

Inspect the Makefile if curious.

Testing

See testing docs.

Learn more

blockchain
cosmos-hub
cosmos-sdk
golang
ibc
interchain-security
proof-of-stake
shared-security

cosmos/interchain-security

Interchain Security is an open sourced IBC application which allows cosmos blockchains to lease their proof-of-stake security to one another.

Go

194

1,158 commits

updated Sep 28, 2026

See the code

README

Interchain Security

Go Report Card

interchain-security contains a working and in-production implementation of the Interchain Security (ICS) protocol. ICS is an open sourced IBC application which allows cosmos blockchains to lease their proof-of-stake security to one another.

For more details on the Interchain Security protocol, take a look at the docs or technical specification.

For a list of currently active releases, see RELEASES.md.

For a list of major ICS features available in the currently active releases, see FEATURES.md.

Instructions

Prerequisites

## For OSX or Linux

# go 1.21 (https://formulae.brew.sh/formula/go)
brew install [email protected]
# jq (optional, for testnet) (https://formulae.brew.sh/formula/jq)
brew install jq
# docker (optional, for integration tests, testnet) (https://docs.docker.com/get-docker/)

Installing and running binaries

# install interchain-security-pd and interchain-security-cd binaries
make install
# run provider
interchain-security-pd
# run consumer
interchain-security-cd
# (if the above fail, ensure ~/go/bin on $PATH)
export PATH=$PATH:$(go env GOPATH)/bin

Inspect the Makefile if curious.

Testing

See testing docs.

Learn more

blockchain
cosmos-hub
cosmos-sdk
golang
ibc
interchain-security
proof-of-stake
shared-security

Project health

Latest release

v1.2.1 · Apr 25, 2023

Releases this year

0
2 known vulnerabilities

Significant stargazers

Soares Chen

172 followers · starred Apr 2022

Federico Kunze Küllmer

279 followers · starred Jan 2022

colin axnér

64 followers · starred Oct 2021

pratikbin

70 followers · starred Nov 2022