Protocolo
Referência de contratos e status
Definições detalhadas de status, regras de assinatura e recursos publicados da API.
Comprar uma ação e manter um índice são produtos diferentes
O que você possui, quem mantém a custódia e como sair são diferentes. A interface mantém essas distinções claras.
| Diferença | Comprar diretamentetoken na sua carteira | Manter um índicecotas do vault |
|---|---|---|
| O que você possui | O próprio token bStock, em seu endereço de contrato. | Cotas ERC-20 de um vault que mantém a cesta. |
| Custódia | Sua carteira. Após a troca, não tocamos no token. | Um contrato sem custódia da plataforma. Nenhuma carteira da plataforma mantém ativos dos usuários. |
| Como sair | Venda pela mesma rota, sempre que houver uma disponível. | Resgate proporcional em tokens: você recebe os ativos subjacentes, não dinheiro. |
| Restrições do emissor | Aplicam-se diretamente a você. Um congelamento impede sua transferência. | Aplicam-se a cada etapa. Uma etapa restrita reverte todo o resgate. |
| Preço usado na operação | Uma cotação executável com prazo e saída mínima. | Uma prévia em bloco fixo. Ela não garante a execução. |
| Rebalanceamento | É sua decisão. Não mantemos posição nem enviamos instruções. | Somente por uma composição revisada, sob governança e dentro de limites fixos. |
| Escolha quando | Você quer um único título e o token em mãos. | Você quer um tema em uma única posição, com pesos verificados pelo contrato. |
O que é igual nos dois casos
O ativo é identificado pela rede e pelo endereço, nunca pelo símbolo. A mesma cadeia de evidências o admitiu. O emissor pode congelar ou restringir qualquer opção, e nenhuma garante saída.
O que está disponível hoje
A execução depende da opção: cotas de índice exigem a disponibilidade atual de um vault cadastrado para a rede; compras diretas exigem uma rota executável e profundidade medida. Endereços configurados, evidências de teste e permissão para produção são coisas distintas.
Status da verificação
Origem da fonte e do código. Não informa se um ativo pode ser utilizado.
| Status técnico na testnet · DISCOVERED | Importado como candidato de uma fonte arquivada. Nada foi confirmado ainda. |
| Status técnico na testnet · SOURCE_REVIEW | O documento do emissor está em revisão. |
| Status técnico na testnet · ONCHAIN_VERIFIED | As evidências de recursos onchain foram registradas em um bloco fixo. |
| Status técnico na testnet · VERIFIED | A origem e as evidências onchain foram revisadas e aprovadas de forma independente. |
| Status técnico na testnet · REVOKED | Uma aprovação anterior foi retirada. Trate este ativo como não verificado. |
Permissão para operações
Se um ativo pode ser utilizado e em qual direção. É decidida independentemente da verificação.
| Somente exibição | Apenas exibição. Sem nova exposição e sem uso em fundos. |
| Ativo | A operação é permitida pelas regras atuais do cadastro. |
| Somente saída | Sem nova exposição. A exposição existente pode ser encerrada. |
| Pausado | As saídas afetadas também são proibidas. As operações devem falhar. |
| Revogado | Estado terminal. Sem nova exposição; saída apenas se o próprio token ainda permitir transferência. |
Por que são estados separados
Um ativo pode ter origem totalmente verificada e continuar apenas para exibição. Um ativo antes ativo pode ser pausado sem mudanças nas evidências. Unir os dois estados em um único selo esconderia a diferença entre “conferimos o documento do emissor” e “você pode usar isto em um fundo”.
Status dos recursos
A API responde 503 CAPABILITY_UNAVAILABLE para um recurso não implementado. A interface o exibe como indisponível e nunca substitui isso por lista vazia, saldo zero ou transação bem-sucedida.
| Recurso | Estado |
|---|---|
| Diretório do cadastro de ativos | Implementado |
| Evidências de origem da verificação | Implementado |
| Fontes oficiais arquivadas | Implementado |
| Recursos do token em bloco fixo | Implementado |
| Publicação de preço de referência | ImplementadoExige fonte de preços licenciada; 503 até lá |
| Consulta pública de endereço | Implementado |
| Acesso com carteira | Implementado |
| Sessão e funções | Implementado |
| Desafio de gravação de negócio | Implementado |
| Descoberta de estratégias publicadas | Implementado |
| Rascunhos de estratégias | Implementado |
| Publicação de estratégias | Implementado |
| Link de compartilhamento somente leitura | Implementado |
| Verificação determinística de fatos | ImplementadoExige fonte de preços licenciada; 503 até lá |
| Backtest histórico | ImplementadoExige fonte de preços licenciada; 503 até lá |
| Lista pessoal de acompanhamento | Implementado |
| Recursos de execução, rede e implantação | Implementado |
| Prévia canônica de operações em tokens na testnet | ImplementadoExige endereço de contrato implantado |
| Diretório de fundos cadastrados | Implementado |
| Posições do fundo em bloco fixo | ImplementadoExige snapshot canônico em bloco fixo; 503 até lá |
| NAV de referência | ImplementadoExige fonte de preços licenciada; 503 até lá |
| Histórico esparso do NAV | ImplementadoExige fonte de preços licenciada; 503 até lá |
| Atividade do fundo | ImplementadoExige snapshot canônico em bloco fixo; 503 até lá |
| Posições da carteira | ImplementadoExige snapshot canônico em bloco fixo; 503 até lá |
| Atividade da carteira | ImplementadoExige snapshot canônico em bloco fixo; 503 até lá |
| Intenções de transação | Implementado |
| Fila de revisão de ativos | Implementado |
| Revisão da origem do ativo | Implementado |
| Ativação de ativo | Implementado |
| Solicitações restritas de fundos | Implementado |
| Registro de governança do fundo | Implementado |
| Cotação de cesta legada | Fora do contratoNão declarado no contrato; responde 503 |
| Cotação de compra de cesta | ImplementadoExige provedor de rotas aprovado; 503 por padrão, e um sucesso é apenas simulação |
| Cotação de venda de cesta | ImplementadoExige provedor de rotas aprovado; 503 por padrão, e um sucesso é apenas simulação |
| Cotação de depósito no vault | ImplementadoExige provedor de rotas aprovado; 503 por padrão, e um sucesso é apenas simulação |
| Cotação de resgate do vault | ImplementadoExige provedor de rotas aprovado; 503 por padrão, e um sucesso é apenas simulação |
Como uma gravação de negócio é autorizada
Uma sessão de acesso comprova quem você é; não autoriza uma alteração. Cada gravação serializa o corpo uma única vez, calcula o SHA-256 desses bytes exatos e solicita ao servidor um desafio único vinculado ao método, caminho e hash. A carteira assina a mensagem exata do servidor, e os mesmos bytes são enviados com nonce e assinatura. Alterar um byte, o caminho ou o método invalida a assinatura.
Um nonce já concluído com sucesso não pode ser reutilizado, e a interface nunca cria o mesmo registro novamente em silêncio. Se uma resposta se perder, o resultado é consultado pelo nonce antes de qualquer nova tentativa.
O que significa entrar com a carteira
Entrar comprova o controle de um endereço por uma mensagem gerada pelo servidor. Autoriza chamadas de API por oito horas. Nunca autoriza transferência, permissão de tokens ou operação de fundo, e não concede função de revisor ou governador.
Como os valores são tratados
Quantidades brutas de tokens são inteiros, representados como BigInt ou strings decimais exatas. A interface não faz aritmética de ponto flutuante com valores nem aplica multiplicador antes de o contrato publicar sua escala.
Riscos e limites
- A produção na mainnet continua desativada. Implantações na testnet e ativos sintéticos de teste não atendem aos critérios de lançamento em produção.
- Nenhuma fonte de preços, NAV de referência ou cotação executável é publicada. Uma prévia nunca é promessa de cotação.
- Registros importados dos dados iniciais são candidatos. Um candidato não é verificado nem negociável.
- Emissores de ações tokenizadas podem restringir transferências. Nenhuma interface aqui pode garantir a saída de um token restrito.