Execute um operador (CLI)
Use a CLI do halo para servir inferência de um provedor, modelo hospedado ou GPU local e ganhar USDC na Base: slugs de provedor, preços, liquidação e configuração sempre ativa.
O papel operate serve inferência à rede e ganha USDC por requisição. Este
guia usa a CLI do halo diretamente. Prefere deixar um agente configurar isso
conversando? Confira opere com o seu agente.
O Halo está em alfa na mainnet da Base, com USDC real. Requer Node.js 20+.
Instale e verifique
bash <(curl -fsSL https://raw.githubusercontent.com/warden-protocol/run-halo/main/skill/scripts/install.sh)
halo doctor --json # node version, install + wallet state, provider, relay health
Defina um provedor, um preço e sirva
halo setup --provider <slug> [--api-key <key>] --margin 20 --with-pairing
halo serve
halo serve conecta-se de saída ao relay via WebSocket — sem URL pública
nem porta de entrada aberta —, anuncia seus modelos e serve até ser interrompido.
A wallet do operador não precisa de financiamento prévio; o USDC chega na
liquidação e o Halo patrocina o gas.
<slug> é um entre openclaw, claude-code, hermes, ollama, lmstudio,
openrouter, openai, anthropic, venice, near, together, fireworks,
groq, ou custom. Adicione mais upstreams a um mesmo operador com
halo setup --add-provider.
Preços
- Margem (
--margin <n>) — recomendado. Cobre n% sobre a tarifa por token publicada pelo upstream, resolvida por modelo na liquidação (onde o provedor expõe preços, por exemplo OpenRouter e NEAR). Acompanha o custo real por modelo. - Fixo (
--flat <usd-per-1k>). Um preço fixo em USD por 1.000 tokens, para modelos locais (Ollama, LM Studio) ou upstreams que não publicam preços.
A taxa do protocolo começa em 10% do seu preço, retida na liquidação e aplicada on-chain (ajustável via governança): você recebe preço − taxa.
Como funciona a liquidação
A inferência é liquidada através do HaloVault na Base: o consumidor deposita USDC e reserva parte dele para o seu operador; seu operador lê essa reserva on-chain e só serve se ela cobrir a requisição; você reporta os tokens realmente usados e um recibo acumulativo resgata esse valor para você. O facilitador envia essas transações e paga o gas.
Privacidade
- A criptografia de ponta a ponta está ativada por padrão: o relay apenas encaminha texto cifrado, e sua chave por sessão vive somente na memória, nunca é persistida.
- Modo confidencial (TEE) — exponha um provedor TEE (por exemplo,
--provider near) para servir modelos confidenciais que o próprio operador não consegue ler.
Mantenha-o sempre ativo
halo service install serve
halo service status serve
halo service logs serve
O que vem por aí
Inferência verificável (SPEX) — uma Prova Estatística de Execução que dá garantias probabilísticas de que um operador executou o modelo solicitado — está no roadmap, junto com serviços de código aberto e auto-hospedáveis. Confira o que é inferência de IA verificável.
Relacionados
- Execute em vez disso um endpoint de inferência pago: crie um endpoint (CLI).
- Referência completa da CLI: warden-protocol/run-halo.