For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Pular para o conteúdo

Investindo

Bloom é um marketplace para ativos do mundo real permissionados. Cada ativo é um contrato Solidity comum implantado uma vez em uma cadeia Rome, e a regra sobre quem pode mantê-lo vive dentro desse contrato. Este guia acompanha um comprador desde a página inicial até a navegação de um ativo, a verificação de elegibilidade, a solicitação de entrada na allowlist, a compra e a posse — e depois cobre a única coisa que é genuinamente diferente para um titular que assina com uma carteira Solana.

A regra viaja com o ativo. Quem pode manter um ativo é imposto pelo próprio contrato do ativo, em toda transferência — não por este site. Nada em nenhuma tela aqui pode anulá-lo, e não existe caminho alternativo. Bloom é uma janela para a cadeia; a cadeia é o que decide.


O que "permissioned" significa para um comprador

Um ativo permissionado tem uma allowlist: um conjunto de endereços que o emissor decidiu que podem mantê-lo. A allowlist não é um recurso do Bloom — ela vive em um módulo acoplado ao contrato do ativo, e o ativo a consulta em toda mintagem, queima e transferência.

A cadeia guarda um fato sobre você: um único sim ou não em relação ao seu endereço. Nenhum documento, nenhuma informação pessoal e nenhuma alegação de identidade é jamais armazenada na cadeia ou neste app. Quando um emissor admite você, tudo o que chega à cadeia é isWhitelisted(seuEndereço) = true. O modelo completo de conformidade está em COMPLIANCE.md.

Duas consequências seguem, e ambas são visíveis no produto:

  • Antes de você poder comprar, o ativo é perguntado se seu endereço pode mantê-lo. Uma recusa é um fato sobre a regra do ativo, não um problema com sua carteira.

  • Uma transferência para um endereço que o emissor não aprovou reverte na cadeia. O ativo a recusa; nenhuma tela precisa fazê-lo.


Os dois mundos de carteira

Um único ativo Bloom pode ser acessado por ambos uma carteira EVM (como MetaMask) e uma carteira Solana (como Solflare). Você conecta uma carteira por vez. Uma carteira Solana precisa conseguir assinar transações Solana versão 1: a Solflare faz isso na devnet hoje, e a Phantom ainda não.

Carteira
Onde ele mantém o ativo
O que assina

Carteira EVM

Seu próprio endereço EVM, como em qualquer cadeia EVM

Uma transação EVM

carteira Solana

Um endereço EVM derivado da sua chave pública Solana

Sua assinatura Solana, solicitada duas vezes por etapa (veja Pagando, e os prompts extras de assinatura)

Para uma carteira EVM, não há nada novo a aprender. Para uma carteira Solana, o ativo fica em um derivado endereço — calculado como keccak256(solana_pubkey)[12..32] — e somente sua assinatura Solana pode movê-lo, e você não precisa de uma chave EVM separada. Isso é coberto em detalhes na seção do titular Solana abaixo e em LANES.md.


A página inicial

A página inicial da Bloom: o título, as duas linhas dos mundos das carteiras e as portas Investidor e Emissor.

A página inicial (/) diz o que é a Bloom — ativos Solidity, abertos tanto para Solana quanto para EVM — e oferece duas portas: Investidor (que leva você aos ativos abertos em /invest) e Emissor. Como comprador, escolha Investidor.

Duas linhas, carteiras Solana e carteiras EVM, listam as carteiras que seu navegador realmente anunciou por meio dos protocolos de descoberta EIP-6963 e Wallet Standard. Nada é exibido que você não tenha instalado; o nome e o ícone de cada carteira são próprios.

No rodapé, uma Contratos seção lista os endereços com os quais esta implantação conversa — a fábrica de tokens, a implementação compartilhada, o roteador de permissões, a vitrine de venda primária e o token de caixa — cada um linkando para o explorador de blocos, para que o app nunca afirme um endereço com a própria voz.

"Como isso é possível com Solana?"

A explicação de custódia: uma assinatura entra à esquerda e o ativo a admite à direita.

