Apresentando a Brickken API V2: mais rápida, simples e pronta para o futuro

Na Brickken, estamos comprometidos em capacitar empresas e desenvolvedores a integrar perfeitamente a tokenização em suas plataformas. Hoje, temos o prazer de anunciar o lançamento da Brickken API V2, um grande passo à frente que torna as integrações mais simples, consistentes e poderosas.

Esta atualização simplifica a maneira como você trabalha com nossa API, prepara o terreno para os próximos recursos e garante que seus projetos possam ser escalonados com facilidade.

Bem-vindo à API V2 – A Próxima Geração

Agenda de hoje:

• Visão geral das melhorias da V2
• Mudanças significativas que você precisa saber
• Novos recursos poderosos
• Guia de migração passo a passo

Por que migrar?

• Integração simplificada
• Novos recursos de STO
• Aprimorado Desempenho

Novidades na API V2

Recurso

V1

V2

Benefício

Nomes de endpoint

/prepare-api-transactions

/prepare-transactions

URLs mais limpos e curtos

Fluxo de transações

Parâmetros complexos

Sistema txId simples

Complexidade reduzida

Suporte STO

Não disponível

Fluxo de trabalho completo

Plataforma de investimento completa

Operações em nome

Não disponível

Em andamento (3 endpoints)

Gerenciar operações do usuário

1. Transações de Envio Unificadas

Simplificamos o tratamento de transações com um único ponto de extremidade unificado:

POST /send-transactions

‍

Isso funciona em todos os métodos preparados: newTokenization, mintToken, whitelist, burnToken, transferFrom, transferTo, approve, dividendDistribution e os novos métodos STO.

Corpo da solicitação (agora unificado):

{

  "signedTransactions": ["0x..."],

  "txId": "<txId de prepare-transactions>"

}

‍

2. Preparar resposta agora inclui txId

Ao preparar transações, você receberá ambos:

{

  "txId": "tx_abc123def456",

  "transactions": [{

    "value": "0",

    "gasLimit": "500000",

    "maxFeePerGas": "20000000000"

  }]

}

‍

Principais benefícios:

• TxId adicionado para rastreamento
• Estrutura mais limpa e simples
• Chega de objetos BigNumber

3. Limpeza de nomenclatura de endpoint

Simplificamos a nomenclatura de endpoint removendo o sufixo -api:

• POST /prepare-api-transactions → POST /prepare-transactions
• POST /send-api-transaction → POST /send-transactions
• GET /get-api-transaction-status → GET /get-transaction-status

4. Renomeação de campo: symbol → tokenSymbol

Em todos os corpos de preparação (incluindo newTokenization e outros), agora use tokenSymbol em vez de symbol.

Exemplo:

{ "tokenSymbol": "EXMPL" }

‍

5. Simplificação de Envio de Transações

V1 (Complexo – Muitos Parâmetros):

{

"signedTransactions": ["0x123..."],

"chainId": "aa36a7",

"method": "newTokenization",

"tokenSymbol": "ABC",

"tokenizerEmail": "[email protected]"

// ... muitos outros parâmetros

}

‍

V2 (Simples – Apenas 2 Parâmetros!):

{

  "signedTransactions": ["0x123..."],

  "txId": "tx_abc123def456"

}

‍

6. Novos recursos

🔹 Fluxo de trabalho completo de STO

A API V2 apresenta suporte completo para ofertas de tokens de segurança (STOs).

Criar STO:

{

"método": "novaSto",

"símbolo de token": "EXMPL",

"preço": "100",

"investimento mínimo": "10",

"investimento máximo": "10000",

"startDate": "2024-01-01T00:00:00Z",

"endDate": "2024-12-31T23:59:59Z",

"softCap": "50000",

"hardCap": "500000"

}

‍

Invista em STO:

{

"method": "newInvest",

"tokenSymbol": "EXMPL",

"e-mail do investidor": "[email protected]",

"valor": "1000"

}

‍

Reivindicar Tokens:

{

"método": "reivindicarTokens",

"símbolo do token": "EXMPL",

"e-mail do investidor": "[email protected]"

}

‍

🔹 Endpoints em nome (em desenvolvimento)

Estamos introduzindo operações em nome para permitir que você atue diretamente para seus usuários:

• POST /create-token-on-behalf
• POST /invest-on-behalf
• POST /sto-claim-on-behalf

Os casos de uso incluem:

• Investimentos gerenciados pela plataforma
• Distribuição automatizada de tokens
• Experiência simplificada do usuário

⚠️ Esses endpoints ainda estão em desenvolvimento; A disponibilidade e os parâmetros podem evoluir.

🔹 Acesso aprimorado a dados

Novos pontos de extremidade GET para melhor visibilidade:

Ponto de extremidade

Finalidade

Exemplo de resposta

/get-allowance

Verificar permissões de token

{ "allowance": "1000000" }

/get-balancewhitelist

Status do saldo + lista de permissões

{ "balance": "500", "isWhitelisted": true }

/get-network-info

Informações da rede

{ "chainId": "0x89", "name": "Polygon" }

/get-token-info

Detalhes do token

{ "name": "Token", "totalSupply": "1000000" }

/get-tokenizer-info

Dados do tokenizer

{ "email": "...", "tokens": [...] }

Etapas da migração – Seu plano de 5 etapas

1. Atualizar URLs (remover API)
   
   

// Antigo

const url = '<https://api.sandbox.brickken.com/prepare-api-transactions>';

// Novo

const url = '<https://api-sandbox.brickken.com/prepare-transactions>';

‍

2. 
   Renomear símbolo → tokenSymbol em corpos de preparação
   
   
3. Persistir txId de respostas de preparação
   
   
4. Usar corpo de envio unificado
   
   

aguardar api.send({ signedTransactions: signed, txId });

‍

5. 
   Garanta que os valores de chainId sejam hexadecimais com o prefixo 0x
   
   
   
   • Antigo: "aa36a7"
   • Novo: "0xaa36a7"

✅ Sempre teste primeiro no Sandbox: https://dapp.sandbox.brickken.com/en/

Resumo dos benefícios

• 90% menos parâmetros em solicitações de envio
• Fluxo unificado em todos os métodos
• Nomes de endpoint mais limpos (tokenSymbol, URLs mais curtos)
• Funcionalidade STO completa
• Operações em nome da plataforma gerenciamento
• Novos endpoints GET avançados para melhores insights
• Arquitetura pronta para o futuro

Cronograma de migração

Recomendamos a migração nas próximas 1–2 semanas.

A V1 permanecerá disponível durante este período para oferecer suporte a uma transição tranquila, após a qual a V2 se tornará o padrão.

Recursos e Suporte

• 📖 Documentação da API V2
• ✉️ E-mail: [email protected]

Estamos aqui para ajudar você em cada etapa do processo, desde os testes em sandbox até a migração para produção.

A API V2 do Brickken foi criada para tornar as integrações de tokenização mais fáceis, rápidas e prontas para o futuro. Mal podemos esperar para ver o que você criará com ela. 🚀

‍