{"id":35882106,"url":"https://github.com/nibiruchain/nibiru","last_synced_at":"2026-04-24T16:03:24.064Z","repository":{"id":62203960,"uuid":"454511038","full_name":"NibiruChain/nibiru","owner":"NibiruChain","description":"The breakthrough smart contract platform ushering in the next era of money. Nibiru powers an ecosystem of dApps including perps, RWAs, and more.","archived":false,"fork":false,"pushed_at":"2026-03-25T13:41:36.000Z","size":266943,"stargazers_count":207,"open_issues_count":132,"forks_count":229,"subscribers_count":10,"default_branch":"main","last_synced_at":"2026-03-26T16:16:23.541Z","etag":null,"topics":["blockchain","ethereum","golang","nibiru-chain","smart-contracts","wasm"],"latest_commit_sha":null,"homepage":"https://nibiru.fi","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NibiruChain.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"security-reports/2023-05-Nibiru-Salus-Penetration-Testing-Report-V2-脱敏.pdf","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-02-01T18:50:41.000Z","updated_at":"2026-03-07T01:37:19.000Z","dependencies_parsed_at":"2023-09-27T15:41:21.783Z","dependency_job_id":"6f04747e-b325-447f-92be-362ec99d18f2","html_url":"https://github.com/NibiruChain/nibiru","commit_stats":{"total_commits":1269,"total_committers":31,"mean_commits":"40.935483870967744","dds":0.876280535855004,"last_synced_commit":"bbcc6f8c517d0797ff2e10fe15622ebd32895181"},"previous_names":["matrixdao/matrix"],"tags_count":281,"template":false,"template_full_name":null,"purl":"pkg:github/NibiruChain/nibiru","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NibiruChain%2Fnibiru","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NibiruChain%2Fnibiru/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NibiruChain%2Fnibiru/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NibiruChain%2Fnibiru/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NibiruChain","download_url":"https://codeload.github.com/NibiruChain/nibiru/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NibiruChain%2Fnibiru/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32230421,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T13:21:15.438Z","status":"ssl_error","status_checked_at":"2026-04-24T13:21:15.005Z","response_time":64,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blockchain","ethereum","golang","nibiru-chain","smart-contracts","wasm"],"created_at":"2026-01-08T18:05:30.406Z","updated_at":"2026-04-24T16:03:24.058Z","avatar_url":"https://github.com/NibiruChain.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nibiru\n\n[![Go Reference](https://pkg.go.dev/badge/github.com/NibiruChain/nibiru.svg)](https://pkg.go.dev/github.com/NibiruChain/nibiru/v2#section-readme)\n[![Nibiru Test workflow][badge-go-linter]][workflow-go-linter]\n[![Nibiru Test workflow][badge-go-releaser]][workflow-go-releaser]\n[![GitHub][license-badge]](https://github.com/NibiruChain/nibiru/blob/main/LICENSE.md)\n\n**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.\n\n**Table of Contents**:\n\n- [Documentation](#documentation)\n- [Community](#community)\n- [Nibiru Core Architecture](#nibiru-core-architecture)\n  - [Execution Extensions](#execution-extensions)\n  - [Auxiliary Modules](#auxiliary-modules)\n  - [Consensus Engine](#consensus-engine)\n- [Developing in this Codebase](#developing-in-this-codebase)\n  - [Docker Development Environment](#docker-development-environment)\n- [How to Install Nibiru](#how-to-install-nibiru)\n- [License](#license)\n\n---\n\n## Documentation\n\n- [Nibiru Docs (nibiru.fi/docs)](https://nibiru.fi/docs/): This is the best resource for comprehensive technical, conceptual, and product documentation on Nibiru.\n- [Complete Golang reference docs](https://pkg.go.dev/github.com/NibiruChain/nibiru/v2#section-readme): (`pkg.go.dev`) For the blockchain implementation.\n- [Nibiru RPC Endpoints](https://nibiru.fi/docs/dev/networks/)\n- [Core Tools and Language Clients](https://nibiru.fi/docs/dev/#core-tools-and-language-clients)\n\n## Community\n\nIf you have questions or concerns, feel free to connect with a developer or community member in the [Nibiru Discord][social-discord]. We also have active communities on [X][social-twitter] and [Telegram][social-telegram].\n\n\u003cp style=\"display: flex; gap: 24px; justify-content: center; text-align:center\"\u003e\n\u003ca href=\"https://discord.gg/nibirufi\"\u003e\u003cimg src=\"https://img.shields.io/badge/Discord-7289DA?\u0026logo=discord\u0026logoColor=white\" alt=\"Discord\" height=\"22\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://x.com/NibiruChain\"\u003e\u003cimg src=\"https://img.shields.io/badge/Twitter-1DA1F2?\u0026logo=twitter\u0026logoColor=white\" alt=\"Tweet\" height=\"22\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://t.me/nibiruchain\"\u003e\u003cimg src=\"https://img.shields.io/badge/Telegram-2CA5E0?\u0026logo=telegram\u0026logoColor=white\" alt=\"Telegram\" height=\"22\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## Nibiru Core Architecture\n\n### Execution Extensions\n\nThese sections of the codebase extend or augment core runtime behavior.\n\n| Module | Description |\n| --- | --- |\n| [EVM](https://github.com/NibiruChain/nibiru/tree/main/x/evm) | Implements Nibiru EVM, which manages an Ethereum Virtual Machine (EVM) state database and enables the execution of Ethereum smart contracts. Nibiru EVM is an extension of \"[geth](https://github.com/ethereum/go-ethereum)\" along with \"web3\" and \"eth\" JSON-RPC methods. |\n| [Wasm][code-x-wasm]           | Implements the execution environment for WebAssembly (WASM) smart contracts. CosmWasm smart contracts are Rust-based, Wasm smart contracts built for enhanced security, performance, and interoperability. See our [CosmWasm sandbox monorepo (nibiru-wasm)](https://github.com/NibiruChain/nibiru-wasm/tree/main) for the protocol's core smart contracts. |\n| [Eth][code-x-eth]             | Ethereum integration utilities: EVM JSON-RPC server (HTTP/WebSocket) and APIs (eth/net/web3/debug/txpool), EVM transaction indexer for fast lookups, EIP-155 chain IDs, and EIP-712 signing helpers. See also [server][code-app-server] for JSON-RPC bootstrap and config. |\n| [App][code-app]               | Core application logic including custom ante handlers for transaction preprocessing, gas management, signature verification, and EVM integration. Key features include oracle gas optimization, zero-gas actors, and enhanced security guards. |\n| [x/nutil][code-x-nutil]       | Helper and utility functions to be utilized by other `x/` modules. |\n\n### Auxiliary Modules\n\n| Module | Description |\n| --- | --- |\n| [Devgas][code-x-devgas]       | The `devgas` module of Nibiru shares contract execution fees with smart contract developers. This aims to increase the adoption of Nibiru by offering CosmWasm smart contract developers a direct source of income based on usage. |\n| [Epochs][code-x-epochs]       | The `epochs` module allows other modules to set hooks to be called to execute code automatically on a period basis. For example, \"once a week, starting at UTC-time = x\". `epochs` creates a generalized epoch interface.                |\n| [Inflation][code-x-inflation] | Implements the [tokenomics](https://nibiru.fi/docs/learn/tokenomics.html) for Nibiru.                                                                                                                                                    |\n| [Oracle][code-x-oracle]       | Nibiru accurately prices assets using a native, system of decentralized oracles, and communicates with other Cosmos layer-1 chains using the Inter-Blockchain Communication (IBC) protocol. Nibi-Oracle handles the voting process for validators that act as oracles by updating data feeds.  |\n| [Sudo][code-x-sudo]           | Provides an on-chain \"root\" and a set of whitelisted contracts with elevated permissions. Includes management of Zero Gas Actors for fee-less CosmWasm executions against approved contracts. |\n\n[code-x-nutil]: https://github.com/NibiruChain/nibiru/tree/main/x/nutil\n[code-x-devgas]: https://nibiru.fi/docs/dev/x/nibiru-chain/devgas.html\n[code-x-epochs]: https://github.com/NibiruChain/nibiru/tree/main/x/epochs\n[code-x-inflation]: https://github.com/NibiruChain/nibiru/tree/main/x/inflation\n[code-x-oracle]: https://github.com/NibiruChain/nibiru/tree/main/x/oracle\n[code-x-wasm]: https://nibiru.fi/docs/wasm/\n[code-x-evm]: https://github.com/NibiruChain/nibiru/tree/main/x/evm\n[code-x-eth]: https://github.com/NibiruChain/nibiru/tree/main/eth\n[code-app-server]: https://github.com/NibiruChain/nibiru/tree/main/app/server\n[code-app]: https://github.com/NibiruChain/nibiru/tree/main/app\n[code-x-sudo]: https://github.com/NibiruChain/nibiru/tree/main/x/sudo\n\n### Consensus Engine\n\nNibiru is built on [Tendermint Core (CometBFT)](https://tendermint.com/core/) consensus.\n\n\n---\n\n## Developing in this Codebase\n\nInstall `just` to run project-specific commands.\n\n```bash\ncargo install just\n```\n\nNibiru projects use `just` as the command runner instead of `make`. The `just`\ntool is a modern command runner that's simpler, more readable, and\nself-documenting.\n\n```bash\njust            # list all available commands\njust build      # build the nibid binary\njust localnet   # run a local network\njust test-e2e   # run EVM end-to-end tests\n```\n\nRef: [github.com/casey/just](https://github.com/casey/just)\n\n### Docker Development Environment\n\nFor a complete local development environment with multiple services, use our Docker Compose setup that includes:\n\n- **Multiple validator nodes**: Two independent Nibiru Chain nodes for testing multi-node scenarios\n- **Pricefeeder services**: Automated price oracle data feeds\n- **IBC relayer**: Cross-chain communication testing with Hermes relayer\n- **Heart Monitor**: Blockchain indexing and GraphQL API for monitoring\n\nSee [contrib/docker-compose/README.md](./contrib/docker-compose/README.md) for detailed setup instructions and usage examples.\n\n\n## How to Install Nibiru\n\nAssuming you already have Go installed and common tools like `gcc` and `jq`, the\nonly commands you need to run are: \n```bash\njust install  # to build the node software to make a Nibiru binary\njust localnet # to run a local instance of Nibiru as a live network\n```\n\nFor installation instructions from scratch, please see [INSTALL.md](./INSTALL.md).\n\nUsage instructions for the `nibid` CLI are available at [nibiru.fi/docs/dev/cli](https://nibiru.fi/docs/dev/cli) and the [Nibiru Module Reference](https://nibiru.fi/docs/concepts/arch/#modules-%E2%80%94-nibiru).\n\n\u003cdetails\u003e\n\u003csummary\u003e[Recommended minimum specs to run a full node]\u003c/summary\u003e\n\n- 2CPU, 4GB RAM, 100GB SSD\n- Unix system: MacOS or Ubuntu 18+\n\n\u003c/details\u003e\n\n## License\n\nUnless a file notes otherwise, it will fall under the [BSD-2-Clause License](./LICENSE.md).  \n\n[license-badge]: https://img.shields.io/badge/License-BSD--2--Clause-blue\n[badge-go-linter]: https://github.com/NibiruChain/nibiru/actions/workflows/golangci-lint.yml/badge.svg?query=branch%3Amain\n[workflow-go-linter]: https://github.com/NibiruChain/nibiru/actions/workflows/golangci-lint.yml?query=branch%3Amain\n[badge-go-releaser]: https://github.com/NibiruChain/nibiru/actions/workflows/goreleaser.yml/badge.svg?query=branch%3Amain\n[workflow-go-releaser]: https://github.com/NibiruChain/nibiru/actions/workflows/goreleaser.yml?query=branch%3Amain\n[social-twitter]: https://x.com/NibiruChain\n[social-discord]: https://discord.gg/nibirufi\n[social-telegram]: https://t.me/nibiruchain\n[discord-badge]: https://img.shields.io/badge/Discord-7289DA?\u0026logo=discord\u0026logoColor=white\n[twitter-badge]: https://img.shields.io/badge/Twitter-1DA1F2?\u0026logo=twitter\u0026logoColor=white\n[telegram-badge]: https://img.shields.io/badge/Telegram-2CA5E0?\u0026logo=telegram\u0026logoColor=white\n\n\u003c!--\n[![Twitter Follow](https://img.shields.io/twitter/follow/nibiru_platform.svg?label=Follow\u0026style=social)][social-twitter]\n\n[![version](https://img.shields.io/github/tag/nibiru-labs/nibiru.svg)](https://github.com/NibiruChain/nibiru/releases/latest)\n\n[![Go Report Card](https://goreportcard.com/badge/github.com/NibiruChain/nibiru)](https://goreportcard.com/report/github.com/NibiruChain/nibiru)\n\n[![API Reference](https://godoc.org/github.com/NibiruChain/nibiru?status.svg)](https://godoc.org/github.com/NibiruChain/nibiru)\n\n[![Discord Chat](https://img.shields.io/discord/704389840614981673.svg)][social-discord]\n--\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnibiruchain%2Fnibiru","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnibiruchain%2Fnibiru","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnibiruchain%2Fnibiru/lists"}