Protocolo
Referência de contratos e estado
Definições detalhadas de estado, regras de assinatura e recursos publicados da API.
Comprar uma ação e manter um índice são produtos diferentes
O que 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 índiceunidades de participação do vault |
|---|---|---|
| O que possui | O próprio token bStock, no seu endereço de contrato. | Unidades de participação ERC-20 de um vault que mantém o cabaz. |
| Custódia | A 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 utilizadores. |
| Como sair | Venda pela mesma rota, sempre que houver uma disponível. | Resgate proporcional em tokens: recebe os ativos subjacentes, não dinheiro. |
| Restrições do emissor | Aplicam-se diretamente a si. Um congelamento impede a 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é-visualização em bloco fixo. Ela não garante a execução. |
| Reequilíbrio | A decisão é sua. Não mantemos posição nem enviamos instruções. | Apenas por uma composição revista, sob governação e dentro de limites fixos. |
| Escolha quando | Pretende um único título e o token em mãos. | Pretende um tema numa ú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: unidades de participação de índice exigem a disponibilidade atual de um vault registado 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.
Estado da verificação
Origem da fonte e do código. Não informa se um ativo pode ser utilizado.
| Estado técnico na testnet · DISCOVERED | Importado como candidato de uma fonte arquivada. Nada foi confirmado ainda. |
| Estado técnico na testnet · SOURCE_REVIEW | O documento do emissor está em revisão. |
| Estado técnico na testnet · ONCHAIN_VERIFIED | As evidências de recursos onchain foram registadas num bloco fixo. |
| Estado técnico na testnet · VERIFIED | A origem e as evidências onchain foram revistas e aprovadas de forma independente. |
| Estado 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.
| Apenas apresentação | Apenas apresentação. Sem nova exposição e sem uso em fundos. |
| Ativo | A operação é permitida pelas regras atuais do registo. |
| Apenas 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 apresentação. Um ativo antes ativo pode ser pausado sem mudanças nas evidências. Unir os dois estados num único selo esconderia a diferença entre “conferimos o documento do emissor” e “pode usar isto num fundo”.
Estado dos recursos
A API responde 503 CAPABILITY_UNAVAILABLE para um recurso não implementado. A interface o apresenta como indisponível e nunca substitui isso por lista vazia, saldo zero ou transação bem-sucedida.
| Recurso | Estado |
|---|---|
| Diretório do registo de ativos | Implementado |
| Evidências de origem da verificação | Implementado |
| Fontes oficiais arquivadas | Implementado |
| Capacidades 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 |
| Início de sessão com carteira | Implementado |
| Sessão e funções | Implementado |
| Desafio de escrita de negócio | Implementado |
| Descoberta de estratégias publicadas | Implementado |
| Rascunhos de estratégias | Implementado |
| Publicação de estratégias | Implementado |
| Link de partilha apenas de leitura | Implementado |
| Verificação determinística de factos | 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é-visualização canónica de operações em tokens na testnet | ImplementadoExige endereço de contrato implantado |
| Diretório de fundos registados | 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 |
| Pedidos restritos de fundos | Implementado |
| Registo de governação do fundo | Implementado |
| Cotação de cabaz legado | Fora do contratoNão declarado no contrato; responde 503 |
| Cotação de compra de cabaz | ImplementadoExige fornecedor de rotas aprovado; 503 por predefinição, e um sucesso é apenas simulação |
| Cotação de venda de cabaz | ImplementadoExige fornecedor de rotas aprovado; 503 por predefinição, e um sucesso é apenas simulação |
| Cotação de depósito no vault | ImplementadoExige fornecedor de rotas aprovado; 503 por predefinição, e um sucesso é apenas simulação |
| Cotação de resgate do vault | ImplementadoExige fornecedor de rotas aprovado; 503 por predefinição, e um sucesso é apenas simulação |
Como uma escrita de negócio é autorizada
Uma sessão de acesso comprova a sua identidade; não autoriza uma alteração. Cada escrita serializa o corpo uma única vez, calcula o SHA-256 desses bytes exatos e pede 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 registo novamente em silêncio. Se uma resposta se perder, o resultado é consultado pelo nonce antes de qualquer nova tentativa.
O que significa iniciar sessão com a carteira
Iniciar sessão comprova o controlo de um endereço através de uma mensagem gerada pelo servidor. Autoriza chamadas de API durante oito horas. Nunca autoriza transferência, permissão de tokens ou operação de fundo, e não concede funções 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é-visualização nunca é promessa de cotação.
- Registos 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.