> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockradar.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Perguntas Frequentes

> Respostas para as perguntas mais comuns sobre o Blockradar.

## Depósitos e Webhooks

<AccordionGroup>
  <Accordion title="Meu depósito não aparece no painel">
    Isso geralmente é um atraso temporário de indexação. Use o Deposit Finder para acionar manualmente a indexação:

    * **Painel:** Acesse sua Carteira Master → Visão Geral → Clique em "Deposit Finder"
    * **API:** `POST /v1/wallets/{walletId}/rescan/blocks` com o `transactionHash`

    [Documentação do Deposit Finder →](/pt/essentials/wallets)
  </Accordion>

  <Accordion title="Webhooks estão atrasados ou inconsistentes">
    Atrasos em webhooks podem ocorrer devido a congestionamento da rede blockchain, atrasos temporários na indexação de nós ou erros retornados pelo seu endpoint de webhook.

    Para verificar os logs de webhook:

    * **Painel:** Carteira Master → Desenvolvedores → Logs de Webhook
    * **API:** `GET /v1/wallets/{walletId}/webhooks`
  </Accordion>

  <Accordion title="Enviei tokens nativos (ETH/TRX) — por que não aparecem?">
    O Blockradar indexa apenas stablecoins por design. Depósitos de tokens nativos (ETH, TRX, SOL, etc.) não aparecerão no histórico de transações do painel. No entanto, os fundos ainda estão na sua carteira e podem ser visualizados no explorador de blockchain ou sacados via API ou painel.
  </Accordion>
</AccordionGroup>

## Auto-Sweep

<AccordionGroup>
  <Accordion title="Por que meus fundos foram movidos automaticamente para a carteira master?">
    Por padrão, `disableAutoSweep` está definido como `false`, o que significa que o auto-sweep está ativado. Quando um depósito chega em um endereço filho, ele é automaticamente transferido para sua carteira master.

    Para manter os fundos nos endereços filhos:

    * Defina `disableAutoSweep: true` ao criar o endereço via API
    * Ou ative **Desabilitar Auto Sweep** nas configurações do endereço no painel
  </Accordion>

  <Accordion title="Desativei o auto-sweep mas os fundos ainda foram movidos">
    Verifique ambos os níveis de configuração:

    * **Nível da carteira master** — define o padrão para todos os endereços
    * **Nível do endereço** — sobrescreve a configuração da carteira master

    A configuração no nível do endereço sempre tem prioridade. Verifique se o endereço específico tem `disableAutoSweep: true`.
  </Accordion>

  <Accordion title="Posso definir um limite para o auto-sweep?">
    Sim. Você pode configurar limites de sweep para que os fundos só sejam transferidos automaticamente quando um determinado saldo for atingido.

    [Configuração da Carteira →](/pt/essentials/wallets)
  </Accordion>
</AccordionGroup>

## Taxas de Gas e Custos de Rede

<AccordionGroup>
  <Accordion title="Como funcionam as taxas de gas?">
    As taxas de gas são pagas diretamente à blockchain no token nativo:

    | Blockchain                       | Token Nativo |
    | -------------------------------- | ------------ |
    | Ethereum / Base / Polygon / etc. | ETH          |
    | Tron                             | TRX          |
    | Solana                           | SOL          |

    O Blockradar não cobra taxas adicionais sobre os custos de rede.
  </Accordion>

  <Accordion title="Por que as taxas da Tron são mais altas que as de outras blockchains?">
    As taxas da rede Tron geralmente ficam entre \$1–6 por transação devido à forma como a Tron gerencia largura de banda e energia. Este é um custo no nível da blockchain, não uma cobrança do Blockradar.

    Alternativas de menor custo:

    * **Solana:** \~\$0.01–0.30 por transação
    * **Base:** \~\$0.01–0.10 por transação
    * **Polygon:** \~\$0.01–0.10 por transação
  </Accordion>

  <Accordion title="A taxa de rede estimada foi maior que a taxa real cobrada">
    O endpoint `/withdraw/network-fee` retorna uma estimativa conservadora para garantir que as transações sejam bem-sucedidas mesmo durante alta congestão da rede. Você é cobrado apenas pela taxa de rede real, que normalmente é inferior à estimativa.
  </Accordion>

  <Accordion title="Posso pagar taxas de gas em USDT/USDC em vez de tokens nativos?">
    Não, as taxas de gas da blockchain devem ser pagas no token nativo da rede. No entanto, você pode ativar saques gasless para que sua carteira master patrocine o gas para transações de endereços filhos.
  </Accordion>
</AccordionGroup>

## Transações Gasless

