Introdução
API Reference
Introdução
API Reference
  1. Introdução
  • Guia de Integração Rápida
  • Wallets ERC-4337
  • Tokens ERC-20
Introdução
API Reference
Introdução
API Reference
  1. Introdução

Tokens ERC-20

Guia de Tokenização de Ativos#

🎯 Visão Geral#

A TokenOne permite que você tokenize ativos financeiros e crie tokens digitais personalizados na blockchain Polygon, transformando ativos do mundo real em tokens ERC-20 negociáveis, rastreáveis e programáveis.
Com nossa plataforma, você pode lançar novos ativos tokenizados em minutos, sem precisar entender smart contracts ou gerenciar infraestrutura blockchain.

💡 O que é Tokenização de Ativos?#

Tokenização é o processo de representar ativos do mundo real como tokens digitais na blockchain. Cada token é:
📊 Rastreável - Todas as transferências ficam registradas permanentemente
🔒 Programável - Você define regras de negócio (quem pode transferir, limites, etc.)
🔄 Negociável - Mercado secundário 24/7
✂️ Fracionável - Divida ativos caros em partes menores
🌐 Global - Acesso de qualquer lugar do mundo
Exemplo:
Debênture de R$ 10 milhões
   ↓ (tokenização)
10.000 tokens de R$ 1.000 cada
   ↓
Investidor compra 10 tokens = R$ 10.000 investidos

🚀 Por Que Tokenizar com a TokenOne?#

Comparação: Tradicional vs Tokenizado#

AspectoMercado TradicionalTokenOne (Tokenizado)
Tempo de Estruturação3-6 meses1-2 semanas
Custo de Estruturação2-5% do volume0.5-1% do volume
Horário de Negociação10h-17h (dias úteis)24/7
LiquidaçãoD+2 a D+3Instantânea
Ticket MínimoR$ 100.000+R$ 100+ (fracionado)
Mercado SecundárioLimitadoSempre disponível
AuditoriaTrimestral/AnualTempo real
Custos OperacionaisAlto (custódia, escrituração)Baixo (automatizado)

💼 Casos de Uso: Ativos Financeiros Tokenizados#

Caso 1: Debêntures Tokenizadas#

O que são? Títulos de dívida emitidos por empresas para captar recursos.
Problema Tradicional:
Emissão cara (bancos cobram 2-5% de estruturação)
Acessível apenas para investidores qualificados (ticket mínimo alto)
Mercado secundário limitado
Pagamento manual de cupons (risco de erro)
Solução Tokenizada:
1.
Estruturação
Empresa define: valor nominal, taxa (ex: CDI + 2%), vencimento
TokenOne cria token representando a debênture
Metadados incluem: CNPJ, série, garantias, rating
2.
Emissão e Distribuição
Investidores subscrevem via plataforma
Tokens alocados instantaneamente nas wallets
Fracionamento permite tickets baixos (ex: R$ 1.000)
3.
Vida do Ativo
Pagamento de cupons automatizado (busca detentores on-chain)
Amortizações programadas
Negociação secundária entre investidores
4.
Vencimento
Resgate final com queima (burn) dos tokens
Distribuição de valores via TED/PIX
Benefícios:
✅ Democratização - Acesso para varejo (tickets baixos)
✅ Custo reduzido - 70-80% menor que estruturação tradicional
✅ Liquidez - Mercado secundário ativo
✅ Transparência - Investidor vê tudo on-chain
✅ Automação - Cupons pagos automaticamente
Exemplo Real:
Empresa XYZ precisa captar R$ 50 milhões
Taxa: CDI + 2.5%
Prazo: 5 anos
Cupom: Semestral

Tradicional:
Banco estrutura → 6 meses → Custo: R$ 1,5 milhão (3%)
Ticket mínimo: R$ 300.000
Investidores: ~150

Tokenizado:
TokenOne estrutura → 2 semanas → Custo: R$ 400 mil (0.8%)
Ticket mínimo: R$ 1.000
Investidores: Potencial de 10.000+ ✅

Caso 2: CRI/CRA (Certificados de Recebíveis)#

