miners.science
[info] Early miners: 6 SHA-256 + 4 Scrypt seats for new miners (Telegram or website account). Hold ≥1 TH/s (Scrypt ≥1 GH/s) for 7 days and get up to 90% off pool fees forever. New entries until 13 Dec 23:59 UTC [more]

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.

open @minersscience_bot →

$ 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: /stats or /miner/<your Telegram ID>.
--server # auto = nearest · or pick one
# 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).

PortCoinModeUsernamePassword
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 profit or lowdiff = 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 /start to @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, password x.
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), /payouts and /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]