README
¶
Gno
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 consensus engine.
Getting Started
Explore Gno through our comprehensive documentation:
- For Users - Learn how to use Gno applications, manage accounts, and interact with the blockchain
- For Builders - Start writing smart contracts, understand the Gno language, and deploy your applications
- Resources - Technical specifications, best practices, and advanced topics
Visit gno.land to see live smart contracts in action.
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 - Complete documentation portal
- Examples - Sample contracts and patterns
- Go API Reference - Go package documentation
Gno Playground
Gno Playground, available at 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 - Official documentation
- examples - Smart contract examples and guides
- gnovm - GnoVM and the Gno language
- gno.land - Blockchain node and tools
- tm2 - Tendermint2 consensus engine
- contribs - Additional tools and utilities
- misc - Various utilities and scripts
Community
Explore the Ecosystem:
- Gnoverse - Community projects and initiatives
- Awesome Gno - Curated list of resources
- Gnoscan - Blockchain explorer
- Gno Studio - Web IDE for Gno development
- Become a Gnome - Join the contributor community
Connect & Get Help:
- Discord - Real-time support and development discussions
- Twitter - Official announcements and updates
- YouTube - Tutorials, workshops, and development calls
- Workshops - Educational materials
- Reddit - Forum-style discussions
- Telegram - Community-run group
Contribute:
- GitHub Issues - Report bugs and request features
- Contributing Guide - Guidelines for contributors
CI/CD/Tools badges and links
GitHub Actions:
Codecov:
- General:
- tm2:
- gnovm:
- gno.land:
- examples: TODO
Go Report Card:
- tm2, gnovm, gno.land: TODO (blocked by tm2 split, because we need go mod workspaces)
Pkg.go.dev
(pkg.go.dev will not show our repository as it has a license it doesn't recognise)
Documentation
¶
Overview ¶
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.
| __ __ | ___ ____ ___ / /__ ____ ___/ / | / _ `/ _ \/ _ \_ / / _ `/ _ \/ _ / | \_, /_//_/\___(_)_/\_,_/_//_/\_,_/ | /___/
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
github-bot
command
|
|
|
gnodev/cmd/gnobro
command
|
|
|
gnodev/cmd/gnodev
command
|
|
|
gnofaucet
command
|
|
|
gnogenesis
command
|
|
|
gnohealth
command
|
|
|
gnokeykc
command
|
|
|
gnomd
command
|
|
|
gnomigrate
command
|
|
|
tx-archive/cmd
command
|
|
|
cmd/gnokey
command
|
|
|
cmd/gnoland
command
|
|
|
cmd/gnoweb
command
|
|
|
pkg/gnoweb/tools/cmd/logname
command
|
|
|
pkg/integration/process
command
|
|
|
cmd/benchops
command
|
|
|
cmd/gno
command
|
|
|
autocounterd/cmd
command
|
|
|
docs/tools/indexparser
command
|
|
|
docs/tools/linter
command
|
|
|
genproto
command
|
|
|
genstd
command
|
|
|
goscan
command
|
|
|
loop/cmd
command
|
|
|
stdlib_diff
command
|
|
|
pkg/amino/cmd/aminoscan
command
|
|
|
pkg/amino/cmd/goscan
command
|
|
|
pkg/amino/genproto/example
command
|
|
|
pkg/amino/tests/cmd
command
|
|
|
pkg/amino/tests/fuzz/json/debug
command
|
|
|
pkg/autofile/cmd
command
|
|
|
pkg/colors/cmd/modcolor
command
|
|
|
pkg/iavl/cmd/iaviewer
command
|
|