O relatório oficial de tokenização de 2025 já está disponível
Acesse agora
May 8, 2025

Brickken API v1.0.1 – Análise detalhada da atualização principal

Na Brickken, estamos comprometidos em ajudar empresas a tokenizar ativos do mundo real (RWAs) por meio de uma infraestrutura integrada e amigável ao desenvolvedor. Com o lançamento da versão 1.0.1 da API, estamos introduzindo novos recursos que permitem gerenciar melhor os ciclos de vida da tokenização — incluindo criação de STO, integração de investidores e tratamento de documentos — ao mesmo tempo em que reforçamos a consistência e a clareza em toda a API.

‍

Vamos analisar as novidades, as melhorias e como essas mudanças podem turbinar sua experiência de tokenização.

‍

🚀 Novos endpoints

‍

✅ PATCH /patch-api-token-docs

Este endpoint fornece uma solução muito necessária para administradores de tokens atualizarem documentos importantes relacionados a tokens programaticamente. É perfeito para projetos que buscam carregar ou atualizar:

  • Logotipo do token: arquivo JPEG ou PNG carregado no S3.
  • Contrato de assinatura: PDF legal carregado no IPFS.
  • Documentação legal: materiais PDF complementares (termos, isenções de responsabilidade, etc.), também carregados no IPFS.

‍

Ao lidar com materiais de branding e conformidade, este endpoint fecha o ciclo das necessidades de documentação pós-tokenização.

🔐 Requer uma x-api-key válida.

📝 Tipo de formulário: multipart/form-data.

‍

📊 OBTER /get-api-stos

Recupere todas as Ofertas de Tokens de Segurança (STOs) associadas a um determinado token por meio de seu tokenSymbol. Este endpoint permite painéis de STO, análises de investimento e resumos de portfólio.

Retornos:

  • Limites de token
  • Limites de investimento
  • Status da STO (PRÓXIMO, ATIVO, CONCLUÍDO)
  • Moeda de pagamento aceita (por exemplo, USDC)
  • Datas de início e término

Ideal para acompanhamento de projetos em tempo real ou painéis de relações com investidores.

‍

🔍 GET /get-api-sto-by-id/{id}

Precisa de detalhes sobre uma oferta específica? Este endpoint permite que você consulte qualquer STO por UUID, retornando informações abrangentes, incluindo:

  • Nome da oferta
  • Preço do token
  • Limite máximo/limite rígido
  • Limites mínimo/máximo por investidor
  • Datas e métodos de pagamento

Perfeito para fluxos de integração, verificações de conformidade ou relatórios de progresso.

‍

🔄 Melhorias em endpoints existentes

‍

🔧 POST /prepare-api-transactions

Este endpoint gera transações não assinadas para ações relacionadas à tokenização. Na versão v1.0.1, expandimos seus recursos com:

‍

🆕 Novo método suportado: newSto

Uma importante adição de recurso, este método permite que os desenvolvedores preparem transações para lançar ofertas de tokens de segurança diretamente do backend.

‍

Parâmetros agora aceitos para newSto:

  • tokenizerEmail: Quem criou o token
  • tokenAmount: Quantos tokens são oferecidos
  • offeringName: Nome interno ou para investidores
  • startDate / endDate: Janela de investimento com limite de tempo
  • acceptedCoin: Moeda aceita para investimento (USDT, USDC, etc.)
  • minRaiseUSD / maxRaiseUSD: Limite flexível e limite rígido
  • minInvestment / maxInvestment: Limites por investidor
  • signerAddress: Carteira do proprietário do token

Esses campos permitem que um STO totalmente personalizável e independente de cadeia seja construído fora da cadeia e assinado com segurança antes do envio.

‍

📤 POST /send-api-transactions

Este ponto de extremidade é usado para enviar transações assinadas para o blockchain e o backend do Brickken. Na versão 1.0.1, nós o tornamos mais inteligente e robusto:

  • ✅ Suporte completo para o método newSto
  • ✅ Validação aprimorada ao trabalhar com tokens como BKN, USDT, USDC — agora exigindo um tokenizerAddress válido para aprovações
  • ✅ Envio sensível à ordem para fluxos compostos (por exemplo, lista de permissões antes da cunhagem)

💡 Dica: Se você estiver enviando um lote como [whitelistUser1, mintUser1], [whitelistUser2, mintUser2]... certifique-se de que sua matriz de transações esteja ordenada adequadamente.

‍

🧼 Outras melhorias e Refinamentos

Também fizemos alguns ajustes para tornar a API mais fácil de usar:

✍️ Documentação e clareza

  • Introduzimos seções específicas de métodos recolhíveis na interface do usuário do Swagger
  • Expandimos toda a documentação do método para esclarecer a intenção, o contexto e as pré-condições
  • Exemplos aprimorados em corpos de solicitação e respostas

🔐 Segurança e Consistência

  • Estruturas de esquema padronizadas em todos os corpos de solicitação
  • Validação ausente adicionada e verificações mais rigorosas nos fluxos de trabalho de aprovação

🧪 Melhor experiência do desenvolvedor

  • Todos os valores de exemplo agora correspondem a cenários de uso realistas
  • Descrições mais precisas para casos extremos e campos opcionais

‍

🔗 Onde acessar

A API do Brickken está disponível em dois ambientes:

‍

📨 Notas finais

Esta versão é um trampolim para recursos ainda mais avançados em torno da automação do ciclo de vida do token, fluxos de investidores e emissão de STO compatível. Somos extremamente gratos à comunidade de desenvolvedores pelo feedback que nos levou a este lançamento — e já estamos trabalhando no que vem a seguir.
‍

Tem dúvidas ou precisa de ajuda para integrar os novos recursos?

📩 Entre em contato conosco pelo e-mail [email protected]
‍

Mantenha-se tokenizado, Equipe Técnica da Brickken

‍