Hotwallets

Enderecos

Esta secao detalha a criacao e a consulta de enderecos vinculados a uma vault. Os enderecos sao o ponto de entrada e saida dos ativos em cada rede suportada e conectam a estrutura logica da plataforma com a operacao real em blockchain.

Conceitos rápidos

  • vault address Endereço derivado para a vault em um determinado networkGroup.

Criar um endereço para a vault

Endpoint: POST /vaults/:vaultId/addresses

Serve para

Criar o endereço da vault em um networkGroup.

Autenticação

Exige bearer token com permissão vault-address:create.

Parâmetros de rota

  • vaultId Identificador funcional da vault.

Body

{
  "networkGroup": "evm",
  "requestId": "uuid-opcional"
}

Retorno quando criou agora

Status HTTP: 201 Created

{
  "requestId": "uuid",
  "vaultId": "12",
  "derivationIndex": 12,
  "networkGroup": "evm",
  "address": "0x...",
  "pubkey": "hex-ou-base64",
  "status": "created"
}

Retorno quando já existia

Status HTTP: 200 OK

Retorna o mesmo formato acima.

Observacoes

  • Hoje a derivação depende de vaultId numérico.
  • Se a criação assíncrona não finalizar em até 30 segundos, a API responde 504.

Listar endereços da vault

Endpoint: GET /vaults/:vaultId/addresses

Serve para

Listar os endereços já derivados para a vault.

Autenticação

Exige bearer token com permissão vault-address:read.

Retorno

Array de endereços.

Campos principais por item:

  • id
  • requestId
  • vaultId
  • derivationIndex
  • networkGroup
  • address
  • pubkey
  • eip7702DelegateAddress
  • eip7702UpgradedAt
  • status
  • createdAt
  • updatedAt