Maison développement back-end Golang Un batcher de transactions Starknet

Un batcher de transactions Starknet

Dec 31, 2024 pm 05:54 PM

Abstrait

Cet article présente le batcher de transactions utilisé dans Metacube pour envoyer instantanément les NFT gagnés par les joueurs. Il explique l'architecture évolutive basée sur les acteurs du batcher et fournit une implémentation détaillée dans Go.

Tous les extraits de code sont disponibles dans le dépôt GitHub associé.

Architecture

A Starknet transactions batcher

The Batcher est composé de deux acteurs principaux :

  • Le Builder reçoit les transactions, les regroupe en une seule transaction multiappel et l'envoie à l'acteur expéditeur.
  • Le Expéditeur finalise la transaction avec les champs appropriés (nonce, frais maximum, etc.), la signe, l'envoie au réseau Starknet et surveille son statut.

Cette séparation des acteurs permet d'avoir un batcher évolutif et efficace. Le constructeur prépare les transactions pendant que l'expéditeur les envoie, permettant un flux de transactions continu et efficace.

Mise en œuvre

L'implémentation suivante est spécifique à Go, mais les concepts peuvent facilement être adaptés à d'autres langages, car les fonctionnalités restent les mêmes.

Par ailleurs, notez que cette implémentation est spécifique à l’envoi de NFT issus d’un même contrat. Cependant, une approche plus générique est mentionnée plus loin dans l'article.

Enfin, le code est basé sur la bibliothèque starknet.go développée par Nethermind.

Doseur

Commençons par le Batcher lui-même :

type Batcher struct {
    accnt           *account.Account
    contractAddress *felt.Felt
    maxSize         int
    inChan          <-chan []string
    failChan        chan<- []string
}
Copier après la connexion
Copier après la connexion

Le compte (accnt) est celui qui détient les NFT, il servira à signer les transactions qui les transfèrent. Ces NFT font partie du même contrat, d'où le champ contractAddress. Le champ maxSize correspond à la taille maximale d'un lot et inChan est le canal par lequel les transactions sont envoyées au Batcher. Le failChan est utilisé pour renvoyer les transactions qui n'ont pas pu être envoyées.

Notez que, dans cette implémentation, les données de transaction appelées plus tard ([]string) sont un tableau de deux éléments : l'adresse du destinataire et l'identifiant NFT.

Le Batcher exécute simultanément les acteurs Builder et Sender :

type TxnDataPair struct {
    Txn  rpc.BroadcastInvokev1Txn
    Data [][]string
}

func (b *Batcher) Run() {
    txnDataPairChan := make(chan TxnDataPair)

    go b.runBuildActor(txnDataPairChan)
    go b.runSendActor(txnDataPairChan)
}
Copier après la connexion
Copier après la connexion

Le canal défini txnDataPairChan envoie les paires de données de transaction du Builder à l'expéditeur. Chaque paire de données de transaction comprend la transaction par lots et les données de chaque transaction y sont intégrées. Les données de chaque transaction sont envoyées avec la transaction par lots afin que les transactions ayant échoué puissent être renvoyées à l'entité qui instancie le Batcher.

Constructeur

Analysons l'acteur Build. A noter que le code est simplifié pour une meilleure lisibilité (code complet) :

type Batcher struct {
    accnt           *account.Account
    contractAddress *felt.Felt
    maxSize         int
    inChan          <-chan []string
    failChan        chan<- []string
}
Copier après la connexion
Copier après la connexion

La fonction runBuildActor est la boucle d'événements de l'acteur Builder. Il attend que les transactions soient envoyées au Batcher et crée une transaction par lots lorsque le lot est plein ou qu'un délai d'attente est atteint. La transaction par lots est ensuite envoyée à l'acteur Expéditeur.

Expéditeur

Analysons maintenant l'acteur Sender. A noter que le code est simplifié pour une meilleure lisibilité (code complet) :

type TxnDataPair struct {
    Txn  rpc.BroadcastInvokev1Txn
    Data [][]string
}