A página inicial traz uma explicação que responde como uma carteira Solana pode manter um ativo Solidity. Ela faz três pontos:

  • Uma implantação. O ativo é um contrato Solidity comum, implantado uma vez. Não existe nenhuma cópia dele em ponte em lugar nenhum — uma segunda cópia é exatamente o que permitiria que ele escapasse das regras.

  • Dois mundos de carteira. Uma carteira EVM acessa o contrato da mesma forma que acessa qualquer cadeia. Uma carteira Solana acessa o mesma contrato porque uma cadeia Rome roda dentro da Solana: o ativo é mantido em um endereço EVM derivado da sua chave Solana, e sua assinatura é a única coisa que pode movê-lo.

  • O ativo guarda a regra. Quem pode mantê-lo é imposto pelo contrato em toda transferência — não por este site e não por uma ponte. Um endereço que o emissor não aprovou simplesmente não pode recebê-lo.


A lista de ativos abertos em /invest, com preço e inventário lidos ao vivo da cadeia.

/invest lista todos os ativos com venda aberta no momento. Para cada linha, você vê:

Coluna
Significado

Ativo

O nome e o símbolo do ativo, lidos diretamente do token

Preço

O preço de uma unidade, em wUSDC

Vendido

Unidades vendidas de unidades oferecidas, com uma barra de progresso

O resumo acima da tabela conta Abertos agora (quantas vendas estão ao vivo), Emitidos aqui (quantos ativos esta cadeia emitiu) e Pago em (wUSDC, o token de caixa para cada venda nesta implantação).

Nada nesta página é fixo. Preço, inventário e status são lidos ao vivo da cadeia em toda visita. Se a cadeia não responder, a página diz isso — "A cadeia não respondeu…" — em vez de mostrar um número desatualizado ou alegar vazio. "Nada está à venda no momento" é uma afirmação sobre a cadeia, e só aparece quando a cadeia realmente retorna uma lista vazia.

Você pode ler preços e inventário sem conectar. Para comprar, você precisará de uma carteira: a página mostra um Conectar carteira prompt, oferecendo suas carteiras EVM e Solana sob dois títulos. Selecionar uma linha abre a página de detalhes desse ativo.


Um ativo

Uma página de detalhes do ativo: os fatos à esquerda, o cartão de elegibilidade e o painel de compra à direita.

Uma página de ativo (/invest/[address]) tem duas metades: os fatos e regras do ativo à esquerda, e sua elegibilidade e o painel de compra à direita.

Os fatos

Fato
Significado

Preço

Preço de uma unidade, em wUSDC

Disponível

Unidades ainda disponíveis na venda aberta

Rendimento pago em

A moeda em que qualquer rendimento é distribuído (wUSDC)

Quem pode mantê-lo

A página declara três regras que o ativo impõe:

Regra
O que diz

Titulares permitidos

Endereços aprovados pelo emissor. Verificados pelo ativo em toda transferência.

Mínimo

1 unidade. Sem bloqueio.

Transferências

Somente para outro endereço permitido, a partir de qualquer dos mundos de carteira.

O ativo verifica isso por conta própria em toda transferência. Nada nesta página pode anulá-lo. As regras são declaradas como fatos sobre o token, não como política deste app, porque é isso que elas são.


Elegibilidade — verificada no token, antes de qualquer compra

O cartão de elegibilidade se resolvendo na página do ativo: conectar, depois verificando, depois permitido ou não permitido.

Antes de oferecer uma compra a você, a página do ativo pergunta ao próprio módulo de allowlist do ativo se seu endereço pode mantê-lo. O cartão de elegibilidade mostra um destes estados:

Estado
Significado

Conecte para verificar

Nenhuma carteira está conectada ainda. Conecte uma para executar a verificação.

Verificando…

Conectada; a verificação on-chain ainda não foi resolvida.

Permitido

Seu endereço pode manter este ativo.

Não permitido

A regra do ativo recusa seu endereço. Um link oferece a solicitação de entrada na allowlist.

Indisponível

A verificação não pôde ser lida agora (não é uma recusa).

