Cómo usar prompts en Claude con Circle Skills para crear una aplicación de USDC entre blockchains

Dar instrucciones a un asistente de IA a menudo parece sencillo. Describes lo que quieres construir y te ofrece algo que parece utilizable.

Pero una vez que vas más allá de las tareas pequeñas, las brechas comienzan a aparecer. El prompt puede ser claro, pero la implementación subyacente no lo es. Todavía hay decisiones que tomar sobre cómo debe estructurarse la aplicación, qué herramientas usar y cómo debe ser la configuración correcta.

Esto se vuelve más notable en flujos de trabajo que abarcan múltiples sistemas. El asistente puede generar algo que parece correcto, pero el enfoque subyacente puede no ser el más apropiado para el problema.

Ahí es donde Circle Skills resulta útil.

Circle Skills es una biblioteca de código abierto con orientación especializada para trabajar con productos de Circle. Le da al asistente algo más que un conocimiento general del producto. Proporciona marcos de decisión, patrones de implementación y errores comunes que se deben evitar. En lugar de dejar que Claude dependa de patrones de codificación genéricos, Circle Skills le brinda contexto reutilizable para razonar sobre flujos de trabajo específicos de Circle.

Eso es importante porque muchos de estos flujos de trabajo no se tratan solo de escribir código. Implican elegir el camino correcto desde el principio. Una aplicación entre blockchains podría necesitar decidir entre CCTP y Gateway. Una aplicación que crea o gestiona billeteras necesita determinar qué modelo de billetera se ajusta al caso de uso, ya sean billeteras controladas por el desarrollador, billeteras controladas por el usuario o billeteras modulares. Incluso una simple integración de USDC puede implicar diferencias en cómo se representa el USDC y cómo se manejan sus contratos entre blockchains.

Circle Skills ayuda a aclarar esas decisiones al darle al asistente un mejor contexto sobre cómo se implementan normalmente estos flujos. Parte de ese valor es ayudar al asistente a evitar errores comunes desde el principio, en lugar de improvisar sobre casos extremos específicos del producto.

Esta publicación explica cómo dar instrucciones a Claude con Circle Skills para crear una aplicación de muestra que mueva USDC desde Ethereum Sepolia a la Arc testnet, y cómo el asistente está mejor posicionado para elegir un camino de implementación más apropiado para la transferencia.

Instalación de Circle Skills

El primer paso es hacer que Circle Skills esté disponible dentro de Claude Code. Esto se hace ejecutando los siguientes comandos de plugin:

/plugin marketplace add circlefin/skills
/plugin install circle-skills@circle

Estos comandos instalan Circle Skills para que Claude pueda hacer referencia a ellos durante la planificación y la generación de código.

Dar instrucciones a Claude con Circle Skills

Con Circle Skills instalado, la instrucción puede ser tan simple como pedirle a Claude que use Circle Skills para la tarea:

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.

Al pedirle explícitamente a Claude que use Circle Skills, el asistente puede identificar e invocar las habilidades relevantes para la tarea. En este caso, eso incluyó circle:bridge-stablecoin y circle:use-developer-controlled-wallets.

Configuración del proyecto y dependencias

Claude inicializó el proyecto con las dependencias relevantes para el flujo de trabajo:

{
  "dependencies": {
    "@circle-fin/adapter-circle-wallets": "^1.2.0",
    "@circle-fin/bridge-kit": "^1.6.0",
    "@circle-fin/developer-controlled-wallets": "^10.1.0"
  }
}

Estas dependencias se asignan directamente a la estructura de la aplicación:

• @circle-fin/developer-controlled-wallets para la creación y gestión de billeteras
• @circle-fin/bridge-kit para el flujo de transferencia de USDC entre blockchains
• @circle-fin/adapter-circle-wallets para conectar billeteras a la lógica de transferencia

En lugar de construir el flujo en torno a llamadas directas a la API o primitivas de bajo nivel, el asistente estructuró la aplicación desde el principio utilizando los SDK de Circle. Esto evita una implementación más verbosa en la que cada paso del flujo de trabajo debe gestionarse manualmente, y da como resultado una ruta de código más limpia y fácil de mantener.

Estructura generada

A partir de ahí, Claude generó dos scripts:

• create-wallets.ts: para crear billeteras en cada blockchain, bridge-usdc.ts: para gestionar la transferencia de USDC entre blockchains.

