- C++ 91.1%
- HTML 6.6%
- CMake 2.3%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
Socket differences live in net/socket.h, and headers see only the handle type (net/handle.h). The data directory is %LOCALAPPDATA% there, SIGPIPE is ignored only where it exists, and the per-run identity noise comes from random_device instead of getpid. CMake links ws2_32 and finds beam's MSVC libraries, Boost and OpenSSL the way beam's build does. |
||
| cmake | ||
| docs | ||
| src | ||
| tests | ||
| third_party | ||
| .gitignore | ||
| .gitmodules | ||
| CMakeLists.txt | ||
| LICENSE | ||
| NOTICE | ||
| README.md | ||
Beam P2Pool
A decentralised mining pool for Beam: no operator, no custodian, no payout transactions. Every participant is paid directly in the coinbase of any block the pool finds.
Mimblewimble has no addresses, so participants pre-sign spendable bundles of their
own, and whoever builds a block folds them into its coinbase. Every participant
computes the payout from the sidechain alone; a block that pays anyone else is
refused. Beam needs one node flag, --mining_allow_foreign_outputs, and no fork.
State: multi-participant mining works on regtest. Not yet run on a real network, and there are no public seed nodes.
Build
Needs a C++17 compiler, CMake and sqlite3:
cmake -S . -B build && cmake --build build -j && ctest --test-dir build
The daemon also needs Beam, pinned as a submodule and built at the same commit:
git submodule update --init
cmake -S . -B build -DBEAM_SOURCE_DIR=/path/to/built/beam
On Windows, build with MSVC. Without a system sqlite3, point CMake at the
amalgamation's sqlite3.c, and give it the
Boost and OpenSSL that Beam was built with:
cmake -S . -B build -DSQLITE_AMALGAMATION=C:\path\to\sqlite3.c ^
-DBEAM_SOURCE_DIR=C:\path\to\built\beam -DBOOST_ROOT=C:\path\to\boost ^
-DOPENSSL_ROOT_DIR=C:\path\to\openssl
cmake --build build --config Release && ctest --test-dir build -C Release
If Beam was built with -DBEAM_USE_STATIC=ON, add
-DBoost_USE_STATIC_LIBS=ON -DOPENSSL_USE_STATIC_LIBS=ON.
Run
beam-wallet export_miner_key --subkey=1
beam-wallet export_owner_key
beam-p2pool --node 127.0.0.1:10015 --miner-key <miner key> --owner-key <owner key> --wallet-pass <password>
Then start your Beam node with the --owner_key the daemon printed:
beam-node --pass=<password> --owner_key=<printed> --extra_owners=<owner key> \
--mine_online=1 --mining_allow_foreign_outputs=1 \
--stratum_port=10015 --stratum_use_tls=0 \
--peer=eu-nodes.mainnet.beam.mw:8100,us-nodes.mainnet.beam.mw:8100
Point rigs at the daemon, e.g. with MXBM:
mxbm --algo BEAM-III --pool 127.0.0.1:8103
The dashboard is at http://127.0.0.1:8104/. Add --peers HOST:PORT once to join
others.
Docs
- docs/running.md: full walkthrough, from nothing to mining.
- docs/design.md: why this is hard on Beam, and how it works.
- docs/payouts.md: the payout function.