MatchBook en neuf minutes : transcription

Où vit un order book sur Solana, comment les ordres y arrivent, et qui paie chaque opération ? Regarde cette page. C'est un order book, un carnet d'ordres : la liste de ceux qui veulent acheter, de ceux qui veulent vendre, et à quel prix. Il ne s'arrête jamais de bouger, mais personne ne clique : ce sont huit bots. Cinq jouent les market makers, et trois simulent les clients, des particuliers et des entreprises qui achètent et vendent selon leurs besoins.

C'est un marché d'exemple, MBK contre tUSD, que QuantStratum a monté sur Solana pour montrer ce qu'il sait construire. Et toi, tu peux y entrer pour trader. Tu vas voir où vit le carnet, comment les ordres y arrivent, où est l'argent de chacun et qui est payé pour quoi. MatchBook est open source et vient de publier sa version un point zéro. Attention quand même : il n'est pas encore audité, alors, avec de l'argent réel, uniquement ce que tu peux te permettre de perdre.

Commençons par l'endroit où il vit. MatchBook est un smart contract, ce que Solana appelle un programme : du code qui vit sur la chaîne et ne garde aucune donnée lui-même, parce que les données vont dans des comptes. Chaque marché est un seul compte de données, et tout va dedans : les ordres d'achat, les ordres de vente et la place de chaque trader, qu'il appelle un seat. Le carnet que tu vois sur la page, c'est littéralement le contenu de ce compte.

S'il se remplit, le compte grandit. Aujourd'hui, le marché de la démo occupe neuf mille deux cents octets.

Comment un ordre arrive-t-il jusqu'à MatchBook ? Tu appuies sur acheter sur la page, et ton wallet signe une transaction qui dit, par exemple : achète un MBK à cent. La page l'envoie à un nœud RPC, le serveur par lequel la page, l'API et les bots de MatchBook parlent à Solana. Le nœud la transmet au validateur qui est en train d'écrire le bloc, l'un des ordinateurs qui traitent les transactions du réseau. Ce validateur exécute le code de MatchBook sur le compte du marché.

Si personne ne vend à ce prix, ton ordre reste dans le carnet, en attente. Si quelqu'un vend, l'opération se conclut sur-le-champ, et les deux soldes changent dans cette même transaction. Dans certains carnets de Solana, le vendeur est payé plus tard, quand quelqu'un exécute une étape à part qu'on appelle le crank ; dans MatchBook, cette étape n'existe pas. Et si quelque chose échoue, le marché reste tel qu'il était.

Et où est l'argent de chacun ? Allons-y par étapes. Ton SOL est sur ton propre compte, celui de ton adresse. Les autres tokens, comme MBK ou tUSD, vont dans des comptes à part, un par token, liés à ton adresse. Le marché a deux coffres-forts, un par token, dont la clé appartient au smart contract lui-même, pas à une personne. Quand tu déposes, tes tokens passent dans ces coffres, et le marché le note dans ton seat : combien tu as de libre et combien est bloqué dans des ordres.

Quand tu retires, ils reviennent sur ton compte ; et seul le propriétaire du seat peut retirer. Si tu passes un ordre, son montant passe de libre à bloqué ; si tu l'annules, il redevient libre. Tu peux aussi trader sans seat, avec un swap : les tokens sortent et arrivent directement sur tes comptes de token.

Et les bots ? Ce sont des programmes qui tournent sur un serveur hors de la chaîne, et chacun a son propre wallet : sa clé privée est dans un fichier sur ce serveur. Les cinq market makers utilisent des modèles de market-maker-rs, une bibliothèque open source : Avellaneda-Stoikov, GLFT, un spread adaptatif et une grille. Leur solde n'est pas sur le serveur, mais sur Solana : le SOL pour les frais, dans leur wallet, et leurs tokens, dans leur seat à l'intérieur du marché.

En face, il y a les trois autres, qui simulent les clients : des particuliers et des entreprises qui achètent ou vendent selon leurs besoins, certains d'un coup et au marché, d'autres en suivant la tendance, et d'autres avec des ordres à leur prix. Les deux premiers gardent leurs tokens sur leurs propres comptes de token et tradent avec des swaps ; le troisième a un seat, comme les makers. Toutes les quelques secondes, un market maker lit son seat sur la chaîne, et c'est son inventaire : combien de MBK et de tUSD il détient.

À partir de là, il calcule et place une échelle d'ordres de chaque côté, et la renouvelle d'un seul coup. Il a commencé avec quatre cents MBK ; s'il en accumule plus, il baisse ses prix pour vendre, et s'il dépasse sa limite, il arrête d'acheter. Cet argent de départ est créé par un wallet d'administration, et toutes les quatre-vingt-dix secondes, un trésorier renfloue ceux qui sont à court. En production, chaque market maker apporterait son propre capital, et pourrait trader avec une clé limitée, qui trade mais ne retire jamais.