A verificação é de dois lados. Uma compra move unidades da vitrine para você, então ambas as partes dessa transferência precisam estar na allowlist. Bloom faz a pergunta dessa forma — uma verificação unilateral diria que você é elegível e então veria a compra reverter porque a vitrine não está listada nesse token.

Assim que seu endereço estiver na allowlist, o mesmo cartão lê Permitido, e a compra fica disponível para você:

O cartão de elegibilidade mostrando Permitido — o comprador está na allowlist, e o painel de compra está ativo.

Quando você é recusado, o motivo mostrado é o próprio, citado literalmente. Bloom nunca escreve uma frase sobre por que você foi recusado. Se o ativo ainda não tem um módulo de allowlist vinculado (um rascunho), ele está sem restrição — nada está restringindo ninguém, e você está permitido.

Se você for recusado, o cartão linka para Solicitar entrada na allowlist.


Solicitando entrada na allowlist

O formulário de solicitação: um endereço, uma jurisdição, um tipo de titular e duas declarações — sem documentos.

/apply é onde você pede a um emissor que admita seu endereço. O texto de abertura conta a história toda: Sem documentos. Apenas declarações.

O formulário não guarda nada que valha a pena vazar e não escreve nada em nenhuma cadeia. Uma solicitação é um registro fora da cadeia sobre o qual o emissor decide. O emissor faz suas próprias verificações em seu próprio sistema; a escrita na allowlist acontece do lado dele, e tudo o que chega à cadeia é apenas o resultado sim ou não em relação ao seu endereço.

Você fornece quatro coisas e nenhuma quinta:

Campo
Observações

O endereço que o manterá

Preenchido previamente da sua carteira conectada. Para uma carteira Solana, este é o seu derivado endereço — o endereço onde o ativo fica, não a chave que assina por ele.

Jurisdição

Uma de uma lista fixa (Singapura, Emirados Árabes Unidos, Suíça, Reino Unido).

Você é

Pessoa física, pessoa física credenciada ou instituição.

Duas declarações

Ambas devem ser aceitas: que você age por conta própria e controla o endereço, e que você aceita que o emissor decide quem pode manter o ativo e pode revogá-lo.

O ? ao lado do texto de abertura explica por que nenhum documento é solicitado: o emissor precisa apenas do que vai usar, nada do que você pudesse enviar poderia ser armazenado aqui, e na cadeia o registro é um único sim ou não.

Para solicitar:

  1. Confirme o endereço, escolha sua jurisdição e tipo de titular e aceite ambas as declarações.

  2. Pressione Enviar solicitação. O formulário valida localmente e o sistema revalida tudo no servidor, já que um formulário está a uma requisição de ser contornado.

  3. Você recebe um link privado no formato …/apply/status?ref=AP-XXXX-XXXX-XXXX.

Salve o link — é a única forma de voltar à sua solicitação. A referência é gerada a partir de 60 bits de aleatoriedade criptográfica e seja da autorização: nada mais fica na frente das suas declarações, e não há conta nem senha para recuperá-las.

Na demonstração, uma Ligação de teste observação aponta você para /approve, onde você pode aprovar sua própria solicitação para completar o ciclo. Um emissor real faz essa etapa em seu próprio sistema — veja abaixo.


O status da sua solicitação e a exclusão das declarações

A página de status — a referência, os fatos declarados, a linha do tempo e o controle de exclusão.

/apply/status lê uma solicitação de volta a partir da sua referência (a partir do ?ref= link, ou do último que este navegador lembra). Não há sessão; a referência é a chave.

A página mostra onde você está — Com o emissor, Você pode manter este ativo, ou Recusado — junto com uma tabela de detalhes (referência, data da solicitação, o endereço, o ativo, a jurisdição e uma Verificações linha) e uma linha do tempo curta do que aconteceu. Se você foi aprovado, um Comprar o ativo link aparece. Uma recusa mostra o próprio motivo do emissor, citado.

O Verificações linha reflete o próprio registro KYC do emissor. Nesta demonstração, não há provedor integrado, então ela lê "Apenas declarações — nenhum documento foi solicitado" em vez de insinuar uma verificação que não aconteceu.

Apagando o que você declarou

Você pode apagar suas declarações a qualquer momento, nesta página.

