Vellum-finance/vellum-agent-skill

O que vellum-agent-skill faz?

Skill Vellum para Agentes de IA – Registro de Agente com Carteira Automática + Negociação de Meme Coins na Base

Visão Geral

Este skill permite que agentes de IA registrem seus agentes, criem carteiras automaticamente e negociem meme coins na blockchain Base de forma autônoma.

Funcionalidades

• Registro de Agente: Registre seu agente no protocolo Vellum e receba uma chave de API.
• Criação Automática de Carteira: Uma carteira é gerada automaticamente durante o registro, pré-carregada com ETH de teste.
• Negociação de Meme Coins: Execute negociações de tokens meme na rede Base usando o Vellum SDK.
• Loop de Verificação: Monitora transações a cada 30 segundos até a confirmação.

Pré-requisitos

• Python 3.8 ou superior
• Pip (gerenciador de pacotes Python)
• Acesso à internet para usar a API da Vellum

Guia de Início Rápido

1. Instale a biblioteca Vellum SDK:

   pip install vellum-sdk
   

2. Registre seu agente:

   vellum register
   

   Siga as instruções para criar seu agente e receber sua chave de API.

3. Exporte sua chave de API (opcional):

   export VELLUM_API_KEY="sua-chave-aqui"
   

4. Execute uma negociação:

   vellum trade --token SKIBIDI --amount 0.0001
   

Estrutura do Projeto

.
├── README.md
├── skill.md
├── src/
│   ├── agent.py          # Lógica principal do agente
│   └── trade.py          # Lógica de negociação
├── tests/
│   └── test_trade.py     # Testes unitários
└── requirements.txt

Uso

Comandos Disponíveis

Comando	Descrição	Exemplo
vellum register	Registra um novo agente com carteira automática	vellum register
vellum wallet	Exibe o saldo da carteira do agente	vellum wallet
vellum trade	Executa uma negociação de token	vellum trade --token BRETT --amount 0.0001
vellum status	Verifica o status de uma transação pendente	vellum status --tx-id <id>

Argumentos da Negociação

• --token: Nome do token a ser comprado (SKIBIDI, BRETT, DOGE, PEPE)
• --amount: Valor em ETH a ser gasto (padrão: 0.0001)
• --slippage: Tolerância de slippage em porcentagem (padrão: 1.0)

Exemplo de Fluxo de Trabalho

# Etapa 1: Registrar agente e criar carteira
vellum register

# Etapa 2: Verificar saldo da carteira
vellum wallet

# Etapa 3: Comprar token SKIBIDI
vellum trade --token SKIBIDI --amount 0.0001

# Etapa 4: Verificar transação
vellum status --tx-id 0xabc...

Como Funciona

1. O agente é registrado via comando vellum register, que cria uma chave de API no backend da Vellum.
2. Uma carteira é gerada automaticamente e recebe ETH de teste da faucet da Base.
3. Ao executar vellum trade, o SDK constrói e envia uma transação de swap na DEX selecionada (Uniswap V3 na Base).
4. O skill executa um loop de verificação, checando o status a cada 30 segundos.

Suporte a Plataformas

• Claude Code: Via arquivo .airspeech.yaml ou integração direta com a API.
• Cursor: Carregue o diretório do skill como um plugin.
• Codex: Instale via pip e use os comandos CLI.

Tratamento de Erros

Erro	Causa	Solução
VELLUM_API_KEY não encontrada	Chave de API ausente	Execute vellum register ou exporte a chave
Saldo insuficiente	Carteira sem ETH de teste	Aguarde a faucet ou solicite mais ETH
Falha na transação	Slippage muito baixo ou rede	Aumente a tolerância de slippage ou tente novamente

Contribuição

Contribuições são bem-vindas! Envie um pull request ou abra uma issue no repositório GitHub.

Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.