user@miners:~$ man miners-telegram
Telegram bot guide
# mine with your Telegram ID: no key, no profile, everything from the bot. In the bot, /help is the short version.
$ man miners-telegram what # what it is
- ▸ username = your Telegram ID; addresses, SOLO/PPLNS, strategy, coins, minimum payout and alerts are set in @minersscience_bot. Works on every port, fixed and auto.
- ▸ changes reach connected miners within about a minute, no restart.
- ▸ stats (read-only) at
/miner/<your Telegram ID>; settings change only from your chat.
# anti-theft: the first address for a coin is active at once; a changed address takes effect 48 hours after you confirm it. Until then every reward, merged and weekly included, goes to the old one. Removing an address and setting another one counts as a change (it waits too). Only during the first hour after your very first address are changes immediate, to fix typos while setting up. Cancel with ✖ Cancel change or /address cancel <coin>.
# without Telegram: an address profile (-p p=CODE) and its key mk-… on [manage].
$ man miners-telegram start # getting started
- 1. Open @minersscience_bot, press Start. Your username is
<your Telegram ID>.<worker>. - 2. Tap the coin (main coins; merged ones later in Settings → Addresses).
- 3. Paste your payout address as a reply (within 10 minutes) and confirm. Use a wallet you hold the key of, not an exchange deposit address.
- 4. Choose SOLO or PPLNS (mode of the auto ports).
- 5. Copy the command line into each miner, renaming
rig01. - 6. Check after a few minutes:
/statsor/miner/<your Telegram ID>.
# auto: the closest server that is up
one that stops answering is skipped within about a minute · same pool, ports and login everywhere
# backup: add de.miners.science as the second pool in your miner
(same port, username and password): if the first server cannot be reached, the miner switches by itself. It is a fixed regional name, so it also covers a problem with the automatic one.
# example with a made-up ID (123456789): yours is in 🆔 My ID
$ ./miner -o stratum+tcp://stratum.miners.science:3333 -u 123456789.rig01 -p x# BTC SOLO port. Optional minimum difficulty: -p x,d=65536. The ID goes in the username, never in the password.
# "Skip: open the menu" leaves the guide; every step is also in ⚙️ Settings or by command (/address btc <address>, /mode pplns, /connect).
| Port | Coin | Mode | Username | Password |
|---|---|---|---|---|
stratum+tcp://stratum.miners.science:3330 |
auto (BC2/BCH/BCH2/BTC/BTC1/NITO/TAR/XEC with your address) | SOLO or your /mode | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:3340 |
auto (BC2/BCH/BCH2/BTC/BTC1/NITO/TAR/XEC with your address) | PPLNS or your /mode | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:3333 |
BTC | SOLO | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:3334 |
BTC1 | SOLO | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:3343 |
BTC | PPLNS | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:3344 |
BTC1 | PPLNS | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:3335 |
BC2 | SOLO | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:3345 |
BC2 | PPLNS | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:3336 |
BCH2 | SOLO | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:3346 |
BCH2 | PPLNS | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:4333 |
LTC | SOLO | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:4343 |
LTC | PPLNS | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:4334 |
DGB | SOLO | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:4344 |
DGB | PPLNS | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:4330 |
auto (DGB/LTC with your address) | SOLO or your /mode | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:4340 |
auto (DGB/LTC with your address) | PPLNS or your /mode | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:3337 |
BCH | SOLO | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:3347 |
BCH | PPLNS | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:3338 |
TAR | SOLO | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:3348 |
TAR | PPLNS | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:3339 |
XEC | SOLO | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:3349 |
XEC | PPLNS | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:3332 |
NITO | SOLO | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:3342 |
NITO | PPLNS | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:5333 |
ZEC | SOLO | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:5343 |
ZEC | PPLNS | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:5330 |
auto (ZEC with your address) | SOLO or your /mode | TELEGRAM_ID.worker |
x |
stratum+tcp://stratum.miners.science:5340 |
auto (ZEC with your address) | PPLNS or your /mode | TELEGRAM_ID.worker |
x |
# all ports: stratum+tcp://stratum.miners.science + port. Fixed port: the port's mode; auto port: the mode set in the bot.
$ man miners-telegram settings # ⚙️ Settings, one by one
- Addresses ·
/address <coin> <address> - One payout address per coin, checked by the coin's node, confirmed seeing old and new. First address at once, a change 48 hours later. 🗑 Remove <coin> (or
/deladdress) shows what happens, asks Yes, remove / Cancel and is immediate, but setting an address again after removing one counts as a change, even the same address. A coin without an address is never mined for you (fixed port refused, auto ports skip it).
Merged coins (BEL, DOGE, LKY, PEP on the scrypt ports; BTCO, ELA, FB, NMC on the sha256d ports; WEC on the equihash ports): a merged block found by your share is paid in full to you, SOLO and PPLNS. Without your address for that merged coin, the merged blocks you find are paid to the pool. Add them: Settings → Addresses → "(merged)", or/address bel <address>.more
The same address on two coins (BTC and BTC1 share the format) is accepted with a warning: fine only if you hold its private key.
- Mode SOLO/PPLNS ·
/mode solo | pplns | default - SOLO: the whole block (minus the SOLO fee) to your address; big, irregular. PPLNS: each pool block shared by the recent work (N × network difficulty, at most the last 14 days); small, steady. Only for auto ports (
default= the port's mode); a fixed port always uses its own mode. - Strategy ·
/strategy profit | lowdiff | coin <coin>·/strategy scrypt lowdiff - How auto ports pick among your coins of the port's algorithm, one choice per algorithm (SHA-256, Scrypt, …):
/strategy profitorlowdiff= every algorithm,/strategy coin ltc= only the Scrypt ports,/strategy <algo> profit | lowdiff | coin <coin> | default= one algorithm. The Strategy button asks the algorithm first. Choices: profit (default): most $ per hash, changes only for ≥ 5% more · lowdiff: lowest network difficulty, at most one change every 10 minutes · coin: that coin only, no fallback (coin not ready = miner disconnected, it moves to its backup pool). Shortcut/coin <coin>,/coin auto= profit.more
A coin that is not ready (node down, no peers, behind) is never mined. The switch happens inside the connection: no reconnection, at most a few seconds of stale shares.
- Coins ·
/coins btc btc1 | all - Which of your coins profit and lowdiff may use (at least one);
all= every coin with an address. Ignored on an algorithm with the one-coin strategy. - Min payout ·
/minpayout <coin> <amount> | default - PPLNS minimum per main coin (merged coins have none). Below it your share is kept as credit; it is paid in a later PPLNS block once it reaches your minimum, or weekly (only on BC2, BCH, BCH2, BTC, BTC1, DGB, LTC, NITO, TAR, XEC; on ZEC credit is paid in the coinbase of a later block or from the pool wallet within 24 hours, no weekly payment) in a normal transaction (also if you stopped mining; the pool pays the network fee). Keep the coin's address saved.
- Alerts ·
/alerts - All on by default: blocks (found, confirmed, orphaned) · workers (offline after 10–180 min, default 15; back online) · weekly payment.
/alerts offline 45,/alerts off,/alerts workers off. - Block alerts ·
/blockalerts on | off | coins btc,nmc | all - One message per block that pays one of your addresses (SOLO, PPLNS share or credit, merged): coin, height, amount (and $), status, explorer; another when confirmed or orphaned.
more
It also covers miners using one of your bot addresses as username; several workers in one block = one message with the total. Coins: Settings → Alerts → Coins ("All coins" includes future ones) or
/blockalerts coins btc,bch2.
$ man miners-telegram rejected # the reason is in the miner's log
Telegram ID … is not registered: open … send /start and set your address- Send
/startto @minersscience_bot and save an address. The ID is the number in 🆔 My ID, not your @username. Telegram ID … has no BTC address: send /address btc …- No address for this port's coin (auto port: for any of its coins). Save one.
your saved … address is not valid: set it again with /address …- The node no longer accepts it: save it again.
put your Telegram ID in the username: -u ….<worker> -p x- Username
ID.worker, passwordx. p=CODE is for address usernames; Telegram users set addresses with the bot- Remove
p=…from the password. your fixed coin … is not available on this port·… cannot be mined in PPLNS mode·… has no valid address- Your one-coin strategy for this algorithm cannot be mined here (coin not offered, no valid address or no PPLNS): change Strategy for this algorithm.
… is merge-mined only on … ports, this port is …·the … address is not valid- Wrong merged address in the password. With Telegram save it in the bot instead (one in the password takes precedence).
… is not accepted: the username is the address- Only merged coins go in the password: set main coins in the bot.
- connected, then closed with no message
- The coin is not ready (node down, no peers, behind) on a fixed port or with one-coin strategy: the miner uses its backup pool and comes back later.
$ man miners-telegram security
- only your account
- Private chat only; the bot acts on whoever writes. Forwarded messages are never run: a request to forward a "/address …" message is a scam.
- no private keys
- Only public addresses. Nobody from the pool will ever ask for private keys, seed phrases or passwords.
- address changes are confirmed
- Checked by the node, saved after ✅ Confirm; a change is active after 48 hours. A "changed from … to …" you did not do = someone controls your Telegram.
- protect your Telegram
- Whoever controls it controls your payout addresses: turn on two-step verification (Settings → Privacy and Security).
- lost access to Telegram?
- Miners keep mining to the saved addresses; you just cannot change settings.
more
If someone else took the account, move your miners off the Telegram ID: fixed port
-u <address>.rig01 -p x, auto ports with an address profile. Then write to [contact]. The ID itself is not secret: it only shows your stats and lets miners mine to your addresses.
$ man miners-telegram faq
- change a worker name?
- Change the part after the dot and restart the miner. The old name is offline for 4 h, then inactive, gone after 24 h.
- several rigs?
- Same ID, a different worker each (letters, digits,
_ . : -, max 64 characters). - change coin or SOLO/PPLNS without stopping?
- Auto ports: yes (Strategy, Coins, Mode;
/coin btc1). Fixed ports: change port. - where are my payouts?
/blocks(SOLO, merged),/payoutsand/balance(PPLNS), and/miner/<ID>. Spendable after the coin's maturity (100 blocks for the Bitcoin family).- Telegram ID and an address at the same time?
- Yes: separate miners, each follows its own settings.
# ports, modes, profiles: [docs] · [glossary]