<AccordionGroup>
  <Accordion title="Como ativo saques gasless?">
    Quando o gasless está ativado, a carteira master paga as taxas de gas em nome dos saques de endereços filhos.

    Para ativar:

    * **Nível da carteira master:** Painel → Configurações da Carteira Master → Ativar Transações Gasless
    * **Nível do endereço:** Defina `enableGaslessWithdraw: true` ao criar ou atualizar um endereço

    Você também pode definir limites para que apenas saques acima ou abaixo de certos valores sejam cobertos.

    [Transações Gasless →](/pt/essentials/withdrawals) · [Parâmetros de Endereço →](/pt/essentials/addresses)
  </Accordion>

  <Accordion title="Qual carteira paga o gas — master ou endereço filho?">
    Depende da configuração `enableGaslessWithdraw`:

    * **Ativado (`true`):** A carteira master paga o gas
    * **Desativado (`false`, padrão):** O endereço filho precisa do seu próprio gas
  </Accordion>
</AccordionGroup>

## Swaps e Bridges

<AccordionGroup>
  <Accordion title="Quais swaps são suportados?">
    O Blockradar suporta apenas swaps entre stablecoins: USDT, USDC, DAI, BUSD, cUSD, cNGN, EURC, IDRX, JPYC.

    Swaps de tokens nativos e bridging estão disponíveis em todas as blockchains suportadas, exceto Tron.
  </Accordion>

  <Accordion title="Estou recebendo 'No swap quotes available'">
    Isso geralmente significa que o par de swap não é suportado (ex: swap para um token nativo), ou o valor é muito pequeno ou muito grande para a liquidez disponível.
  </Accordion>

  <Accordion title="Estou recebendo 'Wallet not found or not active' no swap">
    Este erro geralmente significa que você está usando o asset ID errado. Você precisa usar o **asset ID específico da carteira**, não um asset ID geral.

    Para encontrar o ID correto:

    * **Painel:** Acesse sua carteira → Ativos → Copie o asset ID de lá
    * **API:** Use os asset IDs retornados do endpoint de detalhes da sua carteira
  </Accordion>

  <Accordion title="Posso fazer swaps entre blockchains diferentes?">
    Sim. Você pode trocar e fazer bridge de ativos entre diferentes blockchains via painel ou API. Para swaps entre blockchains via API, passe o asset ID da carteira master de destino como `toAssetId`.

    [Documentação de Swap →](/pt/essentials/swap)
  </Accordion>
</AccordionGroup>

## Configuração de Carteira

<AccordionGroup>
  <Accordion title="Posso criar múltiplas Carteiras Master para uma blockchain?">
    O Blockradar permite apenas uma Carteira Master por rede blockchain por conta. Para suportar uma blockchain adicional, você deve criar uma Carteira Master separada para ela. Dentro de uma única Carteira Master, você pode criar quantos endereços filhos forem necessários para segmentar fundos por usuário, aplicação ou finalidade. Criar múltiplas Carteiras Master para a mesma blockchain não é suportado.
  </Accordion>

  <Accordion title="Posso excluir endereços?">
    Não, endereços não podem ser excluídos devido a limitações da blockchain. Você pode apenas desativá-los no painel. Endereços desativados não receberão novos depósitos nem serão monitorados.
  </Accordion>

  <Accordion title="Como exporto chaves privadas?">
    Use o parâmetro `showPrivateKey: true` ao consultar detalhes da carteira ou endereço via API.

    <Warning>Use apenas em ambientes seguros e confiáveis.</Warning>
  </Accordion>
</AccordionGroup>

## Saques e Transferências

<AccordionGroup>
  <Accordion title="Como faço um saque de um endereço filho para uma carteira externa?">
    Use o endpoint de saque da API: `POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw`

    [Documentação de Saques →](/pt/essentials/withdrawals)
  </Accordion>

  <Accordion title="Minha transação está presa em 'pending'">
    Causas comuns:

    * Gas insuficiente na carteira master (se usando gasless) ou no endereço filho
    * Processamento em fila — transações são processadas sequencialmente devido aos nonces da blockchain
    * Problemas de nó — atrasos temporários

    Se estiver presa por mais de 30 minutos, entre em contato com o suporte com o ID da transação.
  </Accordion>

  <Accordion title="Como movo fundos entre a carteira master e endereços filhos?">
    Todas as movimentações de fundos on-chain usam o endpoint de saque. Não há um endpoint separado de "transferência".

    * **Master para filho:** `POST /v1/wallets/{walletId}/withdraw` com o endereço filho como destino
    * **Filho para master:** `POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw` com o endereço da carteira master como destino
    * **Filho para externo:** Mesmo endpoint, endereço externo como destino

    [Documentação de Saques →](/pt/essentials/withdrawals)
  </Accordion>

  <Accordion title="Como obtenho o histórico de transações de um endereço filho específico?">
    Use o endpoint de transações com o parâmetro de consulta address:

    ```
        GET /v1/wallets/{walletId}/transactions?address={addressId}
    ```

    [Documentação de Transações →](/pt/api-reference/transactions/get-transactions)
  </Accordion>
