Carteiras em que a chave é do usuário

O que é uma carteira auto-custodial

Numa carteira auto-custodial, a chave privada fica sob controle exclusivo de quem é dono dos ativos. Não existe um terceiro que possa mover o saldo, congelar a conta ou devolver o acesso — o controle é de quem tem a chave, e só. É o oposto do modelo custodial, em que a plataforma guarda a chave e o usuário tem um saldo registrado num banco de dados. Os dois modelos existem e resolvem problemas diferentes. O que a Hodle entrega é o primeiro.

• A chave privada fica sob controle exclusivo do usuário final.
• A Hodle não custodia fundos nem ativos de clientes.
• A empresa que integra não ganha acesso aos fundos dos usuários dela.
• O saldo é on-chain, verificável na rede, não um registro interno.

O que muda para a empresa que integra

Oferecer carteira sem custodiar muda a sua exposição. Você não passa a guardar ativo de terceiro, não precisa construir a operação de custódia e não vira o ponto único de falha do saldo dos seus usuários. Em troca, o desenho do produto tem que respeitar o modelo: operação que move fundo exige a chave do usuário. É por isso que a API expõe o protectedSymmetricKey — sem ele, não há payout nem transfer.

• Você embute carteira no seu produto sem assumir custódia.
• A operação de recuperação e de segurança da chave fica no desenho do seu fluxo.
• Movimentação exige a chave do usuário, por construção.

Como integrar a carteira por API

Três chamadas cobrem leitura, assinatura e movimentação.

1. 1Ler a carteira. Um GET devolve os endereços por rede e os saldos atuais do usuário da API key. Guia em docs.hodle.com.br/docs/wallet-get.
2. 2Buscar a chave. Um GET devolve o protectedSymmetricKey necessário para assinar payouts e transfers. Faça cache uma vez por usuário.
3. 3Movimentar. Um POST envia USDT para qualquer endereço em Polygon, Base ou Tron. O gas em redes EVM é patrocinado pela Hodle.
4. 4Acompanhar. O extrato devolve saldo por ativo e operações paginadas, e o webhook assinado com HMAC avisa cada mudança de estado.

Uma carteira, várias redes

A mesma carteira endereça Bitcoin on-chain e Lightning, USDT em Polygon e Tron, USDC em Base, e as duas stablecoins em Arbitrum e Spark. O usuário não gerencia uma carteira por rede.

Bitcoin

Lightning

USDT

USDC

Polygon

Tron

Base

Arbitrum

Spark

A carteira que também paga Pix

A diferença prática entre uma carteira auto-custodial genérica e a da Hodle é a saída em reais. O saldo em USDT ou USDC da carteira financia um Pix, sem etapa manual de venda: um POST dispara o pagamento e quem recebe cai em reais. É a mesma carteira, o mesmo saldo e a mesma chave. O trilho brasileiro fica do lado da Hodle.

• Pagar Pix com o saldo da carteira, sem converter antes.
• Receber por invoice Lightning e liquidar em Pix.
• Converter reais em USDT, USDC, USDCE ou Lightning.