A Hodle oferece carteiras e operações por API. No fluxo por PIN, a aplicação fornece as credenciais da carteira e o servidor assina temporariamente em memória. Conheça esse modelo antes de definir as permissões do seu produto.
USDT
USDC
Polygon
BaseAuto-custódia diz respeito a quem controla a autorização de assinatura. Para avaliar uma integração, é necessário conhecer quem guarda as credenciais e onde a transação é assinada.
No fluxo por PIN documentado pela Hodle, a aplicação envia walletPin e protectedSymmetricKey da carteira de origem. O servidor usa essas credenciais para desbloquear a chave temporariamente em memória, assinar e descartá-la. A documentação descreve armazenamento de chaves criptografadas e exige as credenciais da origem a cada transferência.
A aplicação que possui as credenciais de assinatura pode solicitar movimentações no escopo permitido. Por isso, a integração deve definir quem pode autorizar uma operação, quais carteiras cada usuário alcança e como proteger PINs e chaves protegidas. A descrição técnica do fluxo não determina, por si só, o enquadramento jurídico de custódia.
Use walletId para selecionar a origem e mantenha as credenciais dessa carteira associadas ao titular correto. Em transferências de subcontas, informe fromSubAccountId; em consultas e payouts, subAccountId. Uma carteira de outro titular ou escopo é rejeitada.
Crie uma carteira apenas quando precisar de uma nova e guarde o walletId retornado. Consultas e movimentações devem reutilizar esse identificador.
A matriz abaixo é de POST /api/wallet/transfer. A operação envia tokens na mesma rede; não faz bridge. A criação de wallets, o payout Pix e o fluxo Lightning têm contratos próprios.
USDTUSDCPolygonBasePOST /api/wallet/payout inicia um Pix financiado pelo saldo elegível da carteira. O recebedor recebe reais; a seleção do ativo segue as regras de saldo e preferência do endpoint. A resposta inicial traz transactionId para acompanhamento e não confirma a liquidação.
Tire suas dúvidas sobre carteiras auto-custodiais para empresas.
Auto-custódia trata do controle da autorização de assinatura. Na integração por PIN da Hodle, a aplicação fornece walletPin e protectedSymmetricKey, e o servidor desbloqueia a chave temporariamente em memória para assinar. Avalie quem controla essas credenciais e permissões no seu produto.
Auto-custódia trata de quem controla a assinatura; MPC é uma técnica de computação com múltiplas partes. Uma técnica não define sozinha quem pode autorizar movimentações. O fluxo descrito nesta página usa PIN e chave protegida conforme a documentação da Hodle; não pressupõe MPC.
Depende das credenciais e permissões que ela controla. No fluxo por PIN, uma integração com API key, walletPin e protectedSymmetricKey válidos pode solicitar movimentações da carteira autorizada. A API key sozinha não substitui essas credenciais. A plataforma deve proteger os PINs das subcontas e controlar cada autorização.
Depende da operação. Wallet Transfer suporta Polygon com USDT/USDC/BRLA, Base com USDC/BRLA, Solana com USDT/USDC/BRS e BNB Chain com USDT BEP20. BRS e BNB exigem habilitações específicas; BNB não funciona no sandbox. Tron com USDT é documentada para Wallet Payout, não para Wallet Transfer. Lightning usa um fluxo separado.
Crie a carteira com POST /api/wallet/create e PIN de seis dígitos, guarde o walletId e consulte a carteira com POST /api/wallet/get. POST /api/wallet/keys retorna a chave protegida e o email do proprietário: faça cache por walletId com esse email e atualize quando a chave mudar. Para transferir, envie as credenciais da carteira de origem e uma combinação de rede e ativo suportada.
