Bot de trading ERC-1155 : rapprocher chaque quantité

Construire le bot de trading ERC-1155 autour des types de jetons

La spécification officielle ERC-1155 décrit une interface de contrat capable de gérer plusieurs types de jetons, avec des soldes associés à un compte et à un identifiant de jeton. Elle comprend les transferts individuels et par lots, les requêtes de soldes par lots et les autorisations accordées aux opérateurs. Ces capacités ne déterminent pas comment une place de marché fixe le prix d’une édition ni si un ordre donné permet une exécution partielle.

Utilisez la blockchain, le contrat et l’identifiant du jeton pour identifier le type, puis enregistrez la quantité séparément. Un identifiant de jeton n’est pas la quantité détenue. Garder ces champs distincts évite qu’un identifiant d’affichage soit interprété comme un montant et permet à plusieurs enregistrements d’acquisition de contribuer au solde actuel d’un même type.

Associez un libellé d’unité clair à chaque quantité. Une proposition portant sur cinq unités d’une édition ne doit pas être confondue avec cinq types de jetons différents ou avec un pouvoir d’achat de cinq ETH. L’interface peut résumer la position, mais l’enregistrement sous-jacent doit conserver suffisamment de détails pour reconstituer exactement le transfert prévu.

La comparaison avec un bot de trading ERC-721 est utile, car elle révèle un choix de modélisation important. Un logiciel conçu autour de la propriété d’objets individuels ne doit pas réutiliser implicitement cette hypothèse pour des enregistrements comportant des quantités. Identifiez la norme prise en charge avant d’importer des actifs dans le registre de trading.

Distinguer les quantités détenues, réservées et disponibles

Le solde observé indique combien d’unités le compte détient selon sa politique de vérification. La quantité réservée indique combien d’unités sont engagées, au sein du processus, pour des intentions actives de vente ou de transfert. La quantité disponible résulte d’un calcul défini par la politique, qui tient compte de ces engagements et des écarts non résolus.

Supposons qu’un compte hypothétique détienne 12 unités de Lantern Edition 7. Une instruction active réserve quatre unités, et une autre action non résolue en concerne deux. Selon une politique prudente qui réserve les deux ensembles, seules six unités restent disponibles pour une nouvelle instruction. Présenter les 12 unités comme librement disponibles ignorerait les engagements déjà pris par le processus lui-même.

Documentez ce qui crée et ce qui libère une réservation. La création d’un brouillon ne mérite pas forcément le même traitement que l’autorisation d’un ordre exécutable, mais cette distinction doit être délibérée. Une demande d’annulation ne doit pas libérer le stock avant que le système dispose des preuves requises par la conception réelle de l’exécution.

Les règles de réservation des quantités ERC-1155 doivent persister après les redémarrages. Si les réservations n’existent qu’en mémoire, le redémarrage de l’application peut faire réapparaître comme disponible un stock précédemment engagé. Reconstituez les réservations à partir d’enregistrements persistants des intentions et des résultats avant de permettre à la proposition suivante d’utiliser le solde.

Suivre les lots d’acquisition sans inventer de numéros de série physiques

Un lot d’acquisition enregistre à quel moment et à quel coût le compte a obtenu une quantité. Il s’agit d’un enregistrement comptable, qui n’affirme pas nécessairement que les unités individuelles possèdent des identités de série distinctes. Le registre peut préserver l’historique économique de plusieurs achats même lorsque les unités partagent une seule identité de type de jeton.

À titre d’illustration, supposons que le compte acquière trois unités à 0,10 ETH chacune, puis deux unités à 0,14 ETH chacune, hors frais. La valeur totale des achats est de 0,58 ETH pour cinq unités, soit une moyenne de 0,116 ETH par unité selon une convention simple de coût moyen. Les lots d’origine doivent rester accessibles même si les rapports affichent cette moyenne.

Choisissez une convention cohérente de reporting de gestion pour attribuer les coûts d’acquisition aux cessions. Différentes conventions peuvent produire des chiffres différents pour chaque vente, tout en permettant le rapprochement des calculs globaux du compte. Ne présentez pas la méthode choisie comme un traitement fiscal universel ; ce guide porte sur l’analyse interne de la stratégie et la conservation des enregistrements.

Conservez la quantité et les frais de chaque lot afin de pouvoir modifier ou réexaminer le calcul ultérieurement sans perdre les preuves d’origine. Regrouper chaque achat dans une moyenne unique écrasée à chaque mise à jour rend difficile l’explication d’un écart ou la recherche de l’épisode d’acquisition à l’origine de l’exposition actuelle.

Distinguer le prix unitaire du montant total de l’ordre

