← Todos os guias

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