https://github.com/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.
https://github.com/cosmos/interchain-security

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

Last synced: 4 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/cosmos/interchain-security
• Owner: cosmos
• License: other
• Created: 2021-10-06T14:27:45.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-10-29T12:04:44.000Z (3 months ago)
• Last Synced: 2024-10-29T13:09:46.960Z (3 months ago)
• Topics: blockchain, cosmos-hub, cosmos-sdk, golang, ibc, interchain-security, proof-of-stake, shared-security
• Language: Go
• Homepage: https://cosmos.github.io/interchain-security/
• Size: 155 MB
• Stars: 153
• Watchers: 25
• Forks: 121
• Open Issues: 66
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS
  • Security: SECURITY.md
  • Support: docs/supported_versions.json

Awesome Lists containing this project

• awesome-ccamel - 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)

README

        
# Interchain Security

[![Go Report Card](https://goreportcard.com/badge/github.com/cosmos/interchain-security)](https://goreportcard.com/report/github.com/cosmos/interchain-security)

[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=cosmos_interchain-security&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=cosmos_interchain-security)

[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=cosmos_interchain-security&metric=vulnerabilities)](https://sonarcloud.io/summary/new_code?id=cosmos_interchain-security)

[![Bugs](https://sonarcloud.io/api/project_badges/measure?project=cosmos_interchain-security&metric=bugs)](https://sonarcloud.io/summary/new_code?id=cosmos_interchain-security)

[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=cosmos_interchain-security&metric=ncloc)](https://sonarcloud.io/summary/new_code?id=cosmos_interchain-security)

[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=cosmos_interchain-security&metric=coverage)](https://sonarcloud.io/summary/new_code?id=cosmos_interchain-security)

**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](https://cosmos.github.io/interchain-security/) or [technical specification](https://github.com/cosmos/ibc/blob/main/spec/app/ics-028-cross-chain-validation/README.md).

For a list of **currently active releases**, see [RELEASES.md](./RELEASES.md#version-matrix).

For a list of **major ICS features** available in the currently active releases, see [FEATURES.md](./FEATURES.md).

## Instructions

**Prerequisites**

```bash

## 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**

```bash

# 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](./Makefile) if curious.

## Testing

See [testing docs](./TESTING.md).

## Learn more

- [IBC Docs](https://ibc.cosmos.network/)

- [IBC Protocol](https://ibcprotocol.org/)

- [IBC Specs](https://github.com/cosmos/ibc)

- [Cosmos SDK documentation](https://docs.cosmos.network)

- [Cosmos SDK Tutorials](https://tutorials.cosmos.network)

- [Discord](https://discord.gg/cosmosnetwork)