O que são? Títulos lastreados em recebíveis imobiliários (CRI) ou do agronegócio (CRA).
Problema Tradicional:
Estruturação via securitizadora (custos altos)
Pouca liquidez no secundário
Gestão manual de recebíveis
Informação fragmentada para investidores
Solução Tokenizada:
1.
Estruturação do Lastro
Originador cede recebíveis para a tokenizadora
Cada recebível vira um token ou pool de tokens
Metadados: origem, vencimento, taxa, devedor, garantias
2.
Emissão
Tokens emitidos proporcionalmente ao valor dos recebíveis
Fracionamento permite diversificação
Rating e due diligence on-chain
3.
Gestão de Fluxo
Recebíveis pagos → distribuição automática aos detentores
Inadimplência registrada on-chain
Substituição de recebíveis (se permitido)
4.
Vencimento
Últimos recebíveis liquidados
Queima total dos tokens
Prestação de contas transparente
Benefícios:
✅ Rastreabilidade - Cada recebível mapeado on-chain
✅ Fracionamento - Investidor diversifica entre vários CRIs
✅ Transparência - Status de pagamento em tempo real
✅ Liquidez - Mercado secundário sempre ativo
✅ Custos - Sem intermediação bancária pesada
Exemplo Real:
Pool de Recebíveis Imobiliários
100 contratos de aluguel comercial
Valor: R$ 20 milhões
Prazo médio: 3 anos
Taxa: IPCA + 6%

Tokenizado:
→ 20.000 tokens de R$ 1.000
→ Investidor compra 100 tokens = exposição a R$ 100 mil do pool
→ Recebe mensalmente pro-rata dos aluguéis
→ Pode vender tokens no secundário a qualquer momento

Caso 3: CCB (Cédula de Crédito Bancário) Tokenizada#

O que é? Título de crédito que representa uma operação de empréstimo.
Problema Tradicional:
Cessão de CCB burocrática (cartórios, registros)
Sem mercado secundário ativo
Rastreamento manual de garantias
Dificuldade de fracionamento
Solução Tokenizada:
1.
Originação
Banco/Fintech concede crédito
Cria token representando a CCB
Metadados: devedor, valor, garantias, vencimento, taxa
2.
Cessão e Negociação
Banco pode ceder (vender) CCB para investidores
Transferência instantânea de propriedade via blockchain
Fracionamento permite múltiplos investidores em uma CCB
3.
Gestão de Garantias
Garantias registradas on-chain (hash de documentos)
Execução programável em caso de inadimplência
Notificações automáticas
4.
Liquidação
Devedor paga → distribuição automática aos detentores
Queima do token
Liberação de garantias
Benefícios:
✅ Cessão ágil - Sem cartório, tudo on-chain
✅ Mercado secundário - Banco/Fintech vende portfólio facilmente
✅ Transparência - Status de pagamento rastreável
✅ Fracionamento - Permite diversificação de risco
✅ Conformidade - Auditoria automática para BACEN
Exemplo Real:
Fintech tem 500 CCBs no balanço (R$ 10 milhões)
Quer vender para liberar capital

Tradicional:
Ceder para FIDC → 4-8 semanas → Deságio de 15-20%

Tokenizado:
Tokenizar CCBs → Vender no mercado secundário → 1-2 dias
Deságio menor (10-12%) devido à transparência
Pode vender frações (não precisa vender tudo)

Caso 4: Precatórios Tokenizados#

O que são? Dívidas do governo com decisão judicial definitiva.
Problema Tradicional:
Espera de anos para receber
Mercado secundário opaco (poucos compradores)
Deságios altos (50-70%)
Falta de transparência
Solução Tokenizada:
1.
Tokenização do Precatório
Credor tokeniza seu direito de receber
Metadados: processo, valor, ente devedor, previsão de pagamento
NFT ou fungível (se fracionado)
2.
Negociação
Mercado aberto de compradores
Preços transparentes (histórico on-chain)
Fracionamento permite venda parcial
3.
Recebimento
Quando governo paga → distribuição automática aos detentores
Queima dos tokens
Comprovante na blockchain
Benefícios:
✅ Liquidez - Mercado ativo de compradores
✅ Transparência - Histórico de preços on-chain
✅ Fracionamento - Credor pode vender só parte
✅ Deságios menores - Competição entre compradores
✅ Rastreabilidade - Auditoria completa

Caso 5: Fundos de Investimento Tokenizados#

