High-performance CUDA GPU miner for the TETSUO blockchain. Supports multi-GPU mining with automatic work distribution.

Links: Website | Node | Wallet SDK

• Multi-GPU Support: Automatically uses all available GPUs with optimized work distribution
• SHA256d Mining: Optimized double SHA256 implementation for proof-of-work
• Custom Coinbase: Mine directly to your wallet address
• Modern CUDA: Supports Ampere, Ada/Lovelace, Hopper, and Blackwell architectures
• Clean Architecture: Modular codebase with proper error handling

• CUDA Toolkit 12.0 or later
• CMake 3.24 or later
• libcurl development headers
• OpenSSL development headers
• C++17 compatible compiler

# Clone the repository
git clone https://github.com/tetsuo/tetsuo-gpu-miner.git
cd tetsuo-gpu-miner

# Build
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(nproc)

# The binary is at build/tetsuo-miner

# Specify CUDA architectures
cmake -B build -DCMAKE_CUDA_ARCHITECTURES="86;89"

# Debug build with verbose output
cmake -B build -DCMAKE_BUILD_TYPE=Debug

# Mine to your wallet address (recommended)
./tetsuo-miner -a TYourAddressHere -o http://127.0.0.1:8337 -u rpcuser -p rpcpass

# Use specific GPUs
./tetsuo-miner -d 0,2 -a TYourAddressHere

# Full example
./tetsuo-miner \
    --address TRJvAZFxtoJEjR6ipC15NuQ4LFq7gS5Qyu \
    --url http://127.0.0.1:8337 \
    --user myuser \
    --pass mypass

Your TETSUO node must be running with RPC enabled:

# ~/.tetsuo/tetsuo.conf
server=1
rpcuser=myuser
rpcpassword=mypass
rpcallowip=127.0.0.1
rpcport=8337

Start the node:

tetsuod -daemon

Expected hashrates (approximate):

Multi-GPU setups scale linearly.

tetsuo-gpu-miner/
├── CMakeLists.txt
├── LICENSE
├── README.md
├── include/
│   ├── sha256.cuh           # CUDA SHA256 kernel
│   └── tetsuo/
│       ├── config.hpp       # Configuration
│       ├── cuda_utils.cuh   # CUDA error handling
│       ├── mining.hpp       # Mining structures
│       ├── rpc.hpp          # RPC client
│       └── utils.hpp        # Utility functions
└── src/
    ├── main.cu              # Main miner entry point
    ├── mining.cpp           # Mining functions
    ├── rpc.cpp              # RPC implementation
    └── utils.cpp            # Utility implementations

MIT License - see LICENSE for details.

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request