Récompenses Train at Home : suivre ses gains SN9

Qu'est-ce qu'IOTA Train at Home ? posait déjà la limite honnête : Macrocosmos ne décrit le mécanisme de récompense qu'à un niveau général, et cet article ne devinera pas la formule exacte non plus. Ce qu'il peut couvrir, c'est le côté pratique — comment voir et exporter réellement ce que vous avez touché, une fois enrôlé dans subnera hub.

D'où viennent les chiffres

La page Earnings de subnera hub (/pools/<id>/earnings, également accessible depuis le bandeau de récompenses de la flotte) lit l'historique des versements de chaque pool pour les hotkeys de ses machines depuis l'API publique de Macrocosmos — les mêmes données publiques de récompenses que la grille de flotte en direct affiche déjà par hotkey. C'est une lecture à sens unique : rien concernant votre compte, votre Mac ou votre pool n'est envoyé où que ce soit pour obtenir cela. Chaque versement est ensuite attribué à la machine qui détenait réellement le placement de cette hotkey au moment où il s'est accumulé, si bien qu'un Mac ayant changé de pool, ou une hotkey partagée entre plusieurs machines, reste correctement rattaché au lieu d'être compté deux fois ou perdu.

Valorisation optionnelle en devise

Par défaut, subnera hub appelle aussi CoinGecko une fois pour chaque jour calendaire nécessitant un prix, afin de valoriser les versements en USD et dans une devise de votre choix (EUR par défaut ; la liste couvre une quarantaine de devises ISO, de USD, GBP et CHF à JPY, INR et BRL). Le prix utilisé est l'instantané quotidien de CoinGecko à 00:00 UTC pour ce jour précis — pas un cours en direct ou temps réel.

Vous pouvez désactiver cela entièrement (HUB_PRICE_SOURCE=off) : les versements déjà valorisés gardent leur prix enregistré, et les nouveaux restent non valorisés jusqu'à ce que vous réactiviez la fonction, moment où les jours manquants sont automatiquement complétés rétroactivement.

Totaux « non valorisés » et « partiels »

Un versement sans prix historique correspondant est marqué unpriced dans les notes de sa ligne. Un total par période ou par machine qui inclut des lignes non valorisées s'affiche comme partiel, pour qu'un total mensuel consulté en pleine collecte ne soit pas pris pour un chiffre définitif. Quelques autres indicateurs existent pour des cas particuliers — par exemple shared_hotkey, quand un versement appartient à une hotkey partagée entre plusieurs de vos machines, et forme alors son propre groupe plutôt que d'être réparti arbitrairement entre elles.

Vos préférences d'export

Une carte « Earnings preferences » sur la page Compte regroupe trois réglages : la devise par défaut, le fuseau horaire (utilisé pour regrouper les versements par jour, mois, trimestre ou année calendaires dans les totaux), et le format CSV — RFC 4180 classique (séparateur virgule, décimales à point), Excel (identique, avec un marqueur d'ordre des octets pour qu'Excel reconnaisse l'UTF-8 automatiquement), ou Excel-EU (séparateur point-virgule, décimales à virgule, pour les installations Excel européennes qui attendent ce format).

Ce que vous pouvez télécharger

Depuis la page Earnings, vous pouvez télécharger :

• Les lignes de versement brutes, en CSV ou JSON, pour une période donnée — une ligne par versement, avec sa date d'accumulation (UTC et votre jour calendaire local), son statut, le pool, la ou les machines, la hotkey, le montant en SN9, sa valeur en USD, sa valeur dans votre devise choisie, la date et la source du prix, et d'éventuelles notes.
• Un résumé de totaux (CSV uniquement), regroupé par jour, mois, trimestre, année ou machine, avec une ligne par groupe plus une ligne de total final, de sorte que ré-additionner la colonne du fichier reproduise les totaux affichés.

Les noms de fichiers sont générés automatiquement (iota-earnings_<pool>_<de>_<à>_<devise>.csv, ou -totals-<groupe> pour un résumé) — pas besoin de les nommer à la main. Une période assez large pour contenir plus de 200 000 lignes de versement est refusée d'emblée, avec un message invitant à la resserrer, plutôt que de produire silencieusement un fichier énorme ou tronqué.

Ce que c'est (et ce que ce n'est pas)

L'export existe pour vous donner vos propres chiffres dans un format que vous pouvez conserver, importer dans un tableur ou transmettre à quelqu'un d'autre — il ne calcule rien que vous devriez à qui que ce soit, et ce n'est pas un conseil fiscal. Comme le dit la note de bas de page de l'export elle-même : « Values use CoinGecko's daily SN9 price at 00:00 UTC on the payout day. This is data for your records, not tax advice » (les valeurs utilisent le prix quotidien SN9 de CoinGecko à 00:00 UTC le jour du versement ; ce sont des données pour vos propres registres, pas un conseil fiscal). Conservez vos propres registres, et vérifiez les règles qui s'appliquent à votre situation localement — le rôle de cette fonctionnalité s'arrête à vous fournir des chiffres exacts et datés à partir desquels travailler.

Checklist

1. Enrôlez au moins un Mac dans subnera hub — voir le guide sur le hub de flotte si ce n'est pas déjà fait.
2. Ouvrez « Earnings preferences » sur la page Compte et réglez votre devise, votre fuseau horaire et votre format CSV.
3. Consultez la page Earnings d'un pool pour voir les versements déjà attribués par machine.
4. Si les valeurs USD/devise manquent, vérifiez que HUB_PRICE_SOURCE n'est pas réglé sur off dans l'environnement qui fait tourner le hub.
5. Téléchargez les lignes brutes pour vos registres, ou un résumé de totaux groupé par mois ou par machine, selon votre besoin réel.
6. Traitez toute ligne ou tout total marqué « non valorisé »/« partiel » comme encore en cours de stabilisation, pas comme une erreur.
7. Conservez les fichiers téléchargés comme vos propres registres ; vérifiez au-delà les règles applicables à votre situation localement.

Pour le mécanisme d'incitation lui-même plutôt que l'outil d'export, voir ce qu'est IOTA Train at Home. Si un versement semble mal attribué, le guide de dépannage et le guide de configuration optimale sont les prochaines étapes à suivre.