O que são? Cotas de fundos representadas como tokens.
Problema Tradicional:
Aplicação/resgate só em horário comercial
Liquidação D+1 ou mais
Custos de custódia altos
Distribuição limitada a plataformas bancárias
Solução Tokenizada:
1.
Estruturação
Gestora cria token de cotas
Supply ajustável (mint/burn conforme aplicações/resgates)
Metadados: CNPJ, estratégia, taxa de administração
2.
Aplicação
Investidor deposita via PIX
Cotas emitidas instantaneamente
D+0 em vez de D+1
3.
Resgate
Queima de cotas automática
Pagamento via PIX/TED
Tudo em minutos
4.
Gestão
Cota atualizada diariamente
Patrimônio líquido auditável on-chain
Distribuição 24/7
Benefícios:
✅ Distribuição 24/7 - Sem horário bancário
✅ Liquidação D+0 - Cotas na hora
✅ Custos reduzidos - Sem custodiante tradicional
✅ Transparência - PL auditável em tempo real
✅ Conformidade CVM - Smart contracts auditáveis

Caso 6: FIDC Tokenizado (TIDC - Token de Investimento em Direitos Creditórios)#

O que é? Fundo que investe em direitos creditórios (duplicatas, cheques, contratos), mas tokenizado on-chain.
Problema do FIDC Tradicional:
Estruturação cara (securitizadora + custodiante + administrador)
Ticket mínimo alto (R25.000−R 100.000)
Pouca liquidez no secundário
Gestão manual de cotas e recebíveis
Falta de transparência para investidores (relatórios mensais/trimestrais)
Custos operacionais altos (2-3% ao ano)
Solução TIDC (Tokenizado):
1.
Estruturação do Fundo
Gestora cria TIDC (token de cotas)
Define política de investimento (tipos de recebíveis aceitos)
Metadados: CNPJ, gestora, taxa de administração, rating mínimo
2.
Captação de Recursos
Investidores subscrevem cotas via PIX/TED
Tokens emitidos instantaneamente (D+0)
Fracionamento permite tickets baixos (R$ 100+)
Distribuição 24/7 (sem horário bancário)
3.
Aquisição de Recebíveis
Gestora compra recebíveis (duplicatas, CCBs, etc.)
Cada recebível registrado on-chain (metadados)
Diversificação automática do portfólio
Transparência total: investidor vê composição do fundo
4.
Gestão do Portfólio
Recebíveis pagos → distribuição automática aos cotistas (pro-rata)
Inadimplência registrada on-chain
Substituição/venda de recebíveis rastreável
PL (Patrimônio Líquido) atualizado em tempo real
5.
Resgate de Cotas
Investidor solicita resgate
Queima (burn) de tokens
Pagamento via PIX/TED
Liquidação D+0 (se houver liquidez)
6.
Mercado Secundário
Cotistas vendem cotas entre si
Preços transparentes (histórico on-chain)
Liquidez contínua
Sem dependência de resgates do fundo
Benefícios:
✅ Democratização - Tickets baixos (R100vs.R 25.000)
✅ Custo reduzido - 70-80% menor que FIDC tradicional
✅ Transparência - Portfólio auditável em tempo real
✅ Liquidez - Mercado secundário ativo 24/7
✅ Distribuição D+0 - Juros/amortizações instantâneas
✅ Conformidade CVM - Smart contracts auditáveis
Exemplo Real:
TIDC - Recebíveis Comerciais Brasil

Estratégia: Compra de duplicatas com rating A/B
Ticket mínimo: R$ 500
Prazo médio dos recebíveis: 60 dias
Rentabilidade alvo: CDI + 3%

Portfólio (transparente on-chain):
→ 200 duplicatas de 150 empresas diferentes
→ Valor total: R$ 10 milhões
→ Diversificação setorial: varejo (40%), indústria (35%), serviços (25%)
→ Inadimplência: 1.2% (vs. 3-5% mercado)

Investidor compra:
→ 1.000 cotas de R$ 1 cada = R$ 1.000 investidos
→ Exposição automaticamente diversificada em 200 recebíveis
→ Recebe juros diários conforme recebíveis são pagos
→ Pode vender cotas no secundário a qualquer momento

