Practical overview
When it fits
Use Drillx when building a mining workflow in which a client searches for proof-of-work solutions and a smart contract checks submitted proofs and difficulty.
Who it is for
- Rust developers implementing proof-of-work mining clients.
- Solana smart-contract developers who need to verify mining solutions and check their difficulty.
Documented uses
- Search nonces until a Drillx result meets a target difficulty.
- Validate a submitted solution against a challenge.
- Use a verified solution’s difficulty as an input to token rewards.
Requirements & limits
- Drillx is a library, so the mining client and contract workflow must be built around it.
- The documented approach uses Equix and Keccak, with solutions represented by an Equix proof and a 64-bit nonce.
- The repository is public and lists Rust as its primary language.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Search nonces for a Drillx solution
Use the documented Rust example to iterate through nonces and identify a result meeting a target difficulty.
Before you start
- A Rust project using the Drillx library.
- A 32-byte challenge supplied by a program.
- A target difficulty.
Steps
Create SolverMemory for the search.
Iterate through 64-bit nonces and call Drillx hashing with the challenge and each nonce’s little-endian bytes.
Check whether the result difficulty meets the target.
Construct a Solution from the proof and nonce when a qualifying result is found.
Expected outcome
A Drillx solution for the supplied challenge that meets the chosen target difficulty.
Guide limitations
- The example does not document how to obtain the challenge from a live program or how to run a complete mining client.
- The example uses a placeholder challenge and target.
Verify a Drillx solution and difficulty in a contract
Apply the documented checks to a submitted solution.
Before you start
- A Rust smart-contract context that can access the challenge from state.
- A Drillx Solution and a target difficulty.
Steps
Read the challenge from program state.
Check that the solution is valid for the challenge.
Check that the solution hash meets the target difficulty.
Expected outcome
A solution has passed the documented validity and difficulty checks, which can inform a token-reward workflow.
Guide limitations
- The example does not show contract deployment, transaction construction, or reward issuance code.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 18 October 2026
- Original website title
- regolith-labs/drillx · Official homepage title · retained in its source language