{"id":19461679,"url":"https://github.com/plasmapower/meroxidizer","last_synced_at":"2025-04-25T07:34:21.688Z","repository":{"id":74955952,"uuid":"320447665","full_name":"PlasmaPower/meroxidizer","owner":"PlasmaPower","description":"A Meros Miner in Rust","archived":false,"fork":false,"pushed_at":"2021-01-17T01:39:04.000Z","size":59,"stargazers_count":6,"open_issues_count":1,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2023-10-20T22:24:26.417Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PlasmaPower.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2020-12-11T02:41:20.000Z","updated_at":"2023-02-03T08:48:42.000Z","dependencies_parsed_at":null,"dependency_job_id":"2ace7282-9042-44b2-b348-90e0c94438c3","html_url":"https://github.com/PlasmaPower/meroxidizer","commit_stats":null,"previous_names":[],"tags_count":0,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PlasmaPower%2Fmeroxidizer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PlasmaPower%2Fmeroxidizer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PlasmaPower%2Fmeroxidizer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PlasmaPower%2Fmeroxidizer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PlasmaPower","download_url":"https://codeload.github.com/PlasmaPower/meroxidizer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223991344,"owners_count":17237476,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-11-10T17:43:19.938Z","updated_at":"2024-11-10T17:43:20.614Z","avatar_url":"https://github.com/PlasmaPower.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Meroxidizer: A Meros Miner in Rust\n\n## Building\n\nMake sure you have git submodules checked out:\n```\ngit submodule update --init\n```\n\nInstall rust via https://rustup.rs/\n\nYou'll also need to install Clang\n\n### To run once\n\n```\nRUST_LOG=info cargo run --release -- [options]\n```\n\n### To install\n\n```\ncargo install --path .\nRUST_LOG=info meroxidizer [options]\n```\n\nNote that you must specify thread counts, see the next section for details.\n\n## Options\n\n```\nmeroxidizer 0.1.0\n\nUSAGE:\n    meroxidizer [FLAGS] [OPTIONS] --bls-threads \u003cbls-threads\u003e --randomx-init-threads \u003crandomx-init-threads\u003e --randomx-threads \u003crandomx-threads\u003e\n\nFLAGS:\n    -h, --help                      Prints help information\n    -o, --output-hash-rate          If the hash rate should be logged every 30 seconds\n    -l, --randomx-large-pages       If large pages should be used for RandomX. Requires special configuration at the OS\n                                    level\n    -k, --randomx-stop-for-rekey    If mining should stop when the RandomX key changes. Advantage: doesn't double memory\n                                    usage during RandomX key changes. Disadvantage: stops mining for a few seconds every\n                                    other day. But mining would only progress on the old key anyways, which would be\n                                    useless. This is a target for future improvement\n    -V, --version                   Prints version information\n\nOPTIONS:\n    -b, --bls-threads \u003cbls-threads\u003e                      The number of threads to use for BLS signing\n    -i, --randomx-init-threads \u003crandomx-init-threads\u003e\n            The number of threads to use to initialize RandomX. Only matters on startup and on RandomX key change\n\n    -t, --randomx-threads \u003crandomx-threads\u003e              The number of threads to use for RandomX. Must be even\n    -r, --rpc \u003crpc\u003e                                      The RPC address and port [default: localhost:5133]\n```\n\nThis also accepts the following env variables:\n- **RUST_LOG**: Set the logging level, see [env_logger documentation](https://docs.rs/env_logger/latest/env_logger/index.html) for details.\n- **MEROS_MINER_KEY**: Set the Meros miner private key.\n  **Warning**: the node is still somewhat trusted,\n  so don't use this to run against an untrusted node.\n  This is still useful if you want to run miners with multiple nodes,\n  as having the same key on the nodes would cause a merit removal\n  and destroy your merit.\n\n## Example Invocation\n\nI've split this command into multiple lines for readability,\nbut to actually run this you'd need to remove the comments\nand merge it into one line.\n\n```sh\nRUST_LOG=info # Enable reasonable logging\ncargo run --release -- # Compile and run\n-r localhost:5133 # Connect to the Meros node at localhost:5133\n-b 10 # Use 10 threads for BLS signing\n-i 32 # Use 32 threads to initialize RandomX\n-t 26 # Use 26 threads to run RandomX\n-l # Enable RandomX large pages\n-k # Pause mining during RandomX key rotation\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplasmapower%2Fmeroxidizer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fplasmapower%2Fmeroxidizer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplasmapower%2Fmeroxidizer/lists"}