Estos se corresponden directamente con las dos partes principales del flujo de trabajo: aprovisionar las billeteras necesarias para la transferencia y, a continuación, ejecutar la transferencia en sí.

Configuración de la billetera: una billetera por blockchain

En create-wallets.ts, Claude crea un conjunto de billeteras y aprovisiona una billetera en cada blockchain:

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,
});

Esto refleja la estructura de la transferencia. Dado que la aplicación mueve USDC entre blockchains, necesita una billetera de origen en Ethereum Sepolia y una billetera de destino en Arc Testnet.

En lugar de gestionar las claves privadas directamente, el flujo utiliza billeteras controladas por el desarrollador con cuentas de smart contract. Esto mantiene la configuración de la billetera alineada con la forma en que las aplicaciones gestionan normalmente las cuentas en producción, en lugar de introducir una complejidad adicional en la capa de gestión de claves.

Transferencia entre blockchains: uso de Bridge Kit

En bridge-usdc.ts, la transferencia en sí se gestiona a través de Bridge Kit:

const result = await kit.bridge({
  from: {
    adapter,
    chain: "Ethereum_Sepolia",
    address: sourceAddress,
  },
  to: {
    adapter,
    chain: "Arc_Testnet",
    address: destAddress,
  },
  amount,
});

En lugar de implementar manualmente todo el flujo entre blockchains, el asistente utiliza Bridge Kit para abstraer el proceso en solo unas pocas líneas de código. Bridge Kit envuelve el flujo CCTP subyacente en una interfaz de nivel superior, lo que permite a la aplicación centrarse en la transferencia en sí en lugar de coordinar cada paso individualmente.

Este es otro ejemplo de cómo elegir el nivel de abstracción adecuado. Una implementación de bajo nivel requeriría gestionar cada etapa de la transferencia de forma explícita, lo que añade complejidad sin mejorar el resultado para una aplicación de muestra como esta.

Hacer visible el flujo de transferencia

El script también registra cada paso del ciclo de vida de la transferencia:

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);
});

Esto hace que el flujo sea más fácil de seguir de principio a fin:

• Aprobar, Quemar, Obtener certificación, Emitir

En lugar de ocultar el proceso detrás de una única llamada de función, esto hace que cada etapa sea visible, lo cual es especialmente útil para comprender o depurar flujos entre blockchains.

Lo que esto demuestra

Lo interesante de este flujo no es solo que el asistente pueda generar código funcional, sino cómo la implementación está moldeada por el contexto que posee. Con Circle Skills, el asistente no parte solo de conocimientos generales. Puede razonar a partir de patrones más adecuados para billeteras, transferencias entre blockchains y cómo encajan los productos de Circle, y eso se refleja directamente en las decisiones que toma.

En este ejemplo, eso significó utilizar billeteras controladas por el desarrollador para la capa de billetera y depender de Bridge Kit en lugar de una implementación de bajo nivel para el flujo de transferencia. Esas elecciones conducen a una estructura más limpia, abstracciones más apropiadas y menos tiempo dedicado a determinar el camino correcto, especialmente en flujos de trabajo que involucran múltiples sistemas.

Pruébelo

Circle Skills es de código abierto y está disponible para su uso con Claude y otros clientes compatibles. Instale las habilidades, proporcione a Claude su propio caso de uso y vea cómo cambia la implementación a medida que refina el prompt.

Explore el repositorio: https://github.com/circlefin/skills

Pruebe Arc

‍

_{Circle Technology Services, LLC (“CTS”) es un proveedor de software y no presta servicios financieros ni de asesoramiento regulados. Usted es el único responsable de los servicios que brinda a los usuarios, lo que incluye la obtención de las licencias o aprobaciones necesarias y el cumplimiento de las leyes aplicables. Para obtener más detalles, haga clic aquí para ver los términos de servicio para desarrolladores de Circle.}

_{USDC es emitido por filiales reguladas de Circle. Consulte la lista de autorizaciones regulatorias de Circle.}

_{La testnet de Arc es proporcionada por Circle Technology Services, LLC, un proveedor de software. No es un servicio financiero ni de asesoramiento. No ha sido revisada ni aprobada por el NYDFS. Los usuarios son responsables de su propio cumplimiento. Consulte arc.network para obtener más información.}