Apagar destrói as declarações e mantém a decisão. O que você disse sobre si mesmo é excluído e não pode ser recuperado. A decisão do emissor permanece, porque já foi aplicada publicamente, em uma cadeia — e desdizer isso é uma assinatura que o emissor precisa fazer, não um delete que você possa fazer. (O próprio registro KYC de um emissor, se houver, também sobrevive, porque é a evidência do emissor para admitir um endereço que agora está em uma cadeia pública; apagar isso aqui também não apagaria nada no provedor deles.)


/approve — o substituto da ligação de teste

A página de aprovação — o banner "ligação de teste, não o emissor", o endereço, a ação de aprovar e seus requisitos on-chain no bloco abaixo dela.

/approve existe para que toda a jornada possa ser percorrida do início ao fim na demonstração. Ela traz um banner dizendo "Ligação de teste — não o emissor", e esse banner é a razão de ser honesta tê-la: em produção, o emissor aprova solicitações dentro do próprio fluxo de trabalho, não aqui.

O que há de real nisso: a aprovação é uma escrita real na allowlist on-chain. A página chama um TestApprover contrato implantado que está habilitado no ativo de demonstração (Mineral Vault I, ARCV, em 0x2b13ba16a429bf630f94882e477fe775d34b7c74). Esse contrato precisa de nenhum papel do seu chamador — qualquer pessoa pode aprovar qualquer endereço por meio dele — que é justamente o motivo de ele existir: ele permite fechar o ciclo da demonstração para qualquer carteira, por qualquer dos lados.

Para aprovar seu próprio endereço:

  1. Conecte a carteira com a qual você solicitou (EVM ou Solana). Seu endereço já vem preenchido.

  2. Pressione Aprovar este endereço. As pré-condições e consequências da escrita se desdobram abaixo do botão — abra "O que isso faz" para ver exatamente o que acontecerá antes de você assinar.

  3. Em caso de sucesso, a página lê "Aprovado. O solicitante agora pode manter o ativo."

Se você entrou com uma carteira Solana, uma nota diz "Isso aprovará o endereço derivado da sua chave Solana" — o endereço que a execução assina por é o derivado; a chave que ele assina com é a sua chave Solana.

Em produção, essa é a decisão do emissor, feita no sistema do emissor. A da demonstração TestApprover está aberta por construção para que o fluxo possa ser percorrido; uma escrita real na allowlist é restringida por uma função que o emissor possui. Nada no modelo de conformidade muda — continua sendo decisão do emissor, continua sendo um booleano na cadeia e continua sem documentos em lugar nenhum.

Uma vez aprovado, volte à página do ativo; sua elegibilidade agora lê Permitido.


Comprando

O painel de compra fica abaixo do cartão de elegibilidade na página do ativo.

Precisa de wUSDC primeiro? Toda venda é precificada em wUSDC, e uma carteira nova não tem nenhum. Levar fundos para Rome guia a entrada de caixa: faça a ponte de USDC ou ETH a partir de Sepolia e depois embrulhe o gas bridged em wUSDC — tudo na /bridge tela.

O painel de compra depois que uma compra é concluída — "Comprado. Ele aparecerá em Posições."
  1. Digite o número de Unidades que você quer. O painel mostra o preço unitário e o total que você pagará, em wUSDC. (O caixa que a compra realmente retira é calculado a partir do preço em unidades base, então o valor aprovado sempre corresponde ao valor cotado.)

  2. Pressione o controle de compra. Uma compra é uma sequência curta, não um único clique: se a venda ainda não tiver permissão para retirar seu wUSDC, uma aprovação etapa aparece primeiro ("Permitir que a venda retire seu caixa"), depois a Compra em si.

  3. Cada etapa começa com seu botão e expande suas pré-condições e consequências abaixo dele — um clique de distância antes de você assinar — e nomeia sua fase enquanto roda — "Aguardando sua carteira…", depois "Entrando na cadeia…". A sequência reavalia as condições entre as etapas, então uma venda que fecha depois da sua aprovação interrompe a compra em vez de revertê-la.

  4. Em caso de sucesso, o painel lê "Comprado. Ele aparecerá em Posições."