vs. FIDC Tradicional:
→ Ticket: R$ 25.000 (25x maior)
→ Transparência: Relatórios mensais (vs. tempo real)
→ Liquidez: Resgate com carência (vs. venda imediata)
→ Custos: 2.5% a.a. (vs. 0.8% a.a. tokenizado)
Diferenciais do TIDC:
1.
Transparência Total
Cada recebível mapeado on-chain
Investidor vê exatamente onde seu dinheiro está
Status de pagamento em tempo real
Inadimplência visível imediatamente
2.
Liquidez Programável
Cotistas vendem entre si 24/7
Sem fila de resgate
Preços de mercado transparentes
Market makers podem prover liquidez
3.
Compliance Automatizado
KYC/AML via blocklist
Limitação de concentração programável
Relatórios CVM gerados automaticamente
Auditoria contínua
4.
Custos Reduzidos
Sem custodiante tradicional (blockchain é o custodiante)
Escrituração automática (smart contracts)
Distribuição de rendimentos automatizada
Gestão de cotas sem intermediários

🔧 Funcionalidades da Plataforma TokenOne#

1. Criação de Tokens (Deploy)#

Crie tokens ERC-20 personalizados com:
Nome e Símbolo customizáveis (ex: "Debênture XYZ 2025", "DEBXYZ25")
Decimais configuráveis (2 para valores em centavos, 18 para cripto)
Supply inicial e máximo (controle de inflação)
Metadados ilimitados (JSON com CNPJ, vencimento, garantias, etc.)
Características:
Deploy em minutos, não semanas
Contratos auditados (padrão OpenZeppelin)
Gas patrocinado (usuários não pagam)

2. Emissão de Tokens (Mint)#

Crie novos tokens e aloque para investidores:
Destinatário (endereço da wallet)
Quantidade em formato legível (ex: 1000.50)
Razão (ex: "Subscrição de debênture")
Metadados (investidor, data, etc.)
Quando usar:
Aplicações em fundos
Subscrições de debêntures
Emissão de novos recebíveis
Bonificações/distribuição de dividendos

3. Queima de Tokens (Burn)#

Destrua tokens permanentemente:
De uma wallet específica (burn-from)
Quantidade a queimar
Razão (ex: "Resgate de cotas")
Quando usar:
Resgates de fundos
Amortização de debêntures
Liquidação de recebíveis
Redução de supply

4. Transferências#

Mova tokens entre wallets:
Origem e Destino
Quantidade em formato legível
Razão (ex: "Negociação secundária")
Metadados (preço, comprador, etc.)
Quando usar:
Cessão de CCBs
Venda no mercado secundário
Distribuição entre investidores

5. Controles Regulatórios#

Pausar/Despausar (Pause/Unpause)#

Congele TODAS as transferências de um token temporariamente.
Quando usar:
Investigação de fraude
Manutenção programada
Conformidade com ordem judicial
Mudanças regulatórias

Blocklist (Lista de Bloqueio)#

Bloqueie endereços específicos de operar com o token.
Quando usar:
Conformidade KYC/AML
Ordens judiciais
Atividade suspeita
Investidores não qualificados

6. Auditoria Completa#

Todos os eventos ficam registrados:
Quem fez a operação
Quando (timestamp)
Qual operação (mint, burn, transfer, etc.)
Valores envolvidos
Status (sucesso/falha)
Hash da transação na blockchain
Benefícios:
✅ Relatórios para CVM/BACEN
✅ Compliance LGPD
✅ Rastreabilidade total
✅ Prova de custódia

🔒 Segurança e Compliance#

Proteção de Chaves Privadas#

┌─────────────────────────────────────────┐
│  AWS Key Management Service (KMS)        │
│  • Chaves nunca expostas                 │
│  • Criptografia FIPS 140-2               │
│  • Auditoria de acessos (CloudTrail)     │
└─────────────────────────────────────────┘
           │ assina transações
           ▼
┌─────────────────────────────────────────┐
│  Platform Owner EOA                      │
│  • Controla todos os tokens              │
│  • Você gerencia via API                 │
└─────────────────────────────────────────┘
Boas práticas:
✅ API Key guardada em variáveis de ambiente
✅ HTTPS obrigatório em todas as chamadas
✅ Rate limiting configurável
✅ Webhooks para monitoramento em tempo real
✅ Logs de auditoria completos

