# Gno
[](LICENSE.md)
[](https://gnolang.github.io/gno/github.com/gnolang/gno.html)
> At first, there was Bitcoin, out of entropy soup of the greater All.
> Then, there was Ethereum, which was created in the likeness of Bitcoin,
> but made Turing complete.
>
> Among these were Tendermint and Cosmos to engineer robust PoS and IBC.
> Then came Gno upon Cosmos and there spring forth Gnoland,
> simulated by the Gnomes of the Greater Resistance.
**Gno is a blockchain platform that interprets a deterministic variant of Go
for writing smart contracts, built on Tendermint consensus.**
Gno is an interpreted and fully-deterministic implementation of the Go
programming language, designed to build succinct and composable smart contracts.
The first blockchain to use it is gno.land, a contribution-based chain, backed
by a variation of the [Tendermint](./tm2) consensus engine.
PLEASE NOTE: This is NOT the same project or token as the excellent Gnosis.io project.
## Getting Started
Explore Gno through our comprehensive documentation:
- **[For Users](./docs#use-gnoland)** - Learn how to use Gno applications,
manage accounts, and interact with the blockchain
- **[For Builders](./docs#build-on-gnoland)** - Start writing smart contracts,
understand the Gno language, and deploy your applications
- **[References](./docs#references)** - Technical specifications, best
practices, and advanced topics
- **[Running a node](./docs/builders/running-a-node.md)** - Start here if you were
about to run one — most use cases don't need it
Visit [gno.land](https://gno.land) to see live smart contracts in action.
## Networks
gno.land **mainnet** has been live since 12 September 2026 — chain id `gnoland-1`,
RPC `https://rpc.gno.land:443`. It launched as a fresh chain rather than a fork of
betanet, and there is no mainnet faucet.
To build and deploy for free, use a testnet. Testnets are renamed and replaced
regularly, so rather than naming one here:
[Gno networks](https://docs.gno.land/resources/gnoland-networks) always lists the
current one, its RPC endpoint, and the archives of past networks. Tokens come from
the [faucet](https://faucet.gno.land).
## Key Features
- **Go Syntax**: If you know Go, you know Gno
- **Deterministic Execution**: Fully predictable contract behavior
- **Composable Packages**: Import and reuse code like regular Go
- **Auto-Persisted State**: Global variables automatically saved between calls
- **Contribution System**: Rewarding open source contributors
- **Developer Experience**: Comprehensive tooling including testing,
debugging, and hot-reload development
## Documentation
- [Documentation](./docs/) - Complete documentation portal
- [Examples](./examples) - Sample contracts and patterns
- [Go API Reference](https://gnolang.github.io/gno/github.com/gnolang/gno.html) -
Go package documentation
## Gno Playground
[Gno Playground](https://play.gno.land), available at
[play.gno.land](https://play.gno.land), is a web app that allows users to
write, share, and deploy Gno code. Developers can seamlessly test, debug, and
deploy realms and packages on gno.land, while being able to collaborate with
peers to work on projects together and seek assistance. A key feature of Gno
Playground is the ability to get started without the need to install any tools
or manage any services, offering immediate access and convenience for users.
**Note:** The playground may not always reflect the latest changes in this
repository.
## Repository Structure
* [docs](./docs) - Official documentation
* [examples](./examples) - Smart contract examples and guides
* [gnovm](./gnovm) - GnoVM and the Gno language
* [gno.land](./gno.land) - Blockchain node and tools
* [tm2](./tm2) - Tendermint2 consensus engine
* [contribs](./contribs) - Additional tools and utilities
* [misc](./misc) - Various utilities and scripts
## Community
**Explore the Ecosystem:**
- [Gnoverse](https://github.com/gnoverse) - Community projects and initiatives
- [Awesome Gno](https://github.com/gnoverse/awesome-gno) - Curated list of
resources
- [Gnoscan](https://gnoscan.io) - Blockchain explorer
- [Gno Studio](https://gno.studio) - Web IDE for Gno development
- [Contributor guide](./docs/builders/contributor-guide.md) - Join the contributor
community
**Connect & Get Help:**
- [Discord](https://discord.com/invite/gnoland) - Real-time support and development
discussions
- [X](https://x.com/_gnoland) - Official announcements and updates
- [YouTube](https://www.youtube.com/@_gnoland) - Tutorials, workshops, and
development calls
- [Workshops](https://github.com/gnolang/workshops) - Educational materials
- [Reddit](https://www.reddit.com/r/gnoland) - Forum-style discussions
- [Telegram](https://t.me/gnoland) - Community-run group
**Contribute:**
- [GitHub Issues](https://github.com/gnolang/gno/issues) - Report bugs and
request features
- [Contributing Guide](./CONTRIBUTING.md) - Guidelines for contributors
CI/CD/Tools badges and links
GitHub Actions:
* [](https://github.com/gnolang/gno/actions/workflows/ci-dir-gnoland.yml)
* [](https://github.com/gnolang/gno/actions/workflows/ci-dir-gnovm.yml)
* [](https://github.com/gnolang/gno/actions/workflows/ci-dir-tm2.yml)
* [](https://github.com/gnolang/gno/actions/workflows/ci-dir-examples.yml)
* [](https://github.com/gnolang/gno/actions/workflows/release-docker.yml)
Go Report Card:
* [](https://goreportcard.com/report/github.com/gnolang/gno)
* tm2, gnovm, gno.land: TODO (blocked by tm2 split, because we need go mod workspaces)
Pkg.go.dev
* [](https://gnolang.github.io/gno/github.com/gnolang/gno.html) \
(pkg.go.dev will not show our repository as it has a license it doesn't recognise)