De um carteira Solana a sequência pode ser mais longa na primeira vez. Se seu endereço do lado Rome tiver menos wUSDC do que a compra precisa, uma etapa para mover caixa da sua carteira vem primeiro, e se a concessão de transferência de wUSDC ainda não estiver em vigor, uma Permitir transferências de wUSDC etapa vem antes da aprovação. Depois que você pressiona Comprar, a carteira Solana executa a entrada de caixa, a concessão, a aprovação e a compra de uma vez, e o botão observa "dois prompts de carteira" enquanto cada etapa assina. Os nomes das etapas e a contagem de prompts na parte superior são mostrados em Trade and Credit, não aqui. Uma carteira EVM também recebe a etapa única de Permitir transferências de wUSDC etapa neste painel. As etapas e as contagens de prompts estão em Pagando, e os prompts extras de assinatura.

Se sua carteira estiver na rede errada, o painel diz isso e oferece mudar para a cadeia do ativo em vez de deixar um botão não fazer nada.

A compra passa pela mesma barreira de allowlist que qualquer transferência. A vitrine move unidades para você somente se tanto ela quanto seu endereço estiverem permitidos. Não existe uma verificação do lado do Bloom que pudesse substituir a do próprio ativo.


Suas posições

/portfolio mostra o que você possui. Conecte a carteira que mantém o ativo e você obtém:

A página de posições — a posse, seu valor e o resumo.
  • um resumo — Valor total (em wUSDC), Ativos (quantos ativos distintos você possui), e Rendimento recebido;

  • uma Posições tabela listando cada ativo, suas unidades e seu valor.

Tudo é lido ao vivo da cadeia. Quando você ainda não possui nada, a página diz isso e liga você às vendas abertas. Rendimento recebido mostra atualmente um traço: ler seu histórico de pagamentos significa percorrer os eventos de distribuição de volta até o primeiro bloco do ativo, o que ainda é trabalho por vir — um traço é honesto onde uma 0.00 seria uma afirmação.

Posições são uma visão, não um mercado. Bloom apresenta a compra de um ativo em sua venda primária e sua manutenção. O próprio ativo permite transferências para outros endereços permitidos a partir de qualquer dos mundos de carteira (essa é uma de suas regras declaradas), mas o Bloom atualmente não expõe uma transferência secundária nem um controle de venda.


Para um titular Solana

Tudo acima se aplica a você sem mudanças. Esta seção cobre a única surpresa que é genuinamente sua: o ativo é mantido em um endereço que sua carteira Solana nunca listará, e por que isso é seguro.

A cadeia de custódia

As posições do titular Solana — "Mantido para sua chave Solana", o endereço derivado de custódia, a cadeia de custódia e a posse ARCV comprada pelo lado Solana.

Quando você conecta uma carteira Solana, /portfolio mostra uma Mantido em linha com o endereço EVM em que seu ativo fica, e uma Como isso é mantido? chave que abre um painel de custódia explicando a derivação em três etapas:

  1. Sua chave Solana — a chave já presente na sua carteira. Ela assina; nunca sai.

  2. Calcula para — o endereço que mantém o ativo — o endereço EVM derivado. Ele é aritmética, não uma conta: ele decorre da sua chave, e não existe chave privada para ele.

  3. O que pode movê-lo — somente uma assinatura da sua chave pode mover o que está nesse endereço.

Por que isso é seguro. O ativo é residente no estado EVM: seu saldo é armazenamento dentro das contas do programa Rome. Não há nenhuma mintagem SPL dele, sem conta de token, e nada nativo da Solana para mover — então a infraestrutura do lado da Solana não tem nenhuma instrução que pudesse movê-lo para fora. Somente sua assinatura Solana pode acionar o endereço derivado, e todo movimento que ela pode expressar é uma chamada ao contrato do ativo, que executa o filtro da allowlist. Uma transferência para um endereço não permitido reverte da mesma forma, seja assinada por uma chave EVM ou por uma chave Solana. Esta é exatamente a propriedade que um ativo com permissão quer — veja LANES.md.