Et toi, comment tu entres ? Tu installes un wallet Solana dans ton navigateur, comme Phantom ou Solflare, tu le passes sur devnet et tu le connectes. Avec le faucet de la page, tu reçois vingt-cinq MBK, deux mille cinq cents tUSD et, s'il t'en manque, un peu de SOL pour les frais. Tu peux acheter ou vendre tout de suite avec un swap, ou fixer ton prix avec un ordre limite ; la première fois, cette même transaction t'ouvre ton seat et dépose tes tokens.

Ensuite, tu annules, ou tu retires tout vers ton wallet. Chaque étape te demande de signer, et ta clé privée ne quitte jamais ton wallet. Et en programmant, il y a plus, comme des stops ou des ordres qui se replacent tout seuls.

Et pourquoi tout ça coûte du SOL ? Parce que dans MatchBook, tout ce que tu fais est une transaction signée par ton wallet : déposer, passer un ordre, l'annuler, un swap ou un retrait. Et chaque transaction paie le validateur qui exécute le code de MatchBook : cinq mille lamports par signature, cinq millionièmes de SOL. La moitié est brûlée et l'autre moitié va au validateur ; MatchBook n'en garde rien. En plus, ton ordre occupe une case dans le compte du marché.

S'il n'en reste plus de libre, le compte grandit, et celui qui le fait grandir laisse un dépôt pour cet espace, ce que Solana appelle le rent : moins d'un demi-millième de SOL par case. La première fois, il te faut aussi tes comptes MBK et tUSD, chacun avec son propre dépôt, que le faucet paie dans la démo ; c'est pour ça qu'il te donne un peu de SOL. Quand le réseau est chargé, tu peux ajouter des frais de priorité, facturés selon le calcul utilisé, et là, MatchBook consomme peu : environ mille trois cents unités par ordre, alors que d'autres carnets en utilisent entre mille neuf cents et dix-huit mille.

Pour celui qui opère MatchBook, les coûts sont le déploiement du smart contract, environ un SOL et demi, le dépôt du marché, et les transactions des bots, qui renouvellent leurs ordres toutes les quelques secondes : entre un demi SOL et un SOL par jour. Et à part, il y a la commission du marché lui-même, qui ne se paie pas en SOL mais en tUSD : celui qui prend de la liquidité paie zéro virgule un pour cent ; un cinquième va au market maker et le reste au propriétaire du marché.

Et qu'est-ce qu'il faut pour le faire tourner ? Sur la chaîne, seulement deux choses : le smart contract et le compte du marché. En dehors, quelques conteneurs avec la page, une API et les bots, qui lisent et écrivent dans le marché via un nœud RPC ; avec huit bots, le RPC public de devnet ne suffit pas, et mieux vaut en prendre un payant. L'API surveille le compte du marché et le retransmet à tous les navigateurs, et elle enregistre les opérations pour dessiner le graphique.

La page ne fait qu'afficher le carnet : le vrai carnet est sur la chaîne.

Et qui en a besoin ? Un exchange ou une app de trading qui veut ses propres marchés, ou un projet qui veut un carnet d'ordres pour son token. Un agrégateur, qui cherche le meilleur prix entre les marchés et peut ici le calculer exactement, parce que le kit de développement utilise le même moteur que la chaîne. Une firme de market making, pour qui renouveler ses ordres coûte peu. Ou un wallet, qui peut proposer des swaps à ses utilisateurs.

Et autour, on peut construire des interfaces de trading, des stratégies qui tournent toutes seules, des stop-loss sans serveurs qui surveillent, ou des tableaux de bord d'analyse. Et si tu veux construire quelque chose comme ça, QuantStratum peut t'aider, parce que tout ce que tu as vu, c'est nous qui l'avons monté sur MatchBook : le marché, les cinq market makers avec leurs modèles, les clients simulés, le trésorier, l'API et la page en direct, et son déploiement.

En résumé : l'order book de MatchBook est un compte Solana, et le matching, un smart contract. Chaque action est une transaction que tu paies en SOL au validateur, plus un dépôt si tu occupes un nouvel espace. Ton ordre voyage, signé, jusqu'à un validateur, et se règle dans cette même transaction. Tes tokens sont sur tes comptes ou, si tu déposes, dans les coffres du marché, notés dans ton seat ; exactement comme ceux des bots.

Va sur matchbook point quantstratum point com, connecte ton wallet sur devnet, et essaie. Et si tu veux le tien, on connaît chaque pièce, du compte du marché jusqu'au dernier bot. Parle-nous de ton projet sur quantstratum point com.