PacketCrypt implementation in Rust

PacketCrypt mining is made up of 6 distinct components:

• Master - provides work and config files to everyone for a given pool
• Announcement Miner - generates announcements (data which uses bandwidth)
• Announcement Handler - consumes announcements, checks validity and provides to block miner
• Block Miner - uses announcements for for mining blocks
• Block Handler - takes shares from Block Miner and validates them
• Paymaker - takes messages from Block Handler and Announcement Handler to decide which miners the pool should pay

The Master, Announcement Handler, Block Handler, and Paymaker must be operated by the mining pool, the Announcement Miner and Block Miner can be operated by 3rd parties.

This codebase currently provides the Announcement Handler and Announcement Miner components. All of the others can be found in the C PacketCrypt project.

First install rust if you haven't, see: rustup

git clone https://github.com/cjdelisle/packetcrypt_rs
cd packetcrypt_rs
cargo build --release

Step 1: Copy and run the following command

sudo apt-get update && sudo apt install gcc git && sudo apt install curl && curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh && sudo apt install make && mkdir ~/packet && cd ~/packet && git clone https://github.com/cjdelisle/packetcrypt_rs && cd packetcrypt_rs

Step 2: Copy and run the following command

sudo apt install clang

Step 2.5(Optional). If you were using a gcc build then please copy and run the following command

cargo clean

Step 3: Copy and run the following command

CC=clang cargo build --release

• ./target/release/packetcrypt ann <pool url> --paymentaddr <your PKT addr>

For more information ./target/release/packetcrypt help ann

If you're running a pool, you can use the Rust announcement handler as follows:

• ./target/release/packetcrypt ah -C /path/to/pool.toml

See pool.example.toml for information about what should be in your pool.toml file.

For more information ./target/release/packetcrypt help ah

• RUST_LOG=packetcrypt=debug for better logging
• RUST_BACKTRACE=1 for backtraces on errors (including non-critical ones)

To run with memory leak detection, build with cargo build --features leak_detect and while it is running send a SIGUSR1 signal, this will cause it to write out all of it's long lived memory to a file.

You may achieve better performance by building with cargo build --release --features jemalloc

LGPL-2.1 or LGPL-3.0, at your option