Une annonce peut exprimer ses conditions d’une manière qui exige une interprétation attentive. La proposition doit préciser si le montant affiché s’applique à une unité, à un groupe d’unités ou à un ordre entier. Ne déduisez jamais cette distinction de la seule présence d’une image de NFT ou d’un libellé de prix succinct.

Dans un exemple hypothétique, une offre visant à acquérir six unités pour un total de 0,48 ETH implique un prix de 0,08 ETH par unité hors frais. Une offre portant sur six unités à 0,48 ETH chacune implique un montant de 2,88 ETH hors frais. Les mêmes nombres produisent une exposition très différente lorsque l’unité de tarification est mal comprise.

Affichez à la fois le montant unitaire et l’engagement total dans le dossier de vérification. Incluez l’actif de paiement, la quantité demandée et les coûts imputables. La personne chargée de la vérification doit pouvoir reproduire le total par un calcul simple avant d’autoriser l’action.

Testez cette distinction à l’aide d’exemples d’enregistrements volontairement ambigus. Si l’outil d’importation ne peut pas déterminer la base de tarification, il doit rejeter la proposition ou la soumettre à un examen supérieur, plutôt que de choisir une interprétation commode. Une édition apparemment bon marché peut se révéler un achat coûteux lorsqu’un champ de prix total est pris pour un champ de prix unitaire, ou inversement.

Gérer l’exécution partielle selon les conditions réelles de l’ordre

La norme du jeton ne suffit pas à établir qu’un ordre peut être exécuté partiellement. Examinez le circuit d’exécution et les conditions de l’ordre. Lorsque l’exécution partielle est prise en charge, l’enregistrement du compte doit distinguer la quantité demandée, la quantité exécutée, la quantité restante encore active et la quantité annulée ou expirée.

Supposons qu’un ordre hypothétique demande 10 unités et que le résultat vérifié établisse l’acquisition de quatre unités. L’enregistrement des avoirs augmente de quatre, tandis que le sort des six unités restantes dépend de l’état réel de l’ordre. Comptabiliser 10 unités comme détenues invente du stock ; considérer l’ordre entier comme terminé peut faire oublier un engagement restant.

La comptabilisation des exécutions partielles ERC-1155 doit relier chaque exécution à l’intention d’origine sans écraser les exécutions précédentes. Si trois unités arrivent, puis deux autres plus tard, l’enregistrement doit montrer les deux événements et le cumul de cinq unités. Cet historique aide à expliquer les frais et les différences de calendrier au cours de l’acquisition.

Appliquez la même rigueur aux ventes. Une cession partielle réduit la quantité détenue du montant vérifié et clôt la partie correspondante de la position comptable. Les unités restantes conservent leur propre exposition et leur enregistrement de coût. Un libellé de vente ne doit jamais laisser entendre que toute la position sur l’édition a disparu, à moins que les preuves relatives aux quantités ne le confirment.

Préserver les correspondances au sein des lots à chaque vérification

Lorsqu’une action proposée contient plusieurs types de jetons, préservez la correspondance entre chaque identifiant et sa quantité. Un écran de vérification qui présente tous les identifiants à un endroit et tous les montants ailleurs peut rendre une erreur de correspondance difficile à remarquer. Affichez chaque paire comme une seule unité de sens, même si l’interface sous-jacente utilise des tableaux.

Pour un lot fictif, les paires prévues pourraient être Edition 7 avec trois unités, Edition 12 avec une unité et Edition 19 avec six unités. Permuter deux quantités modifie l’action, même si l’ensemble des identifiants et l’ensemble des nombres restent identiques. La validation doit contrôler les relations, et pas seulement la présence des valeurs.

Définissez comment le processus représente une tentative portant sur un lot et son résultat vérifié. Ne supposez pas que le regroupement des exécutions de la place de marché est identique à celui de l’interface de transfert des jetons. Le compte doit utiliser les preuves fournies par le circuit réel pour déterminer quels changements prévus ont eu lieu.

La vérification d’un transfert ERC-1155 par lots doit aussi identifier le destinataire et l’exposition économique totale. Un lot peut simplifier une opération tout en aggravant les conséquences d’une erreur de destination ou de correspondance des quantités. La commodité ne dispense pas d’examiner chaque composante de la proposition présentant une différence substantielle.

Répartir les dépenses communes de façon transparente

Une opération combinée peut entraîner une dépense qui n’est pas accompagnée d’une ventilation distincte par type. Le registre a besoin d’une convention explicite de répartition pour l’analyse interne, tout en préservant le total réel. Une répartition égale par unité, une répartition selon la valeur d’achat et une imputation directe lorsqu’elle est possible répondent à des questions de reporting différentes.