func (b *Batcher) Run() {
    txnDataPairChan := make(chan TxnDataPair)

    go b.runBuildActor(txnDataPairChan)
    go b.runSendActor(txnDataPairChan)
}
Copier après la connexion
Copier après la connexion

La fonction runSendActor est la boucle d'événements de l'acteur expéditeur. Il attend que le constructeur envoie des transactions par lots, les signe, les envoie au réseau Starknet et surveille leur statut.

Une note sur l'estimation des frais : on peut estimer le coût des frais de la transaction par lots avant de l'envoyer. Le code suivant peut être ajouté après la signature de la transaction :

// This function builds a function call from the transaction data.
func (b *Batcher) buildFunctionCall(data []string) (*rpc.FunctionCall, error) {
    // Parse the recipient address
    toAddressInFelt, err := utils.HexToFelt(data[0])
    if err != nil {
        ...
    }

    // Parse the NFT ID
    nftID, err := strconv.Atoi(data[1])
    if err != nil {
        ...
    }

    // The entry point is a standard ERC721 function
    // https://docs.openzeppelin.com/contracts-cairo/0.20.0/erc721
    return &rpc.FunctionCall{
        ContractAddress: b.contractAddress,
        EntryPointSelector: utils.GetSelectorFromNameFelt(
            "safe_transfer_from",
        ),
        Calldata: []*felt.Felt{
            b.accnt.AccountAddress, // from
            toAddressInFelt, // to
            new(felt.Felt).SetUint64(uint64(nftID)), // NFT ID
            new(felt.Felt).SetUint64(0), // data -> None
            new(felt.Felt).SetUint64(0), // extra data -> None
        },
    }, nil
}

// This function builds the batch transaction from the function calls.
func (b *Batcher) buildBatchTransaction(functionCalls []rpc.FunctionCall) (rpc.BroadcastInvokev1Txn, error) {
    // Format the calldata (i.e., the function calls)
    calldata, err := b.accnt.FmtCalldata(functionCalls)
    if err != nil {
        ...
    }

    return rpc.BroadcastInvokev1Txn{
        InvokeTxnV1: rpc.InvokeTxnV1{
            MaxFee:        new(felt.Felt).SetUint64(MAX_FEE),
            Version:       rpc.TransactionV1,
            Nonce:         new(felt.Felt).SetUint64(0), // Will be set by the send actor
            Type:          rpc.TransactionType_Invoke,
            SenderAddress: b.accnt.AccountAddress,
            Calldata:      calldata,
        },
    }, nil
}

// Actual Build actor event loop
func (b *Batcher) runBuildActor(txnDataPairChan chan<- TxnDataPair) {
    size := 0
    functionCalls := make([]rpc.FunctionCall, 0, b.maxSize)
    currentData := make([][]string, 0, b.maxSize)

    for {
        // Boolean to trigger the batch building
        trigger := false

        select {
        // Receive new transaction data
        case data, ok := <-b.inChan:
            if !ok {
                ...
            }

            functionCall, err := b.buildFunctionCall(data)
            if err != nil {
                ...
            }

            functionCalls = append(functionCalls, *functionCall)
            size++
            currentData = append(currentData, data)

            if size >= b.maxSize {
                // The batch is full, trigger the building
                trigger = true
            }

        // We don't want a smaller batch to wait indefinitely to be full, so we set a timeout to trigger the building even if the batch is not full
        case <-time.After(WAITING_TIME):
            if size > 0 {
                trigger = true
            }
        }

        if trigger {
            builtTxn, err := b.buildBatchTransaction(functionCalls)
            if err != nil {
                ...
            } else {
                // Send the batch transaction to the Sender
                txnDataPairChan <- TxnDataPair{
                    Txn:  builtTxn,
                    Data: currentData,
                }
            }

            // Reset variables
            size = 0
            functionCalls = make([]rpc.FunctionCall, 0, b.maxSize)
            currentData = make([][]string, 0, b.maxSize)
        }
    }
}
Copier après la connexion

Cela peut être utile pour s'assurer que les frais ne sont pas trop élevés avant d'envoyer la transaction. Si les frais estimés sont plus élevés que prévu, il peut également être nécessaire de réajuster le champ des frais maximum de la transaction si les frais estimés sont plus élevés que prévu. Mais notez que lorsque toute modification est apportée à la transaction, celle-ci doit être à nouveau signée !

