2019-12-17 03:44:44 -08:00
<!--
2019-12-10 06:29:46 -08:00
parent:
order: false
2019-12-17 03:44:44 -08:00
-->
2019-12-10 06:29:46 -08:00
2020-05-27 12:04:13 -07:00
< div align = "center" >
< h1 > Cosmos SDK < / h1 >
< / div >
2019-09-03 05:59:24 -07:00
2019-06-30 13:29:05 -07:00
2018-04-02 10:21:34 -07:00
2020-05-27 12:04:13 -07:00
< div align = "center" >
< a href = "https://github.com/cosmos/cosmos-sdk/releases/latest" >
< img alt = "Version" src = "https://img.shields.io/github/tag/cosmos/cosmos-sdk.svg" / >
< / a >
< a href = "https://github.com/cosmos/cosmos-sdk/blob/master/LICENSE" >
< img alt = "License: Apache-2.0" src = "https://img.shields.io/github/license/cosmos/cosmos-sdk.svg" / >
< / a >
< a href = "https://pkg.go.dev/github.com/cosmos/cosmos-sdk?tab=doc" >
2020-06-07 14:08:19 -07:00
< img alt = "GoDoc" src = "https://godoc.org/github.com/cosmos/cosmos-sdk?status.svg" / >
2020-05-27 12:04:13 -07:00
< / a >
< a href = "https://goreportcard.com/report/github.com/cosmos/cosmos-sdk" >
2020-06-07 14:08:19 -07:00
< img alt = "Go report card" src = "https://goreportcard.com/badge/github.com/cosmos/cosmos-sdk" / >
2020-05-27 12:04:13 -07:00
< / a >
< a href = "https://codecov.io/gh/cosmos/cosmos-sdk" >
< img alt = "Code Coverage" src = "https://codecov.io/gh/cosmos/cosmos-sdk/branch/master/graph/badge.svg" / >
< / a >
< / div >
< div align = "center" >
< a href = "https://github.com/cosmos/cosmos-sdk" >
< img alt = "Lines Of Code" src = "https://tokei.rs/b1/github/cosmos/cosmos-sdk" / >
< / a >
< a href = "https://discord.gg/AzefAFd" >
< img alt = "Discord" src = "https://img.shields.io/discord/669268347736686612.svg" / >
2020-06-07 14:08:19 -07:00
< / a >
< a href = "https://sourcegraph.com/github.com/cosmos/cosmos-sdk?badge" >
< img alt = "Imported by" src = "https://sourcegraph.com/github.com/cosmos/cosmos-sdk/-/badge.svg" / >
2020-05-27 12:04:13 -07:00
< / a >
< img alt = "Sims" src = "https://github.com/cosmos/cosmos-sdk/workflows/Sims/badge.svg" / >
< img alt = "Lint Satus" src = "https://github.com/cosmos/cosmos-sdk/workflows/Lint/badge.svg" / >
< / div >
2018-06-16 19:23:06 -07:00
The Cosmos-SDK is a framework for building blockchain applications in Golang.
2019-12-10 06:29:46 -08:00
It is being used to build [`Gaia` ](https://github.com/cosmos/gaia ), the first implementation of the Cosmos Hub.
2018-06-16 19:23:06 -07:00
**WARNING**: The SDK has mostly stabilized, but we are still making some
breaking changes.
2018-04-02 10:21:34 -07:00
2020-09-18 04:08:24 -07:00
**Note**: Requires [Go 1.15+ ](https://golang.org/dl/ )
2018-04-02 10:21:34 -07:00
2018-06-16 19:23:06 -07:00
## Quick Start
2018-04-02 10:21:34 -07:00
2019-12-11 14:58:22 -08:00
To learn how the SDK works from a high-level perspective, go to the [SDK Intro ](./docs/intro/overview.md ).
2018-11-14 11:44:17 -08:00
2019-12-11 14:58:22 -08:00
If you want to get started quickly and learn how to build on top of the SDK, please follow the [SDK Application Tutorial ](https://tutorials.cosmos.network/nameservice/tutorial/00-intro.html ). You can also fork the tutorial's repository to get started building your own Cosmos SDK application.
2018-07-25 22:10:22 -07:00
2019-12-10 06:29:46 -08:00
For more, please go to the [Cosmos SDK Docs ](./docs/ ).
2018-04-13 02:47:46 -07:00
2019-05-21 11:16:55 -07:00
## Cosmos Hub Mainnet
The Cosmos Hub application, `gaia` , has moved to its [own repository ](https://github.com/cosmos/gaia ). Go there to join the Cosmos Hub mainnet and more.
2021-03-04 05:11:34 -08:00
## Interblockchain Communication (IBC)
2021-05-27 08:31:04 -07:00
The IBC module for the SDK has moved to its [own repository ](https://github.com/cosmos/ibc-go ). Go there to build and integrate with the IBC module.
2021-03-04 05:11:34 -08:00
2020-10-21 01:08:20 -07:00
## Starport
2019-12-09 03:32:53 -08:00
2020-10-21 01:08:20 -07:00
If you are starting a new app or a new module you can use [Starport ](https://github.com/tendermint/starport ) to help you get started and speed up development. If you have any questions or find a bug, feel free to open an issue in the repo.
2019-12-09 03:32:53 -08:00
2018-04-13 02:47:46 -07:00
## Disambiguation
This Cosmos-SDK project is not related to the [React-Cosmos ](https://github.com/react-cosmos/react-cosmos ) project (yet). Many thanks to Evan Coury and Ovidiu (@skidding) for this Github organization name. As per our agreement, this disambiguation notice will stay here.
