Mujina

Appearance

Community and Contributing ​

Mujina is a 256 Foundation project, built in the open by software and hardware engineers, protocol authors, and mining operators. Everything happens in public channels, and every channel welcomes newcomers.

Where things happen ​

  • GitHub: the source, issues, and pull requests.
  • GitHub Discussions: questions, ideas, and bug triage. Start here if you are not sure where something belongs.
  • The 256 Foundation forum: longer-form threads across the Foundation's projects, including Mujina.
  • Telegram: real-time chat with the 256 Foundation community.
  • Dev calls: regular calls where contributors coordinate, open to anyone who wants to join. Records and agendas are posted in the Dev Calls discussion category, so you can follow along or catch up without attending.

Contributing code ​

The project needs more skills than Rust. Board bring-up needs embedded and hardware people, ideally with the board in hand; most ASIC protocol work needs reverse engineers; the docs and this site need writers; and every driver needs testers with hardware. You don't need an ASIC to start: the CPU backend runs the whole system on any Linux machine, and the tutorial takes about fifteen minutes.

The contribution guide is the canonical reference for process and requirements: how to report a bug, propose a feature, and get a pull request merged. In short:

  • Found a bug? Search existing issues and discussions first, then open an Issue Triage discussion.
  • Have an idea? Open a discussion in the Ideas category before writing code.
  • Want to dive in? Every open issue is ready to work on. Issues tagged good first issue suit newcomers.

Design proposals ​

Substantial design work is recorded as a MIP, a Mujina Improvement Proposal, modeled on Bitcoin's BIPs. MIPs live in the mujina-mips repository. Most ideas start and stay as discussions; an idea becomes a MIP when it needs a written, editable design document.

Contributing to this site ​

This site lives in its own repository and takes pull requests like any other project; its contributing guide covers the workflow. Every page ends with an edit link that opens a pull request from your browser. The compatibility matrix especially depends on the community: if you maintain a fork or a board driver, its row is yours to keep accurate.

Supporting this work ​

Mujina is run and funded by the 256 Foundation, which builds open tools for Bitcoin mining across the whole stack: open hashboard and control board hardware, and this firmware to run them. Mujina takes no donations of its own; to support the work, support the Foundation.

License ​

Mujina is licensed under the GNU General Public License v3.0 or later.