Circle Skills est une bibliothèque open-source de conseils pour travailler avec les produits Circle. Apprenez à créer une application USDC inter-chaînes avec Claude et Circle Skills.
Utiliser des prompts avec un assistant IA semble souvent simple. Vous décrivez ce que vous souhaitez créer, et il vous fournit quelque chose qui semble utilisable.
Mais une fois que vous dépassez les petites tâches, les lacunes commencent à apparaître. Le prompt peut être clair, mais l’implémentation sous-jacente ne l’est pas. Il reste des décisions à prendre concernant la structure de l’application, les outils à utiliser et la configuration appropriée.
Cela devient plus visible dans les flux de travail qui couvrent plusieurs systèmes. L’assistant peut générer quelque chose qui semble correct, mais l’approche sous-jacente peut ne pas être la plus appropriée pour le problème.
C’est là que Circle Skills deviennent utiles.
Circle Skills est une bibliothèque open-source de conseils spécialisés pour travailler avec les produits Circle. Elle offre à l’assistant bien plus qu’une simple connaissance générale des produits. Elle fournit des cadres de décision, des modèles d’implémentation et les pièges courants à éviter. Plutôt que de laisser Claude s’appuyer sur des modèles de codage génériques, Circle Skills lui donne un contexte réutilisable pour raisonner sur les flux de travail spécifiques à Circle.
C’est important car beaucoup de ces flux de travail ne se limitent pas à l’écriture de code. Ils impliquent de choisir la bonne voie dès le départ. Une application inter-chaînes peut devoir choisir entre CCTP et Gateway. Une application qui crée ou gère des portefeuilles doit déterminer quel modèle de portefeuille correspond au cas d’utilisation, qu’il s’agisse de portefeuilles contrôlés par le développeur, de portefeuilles contrôlés par l’utilisateur ou de portefeuilles modulaires. Même une simple intégration USDC peut impliquer des différences dans la manière dont l’USDC est représenté et dont ses smart contracts sont gérés sur les différentes chaînes.
Circle Skills aide à clarifier ces décisions en donnant à l’assistant un meilleur contexte sur la manière dont ces flux sont généralement implémentés. Une partie de cette valeur consiste à aider l’assistant à éviter les erreurs courantes dès le départ, au lieu d’improviser autour de cas limites spécifiques au produit.
Cet article explique comment utiliser des prompts avec Claude et Circle Skills pour créer un exemple d’application qui déplace de l’USDC d’Ethereum Sepolia vers le réseau test Arc, et comment l’assistant est mieux positionné pour choisir une voie d’implémentation plus appropriée pour le transfert.
Installation de Circle Skills
La première étape consiste à rendre Circle Skills disponible dans Claude Code. Cela se fait en exécutant les commandes de plugin suivantes :
/plugin marketplace add circlefin/skills
/plugin install circle-skills@circle
Ces commandes installent Circle Skills afin que Claude puisse s’y référer lors de la planification et de la génération de code.
Utiliser des prompts avec Claude et Circle Skills
Une fois Circle Skills installé, le prompt peut être aussi simple que de demander à Claude d’utiliser Circle Skills pour la tâche :
Use Circle Skills to build a sample app that moves USDC from Ethereum Sepolia to Arc Testnet, using Dev-Controlled Wallets with one wallet created on each chain.En demandant explicitement à Claude d’utiliser Circle Skills, l’assistant peut identifier et invoquer les compétences pertinentes pour la tâche. Dans ce cas, cela incluait circle:bridge-stablecoin et circle:use-developer-controlled-wallets.
Configuration du projet et dépendances
Claude a initialisé le projet avec les dépendances pertinentes pour le flux de travail :
{
"dependencies": {
"@circle-fin/adapter-circle-wallets": "^1.2.0",
"@circle-fin/bridge-kit": "^1.6.0",
"@circle-fin/developer-controlled-wallets": "^10.1.0"
}
}
Ces dépendances correspondent directement à la structure de l’application :
@circle-fin/developer-controlled-walletspour la création et la gestion de portefeuilles@circle-fin/bridge-kitpour le flux de transfert inter-chaînes d’USDC@circle-fin/adapter-circle-walletspour connecter les portefeuilles à la logique de transfert
Au lieu de structurer le flux autour d’appels API directs ou de primitives de bas niveau, l’assistant a structuré l’application autour des SDK de Circle dès le départ. Cela évite une implémentation plus verbeuse où chaque étape du flux de travail doit être gérée manuellement, et aboutit à un chemin de code plus propre et plus facile à maintenir.
Structure générée
À partir de là, Claude a généré deux scripts :
create-wallets.ts : pour créer des portefeuilles sur chaque chaîne bridge-usdc.ts : pour gérer le transfert d’USDC entre blockchains
Ceux-ci correspondent directement aux deux parties principales du flux de travail : le provisionnement des portefeuilles requis pour le transfert, puis l’exécution du transfert lui-même.
Configuration du portefeuille : un portefeuille par chaîne
Dans create-wallets.ts, Claude crée un ensemble de portefeuilles et provisionne un portefeuille sur chaque chaîne :
const sourceResponse = await client.createWallets({
accountType: "SCA",
blockchains: ["ETH-SEPOLIA"],
count: 1,
walletSetId,
});
const destResponse = await client.createWallets({
accountType: "SCA",
blockchains: ["ARC-TESTNET"],
count: 1,
walletSetId,
});
Cela reflète la structure du transfert. Étant donné que l’application déplace de l’USDC entre des blockchains, elle a besoin d’un portefeuille source sur Ethereum Sepolia et d’un portefeuille de destination sur Arc Testnet.
Au lieu de gérer directement les clés privées, le flux utilise des portefeuilles contrôlés par le développeur avec des comptes de smart contracts (SCA). Cela permet d’aligner la configuration du portefeuille sur la manière dont les applications gèrent généralement les comptes en production, plutôt que d’introduire une complexité supplémentaire au niveau de la gestion des clés.
Transfert entre blockchains : utilisation de Bridge Kit
Dans bridge-usdc.ts, le transfert lui-même est géré via Bridge Kit :
const result = await kit.bridge({
from: {
adapter,
chain: "Ethereum_Sepolia",
address: sourceAddress,
},
to: {
adapter,
chain: "Arc_Testnet",
address: destAddress,
},
amount,
});
Au lieu d’implémenter manuellement l’intégralité du flux entre blockchains, l’assistant utilise Bridge Kit pour abstraire le processus en quelques lignes de code seulement. Bridge Kit enveloppe le flux CCTP sous-jacent dans une interface de plus haut niveau, permettant à l’application de se concentrer sur le transfert lui-même plutôt que de coordonner chaque étape individuellement.
C’est un autre exemple du choix du bon niveau d’abstraction. Une implémentation de bas niveau nécessiterait de gérer explicitement chaque étape du transfert, ce qui ajoute de la complexité sans améliorer le résultat pour une application exemple comme celle-ci.
Rendre le flux de transfert visible
Le script enregistre également chaque étape du cycle de vie du transfert :
kit.on("approve", (payload) => {
console.log("[approve]", payload.values.txHash);
});
kit.on("burn", (payload) => {
console.log("[burn]", payload.values.txHash);
});
kit.on("fetchAttestation", () => {
console.log("[attestation] received");
});
kit.on("mint", (payload) => {
console.log("[mint]", payload.values.txHash);
});
Cela rend le flux plus facile à suivre de bout en bout :
- Approuver Brûler Récupérer l’attestation Minter
Plutôt que de masquer le processus derrière un seul appel de fonction, cela rend chaque étape visible, ce qui est particulièrement utile pour comprendre ou déboguer les flux entre blockchains.
Ce que cela démontre
La partie intéressante de ce flux n’est pas seulement que l’assistant peut générer du code fonctionnel, mais la façon dont l’implémentation est façonnée par le contexte dont il dispose. Avec Circle Skills, l’assistant ne part pas uniquement de connaissances générales. Il peut raisonner à partir de modèles plus appropriés pour les portefeuilles, les transferts entre blockchains et la manière dont les produits Circle s’articulent entre eux, ce qui se reflète directement dans les choix qu’il effectue.
Dans cet exemple, cela signifiait utiliser des portefeuilles contrôlés par le développeur pour la couche portefeuille et s'appuyer sur le Bridge Kit plutôt que sur une implémentation de bas niveau pour le flux de transfert. Ces choix conduisent à une structure plus propre, des abstractions plus appropriées et moins de temps passé à déterminer la bonne approche, en particulier dans les flux de travail impliquant plusieurs systèmes.
Essayez-le
Circle Skills est open source et disponible pour une utilisation avec Claude et d'autres clients pris en charge. Installez les compétences, soumettez votre propre cas d'utilisation à Claude et voyez comment l'implémentation évolue à mesure que vous affinez votre prompt.
Explorez le dépôt : https://github.com/circlefin/skills
Essayez Arc
Circle Technology Services, LLC (« CTS ») est un fournisseur de logiciels et ne fournit pas de services financiers ou de conseil réglementés. Vous êtes seul responsable des services que vous fournissez aux utilisateurs, y compris l'obtention des licences ou approbations nécessaires et le respect des lois applicables. Pour plus de détails, veuillez cliquer ici pour consulter les conditions d'utilisation de Circle Developer.
L’USDC est émis par des sociétés affiliées réglementées de Circle. Voir la liste des autorisations réglementaires de Circle.
Réseau test Arc fourni par Circle Technology Services, LLC, un fournisseur de logiciels. Il ne s'agit pas d'un service financier ou de conseil. Non examiné ou approuvé par le NYDFS. Les utilisateurs sont responsables de leur propre conformité. Voir arc.network pour en savoir plus.
