Retour au blog
StreamingFast

Faire évoluer le développement agentique de Substreams : un registre lisible par machine, des compétences de codage IA et l'accès aux comptes pour agents

Substreams est le framework de StreamingFast pour l'indexation des données blockchain : il permet aux développeurs d'extraire, transformer et diffuser des données on-chain en temps réel plutôt que de construire des indexeurs sur mesure à partir de zéro. Les agents de codage IA sont de plus en plus ceux qui écrivent le code Substreams, câblent les modules et interrogent les données blockchain pour le compte d'un développeur. Ce basculement change ce que signifie une « bonne expérience développeur » : ce n'est plus seulement une documentation qu'un humain peut parcourir, ce sont des surfaces structurées et lisibles par machine qu'un agent peut découvrir et exploiter de façon autonome. Ces derniers mois, nous avons publié une série de changements pensés précisément pour ce public, d'un registre lisible par machine à des packs de compétences qui donnent directement l'expertise Substreams aux agents, jusqu'à l'accès agentique aux comptes. Voici les nouveautés.

Ce qui a été publié :

  • Une spécification OpenAPI lisible par machine pour le registre substreams.dev, permettant aux agents de rechercher et récupérer des packages Substreams par programmation plutôt qu'en scrapant du HTML.
  • Substreams Skills : 9 packs de connaissances open source pour donner à votre agent de codage préféré une expertise Substreams intégrée.
  • Un accès agentique à thegraph.market, permettant aux agents de vérifier l'usage, de gérer l'authentification via des clés API et de superviser les déploiements de sink sans qu'un humain ait à se connecter à un tableau de bord.

Substreams Skills pour Claude Code, Cursor et VS Code

Substreams Skills sont des packs de connaissances open source qui donnent aux assistants de codage IA une expertise Substreams poussée, prête à l'emploi. Installez-les une fois, et votre assistant — Claude Code, Cursor ou VS Code — applique automatiquement les bonnes pratiques Substreams au lieu de deviner la syntaxe ou de réinventer des schémas déjà connus. Pour les modules Rust en particulier, ce n'est pas un détail : un agent qui n'a pas besoin de se battre vingt minutes avec le borrow checker avant de compiler fait bien plus que de l'autocomplétion.

