Everything you need to run, mine, and stay untraceable.

Introduction#

Mangonote is designed around four commitments: fairness (no premine — every coin was mined in the open from block zero), accessibility (RandomX makes CPUs the best mining hardware, so no ASIC arms race), privacy (sender, receiver and amount are obscured on every transaction), and speed (a 60-second block time — on average ~204× faster confirmations than Bitcoin).

Block size is dynamic and fees are computed automatically, so you never configure either. There is no foundation allocation and no instamine — just hashes.

At a glance#

Quickstart#

Watch the whole first-run flow — download, sync, wallet creation — then reproduce it on your own machine.

Requirements#

• OS: Linux (x86-64/ARM64), macOS 12+, or Windows 10+ (use WSL2 for the CLI tools).
• RAM: 2 GB minimum for RandomX — the algorithm is memory-hard by design.
• Disk: ≈48 GB for a full node, ≈18 GB with --prune-blockchain.
• CPU: anything from the last decade. A Raspberry Pi 5 can run a node.

Running a node#

Why run your own node#

Your node validates every block and every signature locally. Wallets that rely on third-party servers leak which addresses you own; a local node leaks nothing. For the strongest privacy, run a node — a pruned one fits on a laptop.

# start the daemon (mainnet) — first run syncs the chain
./mangonoted

# save ~60% disk with a pruned node
./mangonoted --prune-blockchain

# or run detached and check on it later
./mangonoted --detach
./mangonoted status

Config file & common flags#

Everything the daemon accepts as a flag can live in ~/.mangonote/mangonote.conf:

# data directory for the blockchain
data-dir=/mnt/chain/mangonote
p2p-bind-port=18180
rpc-bind-port=18181
# protect the RPC if you bind it externally
rpc-login=user:change-me-long-password
prune-blockchain=1
max-concurrency=4

What healthy logs look like#

2025-06-14 21:07:33.552 [node0] INFO  cn   Height 898,415 · difficulty 214,551 · 8 peers
2025-06-14 21:07:52.013 [node0] INFO  cn   Block #898,416 accepted · reward 12.45 MNN
2025-06-14 21:08:04.381 [P2P6]  INFO  net  Peer handshake ok · 9 outgoing · 7 incoming

CPU mining#

Mangonote uses RandomX, a proof-of-work algorithm optimized for general-purpose CPUs. It runs your processor through thousands of randomly generated programs against a 2 GB memory dataset — which is exactly why GPUs and ASICs gain so little here. GPU mining is possible, but not efficient; the CPU you already own is the right tool.

Get XMRig#

The reference RandomX miner works out of the box. Grab a release build, or compile it for maximum performance:

# build from source (recommended)
git clone https://github.com/xmrig/xmrig && cd xmrig && mkdir build && cd build
cmake .. && make -j$()nproc

# linux: enable huge pages for the fast mode
sudo sysctl vm.nr_hugepages=1168

Configure & run#

Point XMRig at your local daemon for solo mining, or at a pool (next sections). Set your payout address as the user:

{
  "autosave": true,
  "cpu": { "enabled": true, "huge-pages": true },
  "randomx": { "mode": "fast" },
  "http": { "enabled": true, "host": "127.0.0.1", "port": 8080 },
  "pools": [
    {
      "coin": "mnn",
      "url": "localhost:18181",
      "user": "YOUR_MANGONOTE_ADDRESS",
      "pass": "rig-01"
    }
  ]
}

$ ./xmrig -c config.json

What to expect#

Indicative RandomX hashrates at default tuning — your numbers will vary with memory speed and BIOS settings:

Solo mining#

Solo mining means your own daemon assembles block candidates and you search for a valid hash alone. Every block you win pays the full reward plus fees — currently 12.45 MNN + fees — straight to your address. Payouts are instant because there is no intermediary, but income is lumpy: with a modest hashrate you may wait days between blocks.

mangonoted> start_mining 8
Mining started: 8 threads → mNNq…8fKz
mangonoted> stop_mining
Mining stopped.

