nibiru

Nibiru

Nibiru is a breakthrough Layer 1 blockchain and smart contract ecosystem providing superior throughput, improved security, and a high-performance EVM execution layer. Nibiru aims to be the most developer-friendly and user-friendly smart contract ecosystem, leading the charge toward mainstream Web3 adoption by innovating at each layer of the stack: dApp development, scalable blockchain data indexing, consensus optimizations, a comprehensive developer toolkit, and composability across multiple VMs.

Table of Contents:

• Documentation
• Community
• Nibiru Core Architecture
  • Execution Extensions
  • Auxiliary Modules
  • Consensus Engine
• Developing in this Codebase
  • Docker Development Environment
• How to Install Nibiru
• License

Documentation

• Nibiru Docs (nibiru.fi/docs): This is the best resource for comprehensive technical, conceptual, and product documentation on Nibiru.
• Complete Golang reference docs: (pkg.go.dev) For the blockchain implementation.
• Nibiru RPC Endpoints
• Core Tools and Language Clients

Community

If you have questions or concerns, feel free to connect with a developer or community member in the Nibiru Discord. We also have active communities on X and Telegram.

Nibiru Core Architecture

Execution Extensions

These sections of the codebase extend or augment core runtime behavior.

Auxiliary Modules

Consensus Engine

Nibiru is built on Tendermint Core (CometBFT) consensus.

Developing in this Codebase

Install just to run project-specific commands.

cargo install just

Nibiru projects use just as the command runner instead of make. The just tool is a modern command runner that's simpler, more readable, and self-documenting.

just            # list all available commands
just build      # build the nibid binary
just localnet   # run a local network
just test-e2e   # run EVM end-to-end tests

Ref: github.com/casey/just

Docker Development Environment

For a complete local development environment with multiple services, use our Docker Compose setup that includes:

• Multiple validator nodes: Two independent Nibiru Chain nodes for testing multi-node scenarios
• Pricefeeder services: Automated price oracle data feeds
• IBC relayer: Cross-chain communication testing with Hermes relayer
• Heart Monitor: Blockchain indexing and GraphQL API for monitoring

See contrib/docker-compose/README.md for detailed setup instructions and usage examples.

How to Install Nibiru

Assuming you already have Go installed and common tools like gcc and jq, the only commands you need to run are:

just install  # to build the node software to make a Nibiru binary
just localnet # to run a local instance of Nibiru as a live network

For installation instructions from scratch, please see INSTALL.md.

Usage instructions for the nibid CLI are available at nibiru.fi/docs/dev/cli and the Nibiru Module Reference.

License

Unless a file notes otherwise, it will fall under the BSD-2-Clause License.