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:

• 🧪 Sandbox:
  https://api.sandbox.brickken.com
  Melhor para testes e simulações.
  
  
• 🚀 Produção:
  https://api.brickken.com
  Implantação ao vivo para tokenizações em produção.

‍

📨 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

‍