Le pack se présente actuellement sous forme de 9 skills couvrant l'ensemble du flux de travail, du décodage spécifique à chaque chaîne jusqu'au déploiement en production :

  • Substreams Development — manifests multi-chaînes, graphes de modules et conception de schémas protobuf
  • Substreams Ethereum & Substreams Solana — décodage spécifique à la chaîne (génération d'ABI et décodage d'événements sur EVM ; parsing d'instructions et de comptes sur Solana)
  • Substreams SQL — sinks vers des bases SQL pour PostgreSQL et ClickHouse
  • Substreams Sink — consommation de la sortie Substreams en Go, JavaScript, Python ou Rust
  • Substreams Sink Deployment (Self-Managed) — exécuter des sinks vous-même sur votre propre infrastructure
  • Substreams Hosted Sink — déployer des sinks sur l'infrastructure hébergée par StreamingFast plutôt que de gérer la vôtre
  • The Graph Market API — gestion en langage naturel de la facturation, de l'usage et des déploiements sur l'API Portal de thegraph.market, ainsi que le flux d'authentification associé
  • Substreams Testing — tests unitaires, d'intégration, de performance et d'intégration continue

Installez le pack en tant que plugin Claude Code (claude plugin install substreams-dev@streamingfast-substreams) et les skills restent à jour automatiquement ; Cursor et VS Code 1.107+ les prennent aussi en charge, via un chemin de répertoire local.

Les skills sont également conçus pour interroger directement le registre substreams.dev, afin que votre agent réutilise des modules éprouvés de StreamingFast, de Pinax et des équipes derrière les protocoles eux-mêmes, plutôt que de reconstruire un package Substreams à partir de zéro. Résultat : des builds plus rapides, et des pipelines qui s'assemblent avec ce qui existe déjà au lieu de le dupliquer. Ce qui prenait des jours — mettre en place un pipeline de données blockchain en production — ne prend désormais qu'un prompt en langage naturel et quelques minutes.

Accès agentique à thegraph.market

L'accès agentique à thegraph.market est désormais disponible, donnant aux agents IA la capacité de récupérer directement les données d'usage et de clés API, sans obliger un développeur à se connecter et à consulter un tableau de bord manuellement.

Cela comble une vraie lacune : un agent pouvait déjà découvrir et interroger des packages Substreams, mais il n'avait aucun moyen de vérifier si vous étiez sur le point d'atteindre une limite de débit, quelle clé utiliser, comment une tâche donnée était facturée sur votre compte, ou de gérer directement vos déploiements Hosted Services — mettre à l'échelle un sink, vérifier son retard, ou le redéployer après un changement. Maintenant il le peut, sans que vous quittiez votre terminal ou votre fenêtre de chat. Un pas de plus vers des flux de travail agentiques qui s'exécutent de bout en bout, de l'écriture du code à la gestion du compte et de l'infrastructure qui le sous-tend.

Vos identifiants restent également hors du circuit : l'agent ne voit ni ne manipule jamais votre mot de passe. L'authentification se déroule entièrement au sein de thegraph.market ; l'agent agit en votre nom via votre clé API, mais le mot de passe lui-même ne transite jamais par l'agent et ne lui est jamais exposé.

En pratique, cela signifie que vous pouvez demander à votre agent des choses comme :

  • « Quel est notre usage ce mois-ci, et quel service en est le principal responsable ? » — l'agent récupère l'usage détaillé par clé API et par service, sans tableau de bord requis.
  • « Sommes-nous sur le point d'atteindre notre limite de débit, et devrions-nous passer à un forfait supérieur ? » — il vérifie l'usage actuel par rapport à votre forfait et vous donne une réponse claire avant qu'une tâche échoue en cours d'exécution.
  • « Mon sink tourne-t-il toujours, et quel est son retard ? » — il vérifie directement le statut du déploiement et le retard par rapport à la tête de chaîne, et peut le mettre à l'échelle ou le redéployer si vous le demandez.

Chacune de ces questions nécessitait auparavant de se connecter soi-même à thegraph.market. Désormais, il suffit d'un prompt.

Un registre substreams.dev lisible par machine

Le registre substreams.dev publie désormais une spécification OpenAPI complète, facilitant pour les agents de codage IA le crawl, le parsing et le raisonnement sur les packages Substreams par programmation. La spécification est disponible à substreams.dev/v1/registry/openapi.yaml et décrit chaque endpoint du registre dans un format structuré qu'un agent de codage peut lire directement.

Plutôt que de scraper du HTML ou de deviner la forme des requêtes, un agent peut récupérer la spécification une seule fois et savoir exactement comment rechercher des packages Substreams existants, inspecter leurs modules et récupérer les artefacts nécessaires pour construire dessus.

Par exemple, un agent peut interroger directement le registre :

GET https://substreams.dev/v1/registry/packages?query=uniswap&network=mainnet

et obtenir en retour des résultats structurés qu'il peut exploiter immédiatement, sans aucun parsing HTML :

{
  "packages": [
    {
      "name": "Uniswap v3",
      "slug": "uniswap-v3",
      "organization": { "name": "Pinax", "slug": "pinax" },
      "network": "mainnet",
      "latestVersion": "v0.1.0",
      "downloads": 1234,
      "spkg": "https://substreams.dev/pinax/uniswap-v3/v0.1.0/uniswap-v3-v0.1.0.spkg",
      "reference": "uniswap-v3@v0.1.0"
    }
  ],
  "hasMore": false
}

La réponse est volontairement scindée en deux façons de référencer le même package : spkg est l'URL complète qu'un agent transmet directement à substreams run <spkg> <module> pour l'exécuter, tandis que reference est la forme courte et lisible slug@version qu'il utilise pour vous afficher une commande. Un agent peut passer de « existe-t-il déjà un package Uniswap pour mainnet ? » à son exécution en un seul aller-retour.

En pratique, cela signifie que lorsque vous demandez à un agent de trouver un package Substreams pour une chaîne ou un cas d'usage donné, ou de vérifier si un package existe déjà avant d'en écrire un nouveau, il dispose d'un chemin fiable et structuré vers la réponse, plutôt que de se rabattre sur des données d'entraînement obsolètes.

Common Questions, désormais à double usage

La section Common Questions de ce blog a été conçue pour des réponses rapides et directes, et il s'avère que ce format est exactement ce dont les agents IA ont besoin également. Elle a été conçue à l'origine pour aider les développeurs humains à obtenir rapidement des réponses aux questions qui reviennent sans cesse : comment les modules se connectent, ce qu'exige un manifest, comment fonctionnent les sinks.

Un Q&A bien délimité et direct est bien plus facile à récupérer et à exploiter pour un agent qu'un tutoriel long format. À mesure que les agents effectuent de plus en plus la première passe de recherche avant d'écrire du code, cette section remplit un double rôle : orienter à la fois les nouveaux développeurs et leurs agents IA vers les bons schémas plutôt que vers des suppositions. C'est un petit exemple d'un principe plus large : un contenu structuré pour bien répondre à une question précise sert aussi bien les humains que les agents.

Pris ensemble, ces changements pointent vers une même idée : le développement Substreams devient plus rapide non pas parce que le pipeline de données sous-jacent a changé, mais parce que les surfaces qui l'entourent — le registre, la couche compte, la documentation — sont désormais conçues à la fois pour les humains et pour les agents qui travaillent à leurs côtés.

Prêt à mettre un agent IA au travail sur votre propre projet Substreams ? Installez Substreams Skills pour donner à votre assistant une expertise Substreams prête à l'emploi, puis laissez-le parcourir le registre substreams.dev pour trouver un package existant pour votre chaîne, ou consultez nos Common Questions pour les schémas dont votre agent a besoin pour démarrer.