applefanaimail-blip/bridgenode-skill

O que bridgenode-skill faz?

Skill do agente BridgeNode e exemplos do lado do comprador — Inferência de IA via x402 na Solana. Sem chaves de API, pague por requisição com USDC.

Visão Geral

Este skill permite que agentes de IA usem o protocolo x402 para pagar por inferência de modelos de linguagem diretamente com USDC na blockchain Solana, sem a necessidade de uma chave de API. O repositório inclui:

• Skill do Agente: Define a interface que os agentes de IA (como o Claude Code) usam para solicitar inferência.
• Exemplos do Comprador: Scripts e documentação mostrando como um agente comprador pode fazer requisições e pagar.
• Documentação do Protocolo x402: Como funciona o pagamento por requisição.

Como Funciona

1. O agente constrói uma requisição de inferência (ex.: prompt para Claude).
2. O BridgeNode calcula o custo em USDC com base no tamanho do prompt.
3. O agente assina uma transação Solana pagando o valor calculado.
4. O nó processa a inferência e retorna a resposta.

Pré-requisitos

• Carteira Solana com saldo de USDC.
• Node.js 18+.
• Acesso a um nó BridgeNode (ou execute seu próprio nó).

Instalação

npm install @bridgeNode/skill

Uso

Para Agentes

1. Importe o skill no seu agente:

import { BridgeNodeSkill } from '@bridgeNode/skill';

const skill = new BridgeNodeSkill({
  nodeUrl: 'https://bridge-node.example.com',
  walletPrivateKey: process.env.SOLANA_WALLET_KEY,
});

2. Faça uma requisição de inferência:

const response = await skill.infer({
  model: 'claude-sonnet-4-20250514',
  prompt: 'Explique o protocolo x402 em português.',
  maxTokens: 200,
});

console.log(response.text);

Para Provedores de Nó

Consulte a documentação em docs/provider-guide.md para configurar seu próprio nó de inferência.

Exemplo: demo.sh

O script demo.sh demonstra um fluxo completo de agente comprador:

./demo.sh --prompt "Qual o significado da vida?" --model "claude-sonnet-4-20250514"

Estrutura de Arquivos

• src/ — Código fonte do skill.
• examples/ — Exemplos de integração (comprador e vendedor).
• docs/ — Documentação do protocolo x402.
• tests/ — Testes unitários e de integração.

Suporte

Abra uma issue no repositório para suporte.

Licença

MIT.