• Good for: supporting the network's decentralization, lottery-style rewards, no pool fees.
• Not good for: predictable income — variance is the price of the full block reward.

Pool mining#

Pools aggregate hashrate from many miners and split rewards proportionally, smoothing income into small, steady payouts. Community pools use PPLNS with a typical minimum payout of 0.1 MNN.

"pools": [
  { "coin": "mnn",
    "url": "pool.mangonote.org:3333",
    "user": "YOUR_MANGONOTE_ADDRESS",
    "pass": "x",
    "rig-id": "living-room" }
]

CLI wallet#

Create a wallet#

The CLI wallet generates a key pair and writes a 25-word seed — the master key to your funds. It is shown once at creation.

$ ./mangonote-wallet-cli
Wallet file name: juice
Password for new wallet:
Generated new wallet: mNNqYs9dK7…8fKz
View key: c1e4…9ab0
NOTE: the following 25 words can be used to recover access to your wallet.
Write them down and store them somewhere safe and secret.

Everyday commands#

Restore & backup#

Twenty-five words are all you need to rebuild a wallet on any machine. Supplying a restore height makes the scan fast — the wallet starts looking for your transactions from that block instead of from genesis:

$ ./mangonote-wallet-cli --restore-deterministic-wallet \
    --electrum-seed "lizard oxygen mango … (25 words)" \
    --restore-height 898000

• File backup: copy <wallet>.keys plus the wallet file and password — that restores everything without the seed.
• Don't know your first tx? Use the height from around your first deposit; a slightly early guess just costs a longer scan.
• Test it: restore into a fresh directory once, now, while nothing is on fire.

Addresses#

A Mangonote address is a 106-character string beginning with m (e.g. mNNq…8fKz). It is safe to share — receiving funds reveals nothing about you on-chain. Three flavors exist:

• Standard address — your default receive address.
• Subaddress — derived indexes for per-contact or per-service receiving, all spending to the same wallet.
• Integrated address — a standard address with an embedded payment ID, useful for exchanges.

Privacy#

Mangonote is private by default, for everyone, on every transaction. There is no opt-in mode and no "transparent" fallback to misconfigure. Three independent techniques stack to break every link an observer would normally draw:

Privacy in practice#

Protocol privacy is necessary but not sufficient. Two habits close the remaining gaps: use your own node (so you don't ask someone else's server about your transactions) and avoid address reuse (subaddresses make that painless). With both, the only party who knows what you sent, received, or hold is you.

Fees & scaling#

You never pick a fee by hand. The wallet computes it from current network conditions — median recent block size and mempool pressure — and attaches the smallest fee that reliably lands in the next block or two. Typical transactions cost a fraction of a cent in MNN terms.

Fee priority#

Impatient? A priority multiplier multiplies the computed fee to outbid congestion:

* indicative, 1-in/2-out transaction. Network conditions vary.

Dynamic block size#

Blocks are not capped at a fixed byte count. Each new block may exceed the median of recent blocks by a bounded factor, letting capacity grow under sustained demand — and shrink back when quiet — while full nodes retain validation headroom. Combined with automatic fees, scaling stays an emergent property rather than a governance debate.

Consensus#

A transaction's journey: broadcast → mempool → a miner's block template → RandomX hashing until a candidate meets the network difficulty → propagation and validation by every node. Once included, 10 confirmations (~10 minutes) is the community-recommended threshold for treating a payment as settled — roughly a coffee's length, not an hour.

Difficulty retargets every block using a linearly-weighted moving average, so hashrate swings smooth out within minutes rather than requiring 2016-block epochs.

Security after full emission: when the 100,000,000th MNN is mined, the block subsidy ends — miner revenue transitions to the fee market that has been accruing since launch (over 26,600 MNN in fees paid to miners so far).

Specifications#

Live network figures — height, total mined, total fees — are on the main site and the block explorer.

FAQ#

Community#

Miners, makers, and the mildly obsessed — the grove is open 24/7.