Como usar o Claude com o Circle Skills para criar um aplicativo de USDC entre blockchains

Fazer um prompt para um assistente de IA geralmente parece simples. Você descreve o que deseja criar e ele entrega algo que parece utilizável.

Mas, assim que você vai além de pequenas tarefas, as lacunas começam a aparecer. O prompt pode ser claro, mas a implementação por trás dele não. Ainda há decisões a serem tomadas sobre como o aplicativo deve ser estruturado, quais ferramentas usar e qual é a configuração correta.

Isso se torna mais perceptível em fluxos de trabalho que abrangem vários sistemas. O assistente pode gerar algo que parece correto, mas a abordagem subjacente pode não ser a mais apropriada para o problema.

É aí que as Circle Skills se tornam úteis.

Circle Skills é uma biblioteca de código aberto com orientações especializadas para trabalhar com produtos da Circle. Ela oferece ao assistente mais do que apenas um conhecimento geral do produto. Ela fornece estruturas de decisão, padrões de implementação e armadilhas comuns a serem evitadas. Em vez de deixar o Claude depender de padrões de codificação genéricos, as Circle Skills fornecem um contexto reutilizável para raciocinar sobre fluxos de trabalho específicos da Circle.

Isso é importante porque muitos desses fluxos de trabalho não se tratam apenas de escrever código. Eles envolvem escolher o caminho certo desde o início. Um aplicativo crosschain pode precisar decidir entre CCTP e Gateway. Um aplicativo que cria ou gerencia carteiras precisa determinar qual modelo de carteira se ajusta ao caso de uso, seja carteiras controladas pelo desenvolvedor, carteiras controladas pelo usuário ou carteiras modulares. Até mesmo uma integração simples de USDC pode envolver diferenças em como o USDC é representado e como seus contratos são tratados entre blockchains.

As Circle Skills ajudam a tornar essas decisões mais claras, dando ao assistente um contexto melhor sobre como esses fluxos são normalmente implementados. Parte desse valor é ajudar o assistente a evitar erros comuns logo de início, em vez de improvisar em torno de casos extremos específicos do produto.

Este post percorre como fazer um prompt para o Claude com Circle Skills para criar um aplicativo de exemplo que move USDC da Ethereum Sepolia para a Arc Testnet, e como o assistente fica melhor posicionado para escolher um caminho de implementação mais apropriado para a transferência.

Instalando Circle Skills

O primeiro passo é disponibilizar as Circle Skills dentro do Claude Code. Isso é feito executando os seguintes comandos de plugin:

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

Esses comandos instalam as Circle Skills para que o Claude possa referenciá-las durante o planejamento e a geração de código.

Fazendo prompts para o Claude com Circle Skills

Com as Circle Skills instaladas, o prompt pode ser tão simples quanto pedir ao Claude para usar as Circle Skills para a tarefa:

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.

Ao pedir explicitamente ao Claude para usar as Circle Skills, o assistente pode identificar e invocar as habilidades relevantes para a tarefa. Nesse caso, isso incluiu circle:bridge-stablecoin e circle:use-developer-controlled-wallets.

Configuração do projeto e dependências

O Claude inicializou o projeto com as dependências relevantes para o fluxo de trabalho:

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

Essas dependências mapeiam diretamente para a estrutura do aplicativo:

• @circle-fin/developer-controlled-wallets para criação e gerenciamento de carteiras
• @circle-fin/bridge-kit para o fluxo de transferência crosschain de USDC
• @circle-fin/adapter-circle-wallets para conectar carteiras à lógica de transferência

Em vez de estruturar o fluxo em torno de chamadas diretas de API ou primitivas de nível inferior, o assistente estruturou o aplicativo em torno dos SDKs da Circle desde o início. Isso evita uma implementação mais detalhada, onde cada etapa do fluxo de trabalho precisa ser tratada manualmente, e resulta em um caminho de código mais limpo e fácil de manter.

Estrutura gerada

A partir daí, o Claude gerou dois scripts:

• create-wallets.ts: para criar carteiras em cada blockchain bridge-usdc.ts: para lidar com a transferência de USDC entre blockchains

Eles correspondem diretamente às duas partes principais do fluxo de trabalho: provisionar as carteiras necessárias para a transferência e, em seguida, executar a transferência em si.

Configuração da carteira: uma carteira por blockchain

Em create-wallets.ts, o Claude cria um conjunto de carteiras e provisiona uma carteira em 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,
});

Isso reflete a estrutura da transferência. Como o aplicativo move USDC entre blockchains, ele precisa de uma carteira de origem na Ethereum Sepolia e uma carteira de destino na Arc Testnet.

Em vez de gerenciar chaves privadas diretamente, o fluxo usa carteiras controladas pelo desenvolvedor com contas de contrato inteligente. Isso mantém a configuração da carteira alinhada com a forma como os aplicativos normalmente gerenciam contas em produção, em vez de introduzir complexidade adicional na camada de gerenciamento de chaves.

Transferência entre blockchains: usando o Bridge Kit

Em bridge-usdc.ts, a transferência em si é tratada por meio do Bridge Kit:

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

Em vez de implementar todo o fluxo entre blockchains manualmente, o assistente usa o Bridge Kit para abstrair o processo em apenas algumas linhas de código. O Bridge Kit envolve o fluxo CCTP subjacente em uma interface de nível superior, permitindo que o aplicativo se concentre na transferência em si, em vez de coordenar cada etapa individualmente.

Este é outro exemplo de escolha do nível certo de abstração. Uma implementação de nível inferior exigiria o tratamento explícito de cada estágio da transferência, o que aumenta a complexidade sem melhorar o resultado para um aplicativo de exemplo como este.

Tornando o fluxo de transferência visível

O script também registra cada etapa do ciclo de vida da transferência:

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

Isso torna o fluxo mais fácil de acompanhar de ponta a ponta:

• Aprovar Queimar Buscar atestado Mint

Em vez de ocultar o processo atrás de uma única chamada de função, isso torna cada estágio visível, o que é especialmente útil ao entender ou depurar fluxos entre blockchains.

O que isso mostra

A parte interessante desse fluxo não é apenas que o assistente pode gerar código funcional, mas como a implementação é moldada pelo contexto que ele possui. Com as Circle Skills, o assistente não parte apenas do conhecimento geral. Ele pode raciocinar a partir de padrões mais apropriados para carteiras, transferências entre blockchains e como os produtos da Circle se encaixam, e isso aparece diretamente nas escolhas que ele faz.

Neste exemplo, isso significou usar carteiras controladas pelo desenvolvedor para a camada de carteira e confiar no Bridge Kit em vez de uma implementação de nível inferior para o fluxo de transferência. Essas escolhas levam a uma estrutura mais limpa, abstrações mais apropriadas e menos tempo gasto descobrindo o caminho certo, especialmente em fluxos de trabalho que envolvem vários sistemas.

Experimente

O Circle Skills é de código aberto e está disponível para uso com o Claude e outros clientes compatíveis. Instale as habilidades, peça ao Claude para processar seu próprio caso de uso e veja como a implementação muda à medida que você refina o prompt.

Explore o repositório: https://github.com/circlefin/skills

Experimente o Arc

‍

_{A Circle Technology Services, LLC (“CTS”) é uma fornecedora de software e não presta serviços financeiros ou de consultoria regulamentados. Você é o único responsável pelos serviços que presta aos usuários, incluindo a obtenção de quaisquer licenças ou aprovações necessárias e o cumprimento das leis aplicáveis. Para obter detalhes adicionais, clique aqui para ver os termos de serviço do desenvolvedor da Circle.}

_{O USDC é emitido por afiliadas regulamentadas da Circle. Veja a lista de autorizações regulatórias da Circle.}

_{Testnet do Arc fornecida pela Circle Technology Services, LLC, uma fornecedora de software. Não é um serviço financeiro ou de consultoria. Não revisado ou aprovado pelo NYDFS. Os usuários são responsáveis por sua própria conformidade. Consulte arc.network para saber mais.}