</AccordionGroup>

## Recuperação de Ativos

<AccordionGroup>
  <Accordion title="Enviei fundos para a blockchain errada ou um ativo não suportado">
    Use a Recuperação de Ativos no painel.

    [Recuperação de Ativos →](/pt/essentials/asset-recovery)
  </Accordion>
</AccordionGroup>

## Testnet vs. Mainnet

<AccordionGroup>
  <Accordion title="Enviei fundos da mainnet para um endereço de testnet — meus fundos foram perdidos?">
    Não, seus fundos não foram perdidos. Mainnet e testnet são redes separadas, mas os endereços são criptograficamente vinculados. Você pode recuperar fundos usando a Recuperação de Ativos.

    [Recuperação de Ativos →](/pt/essentials/asset-recovery)

    <Tip>Sempre verifique o indicador de ambiente no painel (mostra "Test Mode" ou "Live Mode") antes de transacionar.</Tip>
  </Accordion>

  <Accordion title="Como mudo da testnet para a mainnet?">
    1. Use o alternador de ambiente no seu painel (geralmente no canto superior direito ou nas configurações da carteira)
    2. Mude de **Testnet** para **Live**
    3. Crie uma nova carteira master para a mainnet
    4. Atualize suas chaves de API — chaves de testnet não funcionam na mainnet

    <Warning>Endereços de testnet não podem receber fundos da mainnet e vice-versa.</Warning>
  </Accordion>

  <Accordion title="Onde posso obter tokens de testnet?">
    | Blockchain         | Faucet                                                                              |
    | ------------------ | ----------------------------------------------------------------------------------- |
    | Ethereum (Sepolia) | [Sepolia Faucet](https://sepoliafaucet.com) ou [Alchemy](https://sepoliafaucet.com) |
    | BNB Chain          | [BNB Testnet Faucet](https://testnet.bnbchain.org/faucet-smart)                     |
    | Polygon (Amoy)     | [Polygon Faucet](https://faucet.polygon.technology)                                 |
    | Base               | [Alchemy Faucet](https://www.alchemy.com/faucets/base-sepolia)                      |
    | Tron (Nile)        | [Nile Testnet](https://nileex.io/join/getJoinPage)                                  |
    | Solana             | [Solana Faucet](https://faucet.solana.com)                                          |
    | Circle USDC        | [Circle Faucet](https://faucet.circle.com)                                          |
  </Accordion>
</AccordionGroup>

## Erros de API e Solução de Problemas

<AccordionGroup>
  <Accordion title="&#x22;Wallet not found or not active&#x22;">
    Causas comuns:

    * Wallet ID errado
    * Chave de API errada (não corresponde à carteira)
    * Usando um asset ID geral em vez de um asset ID específico da carteira
  </Accordion>

  <Accordion title="&#x22;Internal Server Error&#x22; / erros 500">
    Geralmente é um problema temporário. Se persistir, entre em contato com o suporte informando o endpoint que você está chamando, a blockchain/rede e a resposta completa do erro.
  </Accordion>

  <Accordion title="401 Unauthorized">
    Sua chave de API é inválida ou não corresponde à carteira que você está tentando acessar. Verifique se:

    * A chave de API está correta (sem espaços extras)
    * A chave de API pertence a esta carteira
    * Você não está usando uma chave de testnet na mainnet (ou vice-versa)
    * A chave de API não foi rotacionada ou regenerada
  </Accordion>

  <Accordion title="404 Not Found">
    O recurso (carteira, endereço ou ativo) não existe ou você está usando o ID errado. Causas comuns incluem wallet ID ou address ID errado, uso de um asset ID geral em vez de um específico da carteira, ou erro de digitação na URL do endpoint.
  </Accordion>
</AccordionGroup>

## Contas Virtuais e cNGN

<AccordionGroup>
  <Accordion title="Como configuro Contas Virtuais para depósitos em NGN?">
    Contas Virtuais permitem que seus usuários depositem NGN (Naira Nigeriana), que é automaticamente convertido em stablecoins on-chain.

    Requisitos:

    * Deve estar no modo mainnet/Live (não testnet)
    * Deve completar a verificação KYB

    [Documentação de Contas Virtuais →](/pt/essentials/virtual-accounts)
  </Accordion>

  <Accordion title="Contas Virtuais não aparecem no meu painel">
    Contas Virtuais só aparecem se você estiver no modo Live, sua conta tiver completado a verificação KYB e o recurso tiver sido habilitado para sua conta.
  </Accordion>

  <Accordion title="O que é cNGN?">
    cNGN é uma stablecoin atrelada à Naira Nigeriana. O Blockradar suporta transações com cNGN e swaps com outras stablecoins.
  </Accordion>
</AccordionGroup>

## Rampas de Entrada/Saída Fiat

<AccordionGroup>
  <Accordion title="Como os usuários depositam fiat (NGN) e recebem crypto?">
    Use Contas Virtuais para NGN:

    1. Gere uma Conta Virtual para o usuário
    2. O usuário deposita NGN via transferência bancária ou mobile money
    3. Os fundos são automaticamente convertidos em stablecoins e aparecem on-chain

    [Documentação de Contas Virtuais →](/pt/essentials/virtual-accounts)
  </Accordion>

  <Accordion title="Vocês suportam outras moedas fiduciárias além de NGN?">
    Atualmente, Contas Virtuais suportam apenas NGN. Para outras moedas, você precisará integrar com provedores terceiros de off-ramp fiat, isso permitirá que você faça off-ramp para KES, NGN, TZS, UGX, BRL e MWK. Veja [Retirar Fiat](/pt/use-cases/withdraw-fiat).
  </Accordion>
</AccordionGroup>

## Solicitações de Recursos

<AccordionGroup>
  <Accordion title="Vocês suportam Bitcoin (BTC)?">
    Não. O Blockradar é focado em stablecoins. Bitcoin não é suportado atualmente.
  </Accordion>

  <Accordion title="Vocês adicionarão suporte para uma nova blockchain ou token?">
    O Blockradar é agnóstico em relação a blockchains e stablecoins — redes e ativos adicionais podem ser integrados sob demanda. [Entre em contato conosco](mailto:info@blockradar.co) para discutir seus requisitos.
  </Accordion>
</AccordionGroup>

## Cobrança e Assinaturas

<AccordionGroup>
  <Accordion title="Posso pagar minha assinatura com stablecoins?">
    Sim. Você pode pagar via link de pagamento enviado para seu e-mail, ou sacar da sua carteira master para o endereço do link de pagamento.
  </Accordion>

  <Accordion title="Posso pagar com cartão de crédito?">
    Atualmente, aceitamos apenas pagamentos com stablecoins para assinaturas.
  </Accordion>
</AccordionGroup>

## Blockchains e Ativos Suportados

<AccordionGroup>
  <Accordion title="Quais blockchains o Blockradar suporta?">
    Ethereum, BNB Chain, Polygon, Tron, Base, Arbitrum, Optimism, Solana, Celo, Lisk, Avalanche, Asset Chain, Plasma, e Tempo.

    O Blockradar é agnóstico em relação a blockchains e stablecoins — redes adicionais podem ser integradas sob demanda.
  </Accordion>

  <Accordion title="Quais stablecoins o Blockradar suporta?">
    USDT, USDC, DAI, BUSD, cUSD, cNGN, EURC, IDRX, JPYC.

    Ativos adicionais podem ser integrados sob demanda.
  </Accordion>
</AccordionGroup>

## Dicas para Desenvolvedores

<AccordionGroup>
  <Accordion title="Qual a diferença entre wallet ID, address ID e asset ID?">
    * **Wallet ID:** Identifica sua carteira master
    * **Address ID:** Identifica um endereço filho específico dentro de uma carteira
    * **Asset ID:** Identifica um ativo específico (USDT, USDC, etc.) dentro da sua carteira

    <Warning>Sempre use o asset ID específico da carteira, encontrado na lista de ativos da sua carteira, não um asset ID geral.</Warning>
  </Accordion>

  <Accordion title="Melhores práticas para produção">
    * Sempre use o modo mainnet/Live para transações reais
    * Armazene wallet IDs e address IDs no seu banco de dados
    * Implemente handlers de webhook para atualizações de transações em tempo real
    * Use o Deposit Finder como backup para transações perdidas
    * Monitore o saldo da carteira master para gas (tokens nativos)
    * Ative saques gasless se seus usuários não precisarem manter tokens nativos
  </Accordion>
</AccordionGroup>

## Precisa de Ajuda?

<CardGroup cols={3}>
  <Card title="Documentação" icon="book" href="https://docs.blockradar.co">
    docs.blockradar.co
  </Card>

  <Card title="Painel" icon="gauge" href="https://dashboard.blockradar.co">
    dashboard.blockradar.co
  </Card>

  <Card title="Agendar Suporte" icon="calendar" href="https://calendly.com/daniel-blockradar/blockradar-tech-support">
    Agende aqui
  </Card>
</CardGroup>