Como não há nenhum token SPL para listar, sua carteira Solana não exibirá a participação em RWA — a Bloom app é sua interface de posições. Uma chave Solana perdida é recuperada pelo processo do emissor, não movendo o ativo por fora.

Pagando, e os prompts extras de assinatura

  • Você paga a taxa da Solana em SOL a partir da sua própria carteira. O endereço EVM derivado nunca precisa de SOL. Seu gas só é usado no único caso descrito abaixo, uma chamada grande demais para uma única transação.

  • Toda chamada é uma transação Solana da versão 1, e toda chamada exige dois prompts. Uma aprovação, uma compra ou uma transferência é preparada para a sua carteira pelo proxy da cadeia. Sua carteira primeiro assina uma mensagem legível que começa Rome authorization, o que prova que sua chave Solana autoriza esta chamada exata. Depois, ela assina a própria transação. Aprovar e depois comprar, portanto, são quatro prompts.

  • Uma carteira que não consegue assinar transações da versão 1 para por aí. A Bloom falha de forma segura em vez de enviar um formato mais antigo. Use o Solflare na devnet por enquanto; a Phantom ainda não assina transações da versão 1.

  • Mover fundos para dentro é um prompt, só quando necessário. Uma compra gasta wUSDC do seu endereço derivado, que não mantém nada em repouso. Se ele tiver menos do que a compra custa, a Bloom primeiro transfere a diferença da própria conta de token USDC da sua carteira. No Trade e no Credit, essa etapa é chamada Transferindo seus fundos; na compra de Invest, ela é executada como parte da compra depois que você pressiona Comprar.

  • A concessão única é uma etapa à parte, uma vez por carteira. Na primeira vez que seu endereço derivado gastar wUSDC, a Bloom coloca Permitir transferências de wUSDC antes da aprovação. É uma chamada como qualquer outra (dois prompts), e não é solicitada novamente depois que estiver em vigor. Por que ela existe está em Concessão única por carteira.

  • Uma chamada grande demais para uma única transação Solana é retransmitida, com menos prompts. A Bloom sempre tenta primeiro a transação direta, assinada pela carteira. Se a cadeia a recusar porque ela não cabe, a mesma assinatura de autorização é entregue ao proxy, que a submete por você: um prompt para essa chamada. Como o proxy a submete, a chamada é paga em gas Rome a partir do seu endereço derivado, então, se esse saldo estiver baixo, a Bloom primeiro o completa a partir da sua carteira, o que é mais um prompt, normalmente uma vez por carteira. Veja LANES.md.

Uma primeira compra a partir de uma carteira Solana nova é, portanto: mover fundos para dentro (1 prompt), permitir transferências de wUSDC (2), aprovar a venda (2), comprar (2).

Ações maiores são retransmitidas, não recusadas. Uma compra cabe em uma transação Solana, e uma "jornada de várias etapas" (aprovar e depois comprar) são várias transações completas, cada uma atômica por si só. Só uma chamada que o proxy relata como grande demais para uma transação, o que no Credit pode incluir as ações maiores do mercado, segue a rota de retransmissão descrita acima.


Onde realmente está a conformidade

Para resumir o que é aplicado em cada lugar, para que nada aqui seja confundido com uma política da Bloom:

Preocupação
Aplicado por
Não por

Quem pode manter o ativo

O módulo de allowlist do ativo, em toda transferência

Este site

Uma transferência para um endereço não aprovado

Revertida na cadeia pelo ativo

Qualquer filtro fora da cadeia

O que é armazenado sobre você

Um booleano (isWhitelisted) por endereço

Documentos ou PII, em qualquer lugar

Quem pode admitir você

A decisão fora da cadeia do emissor

Bloom

Para o modelo completo, leia COMPLIANCE.md; para a mecânica de duas vias, LANES.md.

Isto não é uma simulação. Um comprador real comprou este ativo de uma carteira EVM, e uma carteira Solana real o comprou na via Solana — o mesmo token, a mesma allowlist, o mesmo wUSDC. Cada transação está vinculada na Evidência página. O card Permitido, as posições e a cadeia de custódia Solana neste guia são desses compradores, após essas transações.

Atualizado

Isto foi útil?