Talero Documentation
Mining

Mining and pool integration

Configure authenticated Stratum TLS mining with a wallet-delegated mining key, then access miner-specific activity through wallet ownership authentication.

PoW active Stratum TLS Mining-key delegation v2 Private dashboard

The pool profile is discovered at runtime. Read the public profile before creating or renewing credentials; do not rely on an old endpoint, chain tag or delegation lifetime copied from documentation.

Three interfaces, three different roles

Connection Surface Purpose
Miner to pool stratum+tls://pool.talero.info:3333 Stratum JSON-RPC with Talero authorization v2 and dual-target extensions
Pool to node Restricted operator connection talero_getWork and talero_submitWork
Generic public RPC Not a mining endpoint Chain reads and simulations only; eth_submitWork is unsupported

The previous documentation conflated the node work interface with the external miner interface. Miners connect to the pool over TLS; they do not call node mining RPC through the generic public gateway.

Discover the active pool profile

The public profile is the authority for network, audience, maximum delegation lifetime and Stratum endpoint. Wallets and miners must validate it rather than embed a silent fallback.

curl -sS https://pool.talero.info/api/pool/config

{"profileVersion":1,"scheme":"talero-stratum-mining-key-v2","chainTag":"talero-testnet","poolAudience":"pool.talero.info","maxDelegationLifetimeSecs":7776000,"stratumHost":"stratum+tls://pool.talero.info:3333"}

This is the current public-testnet value. Re-read the endpoint when starting or renewing a delegation.

Create mining credentials in Talero Wallet

  1. Open Talero Wallet and unlock the encrypted local vault.
  2. On the local payment-account row, select Configurer le minage.
  3. Review the active pool profile and choose a lifetime no greater than the published maximum.
  4. Let the wallet generate an independent random mining key locally.
  5. Review and sign the EIP-191 delegation once with the payment account.
  6. Download both mining.key and mining-delegation.json.

Never place the payment private key in mining software. The independent key in mining.key signs mining sessions; it cannot replace the payment wallet for spending TLRO.

Protect the two downloaded files

File Contents Handling
mining.key Independent ECDSA mining private key Secret; owner-readable only; never upload to the pool or a cloud drive
mining-delegation.json Payment address, mining address, audience, validity and payment-wallet signature Keep beside the matching mining key and replace it on renewal

On Linux or macOS:

chmod 600 -- mining.key mining-delegation.json

The browser cannot enforce filesystem permissions after download. On Windows, remove inherited access and grant only the miner service account access through NTFS ACLs.

Stratum TLS authorization v2

  1. The miner validates the TLS certificate for pool.talero.info and sends mining.subscribe.
  2. The pool returns a connection-specific extraNonce1.
  3. The miner signs the exact session message with mining.key.
  4. The miner sends mining.authorize with the v2 delegation and session proof.
  5. The pool reconstructs both messages and verifies payment signer, mining signer, chain, audience, worker, expiry, revocation and connection challenge before serving work.

The authorization username has the form tlro:<payment-address>.<worker>. The worker portion may contain dots and must remain byte-for-byte identical in the username, payload and signed session message.

Delegation signed by the payment wallet:

Talero Stratum mining key delegation v2: chain=<chainTag> pool=<poolAudience> wallet=<paymentWallet> mining_key=<miningAddress> delegation_id=<delegationId> issued_at=<issuedAt> expires_at=<expiresAt>

Session signed by the independent mining key:

Talero Stratum mining session v2: chain=<chainTag> pool=<poolAudience> wallet=<paymentWallet> worker=<worker exactly as configured> mining_key=<miningAddress> delegation_id=<delegationId> challenge=<extraNonce1 exactly as received>

The worker and challenge strings are byte-sensitive. A proof from another connection cannot be replayed because the session message is bound to that connection's challenge.

Activate the private miner dashboard

  1. Return to the same payment-account row in Talero Wallet.
  2. Select Activer sur la pool and review the wallet-ownership message.
  3. Sign it locally. This is an EIP-191 message, not a transaction; it spends no TLRO and no gas.
  4. The wallet opens a one-time activation link on the pool. The pool stores the resulting session in a secure, HttpOnly, same-site cookie.
  5. Use https://pool.talero.info/miner for the private view and log out when finished.

The session is scoped to the signed payment address. It cannot read another miner address, and the address is not placed in the normal dashboard URL.

PPLNS, finality and privacy

  • The pool uses PPLNS with a 1% fee.
  • Accepted shares contribute to the moving PPLNS window; short bursts do not imply a fixed reward.
  • A found block becomes payout-eligible only under the pool's canonical finality policy.
  • No fixed payout hour or miner-configurable threshold is promised by this documentation.
  • Worker names, individual shares, balances and payout history are available only in the authenticated miner dashboard or to pool administrators.
  • The public site publishes aggregate pool metrics, not a miner leaderboard or public address lookup.

Rejected and unsupported paths

  • Plaintext Stratum and TLS verification bypasses are not supported.
  • Legacy v1 or direct payment-wallet Stratum proofs are not accepted on the public TLS listener.
  • A generic miner that lacks Talero authorization v2 and dual-target support is not compatible merely because it speaks conventional Stratum.
  • eth_submitWork is unsupported; end-user miners do not use the node work RPC.
  • Do not paste a payment private key into a command line, miner configuration or support request.

For an expired or lost mining key, start a new wallet ceremony and replace both files. For an expired or already-used dashboard challenge, restart activation from Talero Wallet.

Configure mining in Talero Wallet Open the public pool