Configuracoes da plataforma

Esta secao cobre configuracoes operacionais que afetam o comportamento global da plataforma, como RPC endpoints, relayer e dados de dashboard. Sao recursos usados para conectar a Hotwallets ao ambiente de blockchain e dar suporte a monitoramento e operacao do sistema.

RPC endpoints

Criar ou atualizar um RPC endpoint

Endpoint: PUT /admin/rpc-endpoints

Serve para

Criar ou atualizar um RPC endpoint.

Autenticação

Exige token de admin.

Body

{
  "network": "polygon",
  "rpcUrl": "https://polygon-rpc.example",
  "status": "active"
}

Observacoes

  • A API tenta inferir automaticamente o networkGroup a partir do RPC.
  • Hoje a detecção suporta EVM e Tron.

Listar RPC endpoints

Endpoint: GET /admin/rpc-endpoints

Serve para

Listar RPC endpoints cadastrados.

Autenticação

Exige token de admin.

Retorno

Array de RPC endpoints.

Relayer

Definir o relayer

Endpoint: PUT /admin/relayer

Serve para

Definir qual vault sera usada como relayer global EVM e se ela esta ativa.

Autenticação

Exige token de admin.

Body

{
  "vaultId": "1",
  "active": true
}

Consultar o relayer atual

Endpoint: GET /admin/relayer

Serve para

Consultar a configuracao atual do relayer EVM.

Autenticação

Exige token de admin.

Retorno

Retorna a configuracao atual do relayer EVM ou null se ainda não houver configuracao.

Dashboard administrativo

Buscar resumo do dashboard

Endpoint: GET /admin/dashboard/overview

Serve para

Buscar um resumo pronto para dashboards.

Autenticação

Exige token de admin.

Retorno

{
  "summary": {
    "totalVaults": 10,
    "totalTransactions": 120,
    "totalAddresses": 10,
    "totalNativeBalances": 5,
    "totalTokenBalances": 18,
    "totalTrackedTokens": 7,
    "onlineCosigners": 3
  },
  "transactionStatusBreakdown": [
    { "status": "success", "count": 80 }
  ],
  "vaultStatusBreakdown": [
    { "status": "created", "count": 10 }
  ],
  "recentTransactions": [
    {
      "id": "uuid",
      "network": "polygon",
      "operationType": "transfer",
      "destination": "0x...",
      "amount": "1000",
      "status": "Success",
      "updatedAt": "2026-03-26T12:00:00.000Z",
      "vaultId": "12"
    }
  ],
  "assetTotals": [
    {
      "network": "polygon",
      "asset": "token",
      "tokenAddress": "0x...",
      "totalAmount": "1000000",
      "vaultCount": 4,
      "symbol": "USDT",
      "decimals": 6
    }
  ]
}