Aesesdocs

Ambientes

A Aeses oferece dois ambientes completamente isolados: modo teste e modo live. Eles não compartilham nada — chaves separadas, livros-razão separados, endpoints de webhook separados e redes blockchain separadas.

Chains suportadas

A Aeses suporta atualmente três famílias de chain. Cada família é selecionada via o parâmetro chain nos endpoints de criação e aceita os ativos listados abaixo.

| Valor de chain | Família | Redes live | Redes de teste | Ativos suportados | | ---------------- | ------- | ---------------- | --------------- | ----------------- | | ethereum | EVM | Ethereum mainnet | Sepolia | ETH, USDT | | bitcoin | Bitcoin | Bitcoin mainnet | Bitcoin testnet | BTC | | tron | Tron | Tron mainnet | Tron Nile | TRX, USDT |

Para obter a lista viva e legível por máquina, chame GET /v1/assets.

Quando usar cada modo

| Ambiente | URL base da API | Fundos | | ---------- | --------------- | --------------------------- | | Modo teste | https://api.aeses.io | Tokens de teste sem valor | | Modo live | https://api.aeses.io | Valor real, liquidação real |

A URL base é idêntica — a Aeses roteia a requisição com base no prefixo da chave (sk_test_… vs. sk_live_…). Não existe um host api.test.aeses.io.

O que é isolado

  • Chaves. Uma chave de teste não consegue ler dados de live, e vice-versa. Requisições cruzadas retornam 401 key_environment_mismatch.
  • Recursos. Teste e live têm cada um seus próprios deposits, withdrawals, balances, webhook deliveries e endpoints de webhook.
  • Webhooks. Endpoints de teste recebem apenas eventos de teste.
  • Rate limits. Teste e live têm buckets de rate limit independentes.

Obter fundos de testnet

Use os faucets recomendados na documentação da sua rede:

Fundos de testnet não têm valor de mercado. Existem apenas para validar integrações.

Indo para produção

Quando estiver pronto para aceitar pagamentos reais:

  1. Complete o perfil de negócio no painel.
  2. Crie uma API key sk_live_.
  3. Atualize o secret no seu ambiente de produção.
  4. Configure seu endpoint de webhook de live e teste em Developers → Webhooks → Enviar evento de teste.
  5. Faça uma transação ponta a ponta pequena para validar o fluxo completo.