Cependant, notez que vous pourriez rencontrer des problèmes lors de l'estimation des frais si le débit des transactions est assez élevé. En effet, lorsqu'une transaction donnée vient d'être approuvée, la mise à jour du nom occasionnel du compte prend un peu de temps. Par conséquent, lors de l’estimation des frais pour la prochaine transaction, elle peut échouer, en pensant que le nonce est toujours le précédent. Donc, si vous souhaitez toujours estimer les frais, vous devrez peut-être prévoir un peu de sommeil entre chaque transaction pour éviter de tels problèmes.

Vers un batcher générique

Le batcher présenté est spécifique à l'envoi de NFT issus d'un même contrat. Cependant, l'architecture peut facilement être adaptée pour envoyer tout type de transaction.

Premièrement, les données de transaction envoyées au Batcher doivent être plus génériques et donc contenir plus d'informations. Ils doivent contenir l'adresse du contrat, le sélecteur de point d'entrée et les données d'appel. La fonction buildFunctionCall doit alors être adaptée pour analyser ces informations.

On pourrait également aller plus loin en rendant le compte expéditeur générique. Cela nécessiterait davantage de refactorisation, car les transactions doivent être regroupées par compte expéditeur. Cependant, cela est réalisable et permettrait un doseur plus polyvalent.

N'oubliez pas cependant qu'une optimisation prématurée est la racine de tous les maux. Par conséquent, si vous avez juste besoin d'envoyer des NFT ou un token spécifique tel que ETH ou STRK, le batcher présenté est largement suffisant.

Outil CLI

Le code du référentiel peut être utilisé comme outil CLI pour envoyer un tas de NFT par lot. L'outil est simple à utiliser et vous devriez pouvoir l'adapter à vos besoins après avoir lu cet article. Veuillez vous référer au fichier README pour plus d'informations.

Conclusion

J'espère que cet article vous a aidé à mieux comprendre comment Metacube envoie des NFT à ses joueurs. Le batcher est un composant clé de l’infrastructure et nous sommes heureux de le partager avec la communauté. Si vous avez des questions ou des commentaires, n'hésitez pas à commenter ou à me contacter. Merci d'avoir lu !

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!

Déclaration de ce site Web
Le contenu de cet article est volontairement contribué par les internautes et les droits d'auteur appartiennent à l'auteur original. Ce site n'assume aucune responsabilité légale correspondante. Si vous trouvez un contenu suspecté de plagiat ou de contrefaçon, veuillez contacter admin@php.cn

Outils d'IA chauds

Undresser.AI Undress

Undresser.AI Undress

Application basée sur l'IA pour créer des photos de nu réalistes

AI Clothes Remover

AI Clothes Remover

Outil d'IA en ligne pour supprimer les vêtements des photos.

Undress AI Tool

Undress AI Tool

Images de déshabillage gratuites

Clothoff.io

Clothoff.io

Dissolvant de vêtements AI

Video Face Swap

Video Face Swap

Échangez les visages dans n'importe quelle vidéo sans effort grâce à notre outil d'échange de visage AI entièrement gratuit !

Article chaud

<🎜>: Bubble Gum Simulator Infinity - Comment obtenir et utiliser les clés royales
4 Il y a quelques semaines By 尊渡假赌尊渡假赌尊渡假赌
<🎜>: Grow A Garden - Guide de mutation complet
3 Il y a quelques semaines By DDD
Nordhold: Système de fusion, expliqué
4 Il y a quelques semaines By 尊渡假赌尊渡假赌尊渡假赌
Mandragora: Whispers of the Witch Tree - Comment déverrouiller le grappin
3 Il y a quelques semaines By 尊渡假赌尊渡假赌尊渡假赌

Outils chauds

Bloc-notes++7.3.1

Bloc-notes++7.3.1

Éditeur de code facile à utiliser et gratuit

SublimeText3 version chinoise

SublimeText3 version chinoise

Version chinoise, très simple à utiliser

Envoyer Studio 13.0.1

Envoyer Studio 13.0.1

Puissant environnement de développement intégré PHP

Dreamweaver CS6

Dreamweaver CS6

Outils de développement Web visuel

SublimeText3 version Mac

SublimeText3 version Mac

Logiciel d'édition de code au niveau de Dieu (SublimeText3)

Sujets chauds

Tutoriel Java
1672
14
Tutoriel PHP
1277
29
Tutoriel C#
1257
24
Golang vs Python: performance et évolutivité Golang vs Python: performance et évolutivité Apr 19, 2025 am 12:18 AM

Golang est meilleur que Python en termes de performances et d'évolutivité. 1) Les caractéristiques de type compilation de Golang et le modèle de concurrence efficace le font bien fonctionner dans des scénarios de concurrence élevés. 2) Python, en tant que langue interprétée, s'exécute lentement, mais peut optimiser les performances via des outils tels que Cython.

Golang et C: concurrence vs vitesse brute Golang et C: concurrence vs vitesse brute Apr 21, 2025 am 12:16 AM

Golang est meilleur que C en concurrence, tandis que C est meilleur que Golang en vitesse brute. 1) Golang obtient une concurrence efficace par le goroutine et le canal, ce qui convient à la gestion d'un grand nombre de tâches simultanées. 2) C Grâce à l'optimisation du compilateur et à la bibliothèque standard, il offre des performances élevées près du matériel, adaptées aux applications qui nécessitent une optimisation extrême.

Partage avec Go: un guide du débutant Partage avec Go: un guide du débutant Apr 26, 2025 am 12:21 AM

GOISIDEALFORBEGINNERNERS et combinant pour pourcloudandNetWorkServicesDuetOtssimplicity, Efficiency, andCurrencyFeatures.1) InstallgofromTheofficialwebsiteandverifywith'goversion'..2)

Golang vs C: Performance et comparaison de la vitesse Golang vs C: Performance et comparaison de la vitesse Apr 21, 2025 am 12:13 AM

Golang convient au développement rapide et aux scénarios simultanés, et C convient aux scénarios où des performances extrêmes et un contrôle de bas niveau sont nécessaires. 1) Golang améliore les performances grâce à des mécanismes de collecte et de concurrence des ordures, et convient au développement de services Web à haute concurrence. 2) C réalise les performances ultimes grâce à la gestion manuelle de la mémoire et à l'optimisation du compilateur, et convient au développement du système intégré.

Golang vs Python: différences et similitudes clés Golang vs Python: différences et similitudes clés Apr 17, 2025 am 12:15 AM

Golang et Python ont chacun leurs propres avantages: Golang convient aux performances élevées et à la programmation simultanée, tandis que Python convient à la science des données et au développement Web. Golang est connu pour son modèle de concurrence et ses performances efficaces, tandis que Python est connu pour sa syntaxe concise et son écosystème de bibliothèque riche.

Golang et C: les compromis en performance Golang et C: les compromis en performance Apr 17, 2025 am 12:18 AM

Les différences de performance entre Golang et C se reflètent principalement dans la gestion de la mémoire, l'optimisation de la compilation et l'efficacité du temps d'exécution. 1) Le mécanisme de collecte des ordures de Golang est pratique mais peut affecter les performances, 2) la gestion manuelle de C et l'optimisation du compilateur sont plus efficaces dans l'informatique récursive.

La course de performance: Golang vs C La course de performance: Golang vs C Apr 16, 2025 am 12:07 AM

Golang et C ont chacun leurs propres avantages dans les compétitions de performance: 1) Golang convient à une concurrence élevée et à un développement rapide, et 2) C fournit des performances plus élevées et un contrôle fin. La sélection doit être basée sur les exigences du projet et la pile de technologie d'équipe.

Golang contre Python: les avantages et les inconvénients Golang contre Python: les avantages et les inconvénients Apr 21, 2025 am 12:17 AM

GolangisidealforBuildingsCalableSystemsDuetoitSefficiency and Concurrency, tandis que les Implicites de l'Indrecosystem et le Golang'sDesignenCourageSlecElNCORES

See all articles