Exporter vos gains Train at Home en CSV : la page Revenus de subnera hub

Si vous voulez un relevé daté de ce que vos Mac ont perçu avec Train at Home, subnera hub propose une page pour cela : Revenus (« Gains » dans le menu). Ce guide explique ce que cette page affiche, d'où viennent ses chiffres, comment sont construits les fichiers CSV et JSON, et où elle s'arrête. Pour le fonctionnement des récompenses et des versements côté réseau, voyez le guide sur les récompenses et versements ; celui-ci porte sur la lecture et l'export du relevé.

D'où viennent les chiffres

La page Revenus ne lit rien dans le journal de votre Mac. subnera hub interroge l'API publique de Macrocosmos pour la clé publique (hotkey) de chaque machine et conserve sa propre copie de l'historique des versements. Une hotkey est consultée environ une fois par heure, et de nouveau peu après l'heure du prochain versement annoncée par l'API. Chaque versement est attribué à la machine qui détenait cette hotkey au moment où il a été acquis : un Mac qui a changé de pool n'est donc pas compté deux fois.

Ces chiffres sont la lecture que subnera hub fait de données publiques, pas une déclaration officielle de qui que ce soit. subnera et subnera hub sont non officiels et n'ont aucun lien avec IOTA, Macrocosmos ou Bittensor.

Gagné, en attente et prochain versement

Sur la page de la flotte, un bandeau de récompenses affiche trois valeurs tirées des mêmes données publiques : Gagné, En attente et un compte à rebours Prochain paiement. Un lien Voir les gains dans ce bandeau ouvre la page Revenus du pool (/pools/<id>/earnings). Tous les rôles d'un pool peuvent la lire ; voyez le guide sur les pools et les rôles pour le sens des rôles.

Sur la page Revenus elle-même, le filtre Statut bascule entre Payés et Payés + en attente. Par défaut, seules les lignes payées comptent. Les cartes de synthèse donnent le Total gagné en SN9, la valeur en USD, la valeur dans la devise choisie et le nombre de versements.

Choisir une période et un regroupement

Le filtre Période propose Cette année, L’année dernière, Les 12 derniers mois ou Personnalisée avec une date de début et de fin. Les filtres Devise et Fuseau horaire s'appliquent à la page et à tout fichier téléchargé. Le fuseau décide à quel jour, mois ou année appartient un versement : un versement juste après minuit UTC peut tomber un autre jour local.

Le tableau Totaux regroupe les mêmes versements par Mois, Année ou Machine. Les regroupements par jour et par trimestre existent dans l'API du hub pour le fichier de totaux, mais la page n'affiche que ces trois boutons. Sous les totaux, la liste Versements donne une ligne par versement : date, machine, statut, montant et notes.

Si certains versements précèdent le moment où subnera hub a commencé à suivre la hotkey d'une machine, un bandeau l'indique et les exclut. Inclure les revenus antérieurs les ajoute de nouveau, dans les totaux, la liste et les téléchargements.

Comment les valeurs sont calculées

Chaque versement est valorisé avec un instantané de prix : le prix journalier du SN9 sur CoinGecko à 00:00 UTC le jour du versement, pas un cours en direct. subnera hub conserve cet instantané, si bien qu'un même fichier régénéré plus tard donne les mêmes chiffres. Un versement dont le jour n'a pas encore de prix est marqué unpriced et retenté automatiquement. Les totaux qui contiennent de telles lignes sont qualifiés de partiels, pour qu'un mois à moitié valorisé ne soit pas pris pour un chiffre définitif.

Les lignes peuvent porter d'autres notes : shared_hotkey quand une hotkey appartient à plusieurs de vos machines, before_tracking pour les gains antérieurs, upstream_conflict quand un versement payé a changé ensuite côté API (le premier montant enregistré est conservé), et ledger_incomplete quand l'historique d'une hotkey n'a pas pu être entièrement vérifié.

Préférences et formats de fichier

La carte Préférences des revenus de la page Compte fixe vos valeurs par défaut : devise, fuseau horaire et format CSV. Vous pouvez toujours les changer à chaque export sur la page Revenus. Les formats CSV sont :

• CSV : séparé par des virgules, décimales avec point, guillemets selon la norme RFC 4180.
• CSV pour Excel : identique, avec une marque d'ordre des octets pour qu'Excel lise l'UTF-8.
• CSV pour Excel, Europe : séparé par des points-virgules, décimales avec virgule, pour les Excel réglés sur une langue européenne.

Les cellules de texte qu'un tableur pourrait interpréter comme une formule reçoivent une apostrophe en tête.

Télécharger

Dans la section Télécharger, choisissez un format de fichier puis Télécharger le CSV ou Télécharger le JSON pour obtenir une ligne par versement sur la période. Le fichier contient l'heure d'acquisition en UTC, la date locale, le statut, le pool, la machine, la hotkey, le montant en SN9, les prix et valeurs en USD et dans votre devise, le jour et la source du prix, et les notes. Télécharger les totaux CSV donne une ligne par groupe plus un total, selon le regroupement choisi, et ses chiffres s'additionnent pour retrouver les totaux affichés à l'écran. Les fichiers sont nommés d'après le pool, les dates et la devise.

Une plage qui produirait plus de 200 000 versements est refusée, avec une demande de la réduire.

Ce que ce n'est pas

L'export est une aide de tenue de comptes. Il ne calcule pas ce que vous devez et ne constitue ni un conseil fiscal ni un conseil juridique. Comme l'indique le pied de page, les valeurs reposent sur le prix journalier du SN9 sur CoinGecko à 00:00 UTC le jour du versement et sont des données pour vos archives. Renseignez-vous sur les règles qui s'appliquent à vous et conservez les fichiers sur lesquels vous vous appuyez.

Liste de vérification

1. Connectez chaque Mac à subnera hub, pour que sa hotkey soit suivie.
2. Réglez devise, fuseau horaire et format CSV dans les Préférences des revenus.
3. Ouvrez Revenus, choisissez une période et comparez Payés et Payés + en attente.
4. Repérez les bandeaux sur les revenus antérieurs, les lignes unpriced ou un historique incomplet.
5. Téléchargez le fichier des lignes, et un fichier de totaux regroupé comme il vous faut.

Si un versement semble attribué à la mauvaise machine, voyez le guide de dépannage.