Conformidade Regulatória#

CVM (Comissão de Valores Mobiliários)#

✅ Instrução CVM 555 (Crowdfunding de Investimento)
Registro público de todas as operações
Rastreabilidade de investidores
Limitação de valores por investidor (programável via blocklist)
✅ Instrução CVM 476 (Ofertas Restritas)
Controle de investidores qualificados
Vedação de publicidade (off-chain)
Registro de distribuição
✅ Fundos de Investimento
Cotas rastreáveis on-chain
PL auditável em tempo real
Conformidade com administrador/custodiante

BACEN (Banco Central)#

✅ KYC/AML
Identificação de investidores (off-chain no seu sistema)
Blocklist para endereços suspeitos
Relatórios COAF quando necessário
✅ CCB e Crédito
Rastreabilidade de cessões
Garantias registradas (hash on-chain)
Conformidade com Resolução 4.734

LGPD (Lei Geral de Proteção de Dados)#

✅ Dados Pessoais
CPF/CNPJ NÃO vão para blockchain (ficam no seu banco)
Blockchain armazena apenas: endereços (0x123...), valores, timestamps
Mapeamento wallet ↔ investidor no seu sistema
✅ Direito ao Esquecimento
Deletar dados pessoais do seu banco (off-chain)
Queimar tokens on-chain (irreversível)
Anonimização automática

📊 Gestão e Métricas#

KPIs para Acompanhar#

Operacionais:
Total de tokens criados
Volume de emissões (mint)
Volume de resgates (burn)
Transferências no secundário (últimas 24h/7d/30d)
Detentores únicos por token
Financeiras:
Valor total tokenizado (TVL)
Volume de negociação secundária
Média de deságio/ágio no secundário
Taxa de inadimplência (se aplicável)
Compliance:
Endereços bloqueados
Tokens pausados
Tempo médio de confirmação
Operações auditadas
Exemplo de Dashboard:
📊 Visão Geral - Debênture ABC 2025

Token: DEBABC25
Supply Total:         10.000.000 tokens (R$ 10 milhões)
Detentores:           1.247 investidores
Maior Detentor:       2.5% do supply

Emissão:              100% distribuída
Vencimento:           2030-12-31
Último Cupom:         2025-06-30 (R$ 125.000 pagos)

Negociação Secundária (30 dias):
Volume:               R$ 1.200.000
Transações:           87
Preço médio:          R$ 985 (deságio de 1.5%)

Compliance:
✅ 0 endereços bloqueados
✅ Token ativo (não pausado)
✅ 100% das transações confirmadas
⚡ Tempo médio: 6 segundos

🎯 Primeiros Passos#

1. Defina Seu Ativo#

Pergunte-se:
Que ativo vou tokenizar? (debênture, CRI, CCB, fundo, etc.)
Qual o valor total? (supply inicial)
Haverá emissões futuras? (supply máximo)
Quais metadados são essenciais? (CNPJ, vencimento, garantias, etc.)
Preciso de controles regulatórios? (pause, blocklist)

2. Estruturação do Token#

Fluxo recomendado:
1. Obter API Key
   → Contato: comercial@tokenone.com.br

2. Definir parâmetros do token
   → Nome: "Debênture Empresa XYZ 2025"
   → Símbolo: "DEBXYZ25"
   → Decimais: 2 (centavos)
   → Supply inicial: 10.000.000 (R$ 10 milhões)
   → Metadados: { cnpj, taxa, vencimento, garantias }

3. Criar token (ambiente de testes primeiro)
   → POST /v1/tokens (network: polygon-amoy)

4. Testar operações
   → Mint (emissão)
   → Transfer (negociação)
   → Burn (resgate)
   → Pause/Blocklist (compliance)

5. Integração com seu sistema
   → Mapeamento usuário ↔ wallet
   → Cálculo de cotas/valores
   → Webhooks para notificações

6. Homologação
   → Testes de carga
   → Validação regulatória
   → Auditoria de smart contracts

7. Go-live (produção)
   → Migrar para polygon-mainnet
   → Monitoramento 24/7

Versão do Documento: 1.1
Última Atualização: 23 de Dezembro de 2025
© 2025 TokenOne. Todos os direitos reservados.
Página anterior
Wallets ERC-4337
Built with