Considérons l’achat hypothétique de deux types pour des valeurs de 0,20 et 0,80 ETH, avec une dépense commune de 0,05 ETH. Une répartition de la dépense selon la valeur d’achat attribue respectivement 0,01 et 0,04 ETH. Une division égale entre les types attribue 0,025 ETH à chacun. Aucun de ces calculs ne modifie le décaissement total de 1,05 ETH, mais les rapports de performance par type diffèrent.

Choisissez la convention avant de comparer les stratégies, documentez-la et appliquez-la de façon cohérente. Modifier la méthode pour améliorer l’apparence d’une position perdante rend l’analyse trompeuse, même si le total du compte reste juste. Conservez suffisamment de données brutes pour recalculer les rapports selon une autre convention raisonnable.

Gardez également visibles les frais des tentatives échouées. Si une tentative d’acquisition ne produit aucun stock mais entraîne des coûts, le projet a tout de même dépensé des ressources. Un rapport limité aux lots acquis avec succès sous-estimera la charge opérationnelle et peut faire paraître économiquement anodines de fréquentes tentatives infructueuses.

Modéliser la capacité de sortie pour la quantité prévue

Le prix d’une unité ne permet pas d’établir qu’une quantité plus importante peut être vendue aux mêmes conditions moyennes. Le processus doit évaluer le volume de cession prévu et la demande disponible des acheteurs pour ce volume. Une petite cotation attrayante peut ne concerner qu’une fraction de la position du compte.

Supposons que le compte détienne 20 unités hypothétiques. Les acheteurs proposent actuellement 0,10 ETH pour les deux premières unités, 0,08 ETH pour les trois suivantes, et aucune condition vérifiée pour le reste. Valoriser les 20 unités à 0,10 ETH suppose une demande que les éléments disponibles ne démontrent pas. L’enregistrement doit distinguer le produit de vente étayé du reliquat dont le sort reste indéterminé.

Utilisez plusieurs scénarios de récupération du capital dans les rapports sur les stocks. Un modèle peut montrer le résultat d’une vente rapide d’une petite quantité, d’une vente plus importante à des conditions moins favorables ou d’une conservation prolongée des unités invendues. Ce sont des scénarios, et non des promesses concernant la liquidité future.

La concentration des quantités compte même lorsque le prix unitaire semble modeste. Acheter à répétition la même édition peut immobiliser un capital substantiel face à un seul ensemble d’acheteurs. Une limite par ordre doit donc être complétée par une limite globale des avoirs et des engagements pour chaque type.

Conserver séparément le registre des autorisations du bot de trading ERC-1155

L’autorisation accordée à un opérateur dans la norme a une portée plus large qu’une seule opération décrite localement. Le processus doit afficher le contrat concerné et la partie autorisée, et expliquer la relation entre ce pouvoir et l’action prévue. Un prix attrayant ne justifie pas de sauter la vérification des autorisations.

Enregistrez les observations relatives aux autorisations séparément de l’état des ordres. Un ordre peut expirer tandis que le pouvoir accordé demeure, et désactiver la stratégie ne renseigne pas, à lui seul, sur l’état des autorisations. Le processus de vérification du compte doit rendre ces distinctions visibles pour la personne responsable du portefeuille.

Si le circuit d’exécution change, réévaluez les pouvoirs qu’il exige. Ne supposez pas qu’une autorisation observée précédemment s’applique de façon appropriée simplement parce que le nouveau circuit répond à un objectif similaire. Des identifiants vérifiés et les exigences actuelles doivent guider la décision.

La discussion plus générale du mandat dans le guide de l’agent de trading de NFT explique pourquoi la planification et les pouvoirs accordés ont besoin de contrôles distincts. Un agent qui tient compte des quantités peut proposer des actions utiles sur les stocks, mais son autorisation de les exécuter doit rester encadrée par des règles explicites concernant les actifs, les montants et les opérations.

Rapprocher les transferts externes et les variations de solde inattendues

L’historique des ordres du bot lui-même peut ne pas expliquer tous les mouvements du compte. Une personne peut utiliser une autre interface, un autre processus autorisé peut agir, ou un actif peut arriver en dehors du processus d’acquisition prévu. Le registre doit détecter la variation du solde et en rechercher l’origine plutôt que de la rattacher de force à l’opération connue la plus proche.

Ne classez un mouvement comme acquisition, cession, transfert de garde ou événement non résolu que lorsque les preuves étayent cette classification. Une quantité entrante n’est pas automatiquement un achat au prix actuel du marché. Une quantité sortante n’est pas automatiquement une vente dont le produit est égal à une cotation affichée.

Conservez l’observation d’origine et l’explication ultérieure. Si un écart de solde est résolu après examen, ajoutez les éléments justificatifs au lieu de remplacer silencieusement l’enregistrement. L’historique du compte devient ainsi utile pour diagnostiquer les problèmes récurrents de collecte de données ou de coordination des opérateurs.

Suspendez les nouvelles actions concernant le type en cause lorsque l’écart affecte la quantité disponible. Continuer à réserver ou à vendre des unités à partir d’un solde incertain peut créer des engagements contradictoires. Une surveillance indépendante peut se poursuivre pendant que le stock concerné reste en cours d’examen.

Tester les calculs de quantités dans les cas limites

Utilisez de petits exemples faciles à examiner avant d’augmenter le nombre de types ou d’unités. Incluez une quantité disponible nulle, un montant supérieur au solde vérifié, un ordre partiellement exécuté et deux propositions simultanées en concurrence pour les mêmes unités. Chaque cas teste une hypothèse différente du modèle de réservation.

Testez la manière dont les montants sont analysés et enregistrés. Une quantité ne doit pas être arrondie silencieusement pour devenir un montant autorisé différent. Si le circuit ou l’actif exige une unité entière et que la proposition contient une fraction non prise en charge, rejetez-la explicitement au lieu de deviner l’intention de l’utilisateur.

Un débutant peut étudier ces cas en parallèle d’un exercice du guide du bot NFT pour débutants. L’objectif est de rendre les changements d’état visibles avec des nombres simples, afin que l’opérateur puisse expliquer pourquoi le stock disponible a changé après chaque événement.

Conservez ces exemples comme jeu de tests de non-régression pour les modifications ultérieures. Un nouveau composant d’affichage ou un nouvel outil d’importation peut introduire des erreurs de quantité même si le code d’exécution n’a pas changé. Le test doit vérifier les relations significatives entre les montants détenus, réservés et exécutés, et pas simplement confirmer qu’un bouton apparaît toujours.

Clore la session par un rapprochement des quantités et de la trésorerie

Pour chaque type, reliez la quantité d’ouverture, les entrées vérifiées, les sorties vérifiées et la quantité de clôture. Rapprochez ensuite les mouvements de paiement et les frais associés. Ces deux vues répondent à des questions différentes et doivent être cohérentes avec les actions enregistrées sans être fusionnées en une seule estimation de valeur nette.

Examinez les différences avant de commencer une autre session. Un petit écart peut indiquer une exécution comptée en double, un transfert non enregistré ou une erreur d’analyse des données. Le reporter à répétition rend les rapprochements ultérieurs plus difficiles, car chaque nouvelle action dépend d’un solde de départ déjà incertain.

Conservez le stock invendu séparément des résultats réalisés. Une valorisation hypothétique attribuée aux unités restantes n’est pas de la trésorerie récupérée. Les rapports doivent expliquer quelle part de la valeur apparente de la stratégie dépend d’une estimation portant sur des actifs qui ont encore besoin de trouver des acheteurs.

La note de fin de session doit identifier les ordres non résolus, les quantités réservées et les éventuels changements d’autorisations qui restent pertinents. Une boucle de trading sans activité ne constitue pas un état complet du compte. L’opérateur a besoin de suffisamment d’informations pour redémarrer de façon cohérente sans redécouvrir ce que la session précédente avait prévu.

Questions fréquentes sur le trading d’éditions

Un identifiant de jeton signifie-t-il toujours une seule unité ?

Non. Le modèle du compte doit préserver la quantité observée associée au type de jeton. Traiter l’identifiant comme la détention d’un objet unique peut fausser le stock et la capacité à passer des ordres. Utilisez la signification réelle de l’actif et du circuit plutôt que de déduire la quantité de la manière dont une place de marché affiche l’image.

Un lot est-il toujours plus avantageux économiquement ?

Pas nécessairement. Un lot peut modifier les frais d’exécution et la complexité opérationnelle, mais le résultat dépend du circuit réel et du contenu proposé. Comparez les coûts complets et les conséquences d’une action échouée ou erronée. La commodité seule ne suffit pas à établir un meilleur résultat économique.

Puis-je tout vendre au dernier prix unitaire ?

Un prix unitaire passé ne permet pas d’établir la demande actuelle pour la totalité des avoirs. Examinez les conditions exécutables pour la quantité prévue et laissez clairement apparaître l’incertitude du produit de vente non étayé. Les positions importantes sur des éditions peuvent nécessiter un plan de sortie différent de celui que suggère une petite transaction récente.

Quel est le premier contrôle le plus important ?

Confirmez que le processus distingue le type de jeton, la quantité et la base de tarification. Vérifiez ensuite que les montants détenus et réservés se rapprochent après un résultat partiel. Ces fondamentaux donnent du sens à l’analyse ultérieure des coûts et des stocks. Une valorisation sophistiquée ne peut pas réparer un modèle de compte qui ignore combien d’unités il contrôle réellement.