OpenViSTAI · Agents · Blockchain · Crypto
Submit a project
Menu
Mining

Mithril — Ragnaroek

Mithril is an open-source Rust command-line application for mining Monero. Its repository documents Stratum support for pooled mining, automatic thread tuning, and optional hash-rate logging. The project aims for a pure-Rust miner, though its README says Skein and JH use C bindings.

Explore the practical guide ↓

Independent OpenViST project profile, based on linked sources.

Mithril — Ragnaroek — OpenViST project profile in Mining.
OpenViST project illustration. See the linked sources for product details.
Understand the project

Practical overview

When it fits

Use Mithril when you want a self-built command-line Monero miner and are comfortable editing its TOML configuration. Its documented logging and tuning options can support local performance evaluation.

Who it is for

  • People who want to build and configure a Monero miner from source.
  • Miners who want automatic thread tuning or to record hash-count samples for performance analysis.

Documented uses

  • Build an optimized Mithril binary with Rust nightly.
  • Configure a Monero address and thread settings for mining.
  • Tune thread counts automatically or set them manually.
  • Write timestamped hash counts to a CSV file for later analysis.
Before you choose

Requirements & limits

The repository is public and identifies the project as GPL-3.0 licensed.

  • Building requires Rust nightly because the project uses inline assembly.
  • The README lists macOS 10.13/x64, Windows/x64 and CentOS 7 64-bit Linux as tested platform combinations.
  • The default configuration disables hash-rate logging.
  • The README says RandomX interpreter mode was implemented but still needed more testing in its status entry.
  • The stated pure-Rust goal is incomplete: Skein and JH use C foreign-function bindings according to the README.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Build and configure Mithril

Prepare the optimized miner binary and its required Monero configuration.

Before you start

  • Rust nightly, installed with rustup as suggested by the README.
  • A Monero address to enter in the pool configuration.

Steps

  1. Build from the repository using the command below.

    Documented command
    cargo build --release

  2. Copy default_config.toml to config.toml in the Mithril working directory.

  3. Set the Monero address in the [pool] section and configure num_threads for the machine.

  4. Use the binary in the target/release/ directory.

Expected outcome

An optimized binary and a configuration file with the required pool address and thread setting.

Guide limitations

  • Rust nightly is required because the project uses inline assembly.
  • The README lists tested platforms as macOS 10.13/x64, Windows/x64 and CentOS 7 64-bit Linux.
  • The instructions do not specify pool endpoints or a command for starting the miner.
Documentation 1 ↗
Source-based practical guide

Enable hash-rate logging

Configure Mithril to append hash-count samples to a CSV file.

Before you start

  • A Mithril working directory containing config.toml.
  • A writable path for the CSV report file.

Steps

  1. Enable logging in the [metric] section of config.toml.

  2. Set report_file to the desired CSV path.

  3. Choose sample_interval_seconds and resolution for sampling.

Expected outcome

Mithril appends timestamped hash counts to the configured CSV file at the selected sample interval.

Guide limitations

  • Hash-rate logging is disabled in the default configuration.
  • The README warns that a lower resolution increases measurement overhead.
  • The README describes calculating averages with external tools.
Documentation 1 ↗
Evidence and transparency

Sources & review

Official repository ↗
Source record details
Source availability
Active
Sources checked
6 October 2026
Original website title
Ragnaroek/mithril · Official homepage title · retained in its source language
How we review sourcesSuggest a correction