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

Modelo de conformidade

A Bloom executa o framework Arc da Plume sem modificações. A conformidade é imposta pelo próprio contrato do token — não por nenhuma triagem fora da cadeia, filtro de sequenciador ou política da plataforma. Essa é a propriedade que o torna portátil: as regras viajam com o token para qualquer caminho de execução, em ambas as faixas de carteira.

Arquitetura de aplicação

ArcToken._update (toda transferência/emissão/queima)
   └─ RestrictionsRouter (um por cadeia, registro do tipo de módulo)
        ├─ TRANSFER_RESTRICTION → WhitelistRestrictions (por token)
        ├─ YIELD_RESTRICTION    → YieldBlacklistRestrictions (por token)
        └─ GLOBAL_SANCTIONS     → (slot existe; nenhum módulo global implantado)
  • WhitelistRestrictions — a lista de permissões. Enquanto transfersAllowed está falso (modo protegido), uma transferência em que qualquer lado esteja fora da lista reverte com o erro tipado TransferRestricted() (0xe827105e). A verificação é executada dentro do token em cada movimentação de saldo — uma transferência de carteira EVM, uma transferência assinada na Solana, uma venda na loja e a movimentação inicial de liquidez passam pelo mesmo portão. Não há como contorná-lo sem os próprios poderes administrativos do emissor.

  • YieldBlacklistRestrictions — exclui endereços das distribuições de rendimento; a parcela pro rata deles permanece no contrato do token.

  • GLOBAL_SANCTIONS — o roteador suporta módulos abrangentes da cadeia aplicados a cada token (por exemplo, uma lista de sanções). Nenhum está implantado hoje; o slot é o local natural para um operado no nível da cadeia.

O modelo de confiança, dito honestamente

A flag da lista de permissões é a decisão fora da cadeia do emissor. KYC/AML acontece no processo do emissor (seus fornecedores, suas regras); a blockchain registra e impõe o resultado — isWhitelisted(addr). Onboarding e revisão é o mecanismo em torno dessa decisão — como um investidor se inscreve, como o emissor decide e o trilho de auditoria que isso deixa — e isso não altera este modelo: continua sendo a decisão do emissor, continua sendo apenas um booleano on-chain, e não há documentos em lugar nenhum. Este é o próprio modelo da Arc framework usado na Plume. Ele é deliberadamente não um sistema de identidade on-chain: não há declarações de identidade, nem atestações on-chain, nem prova criptográfica de a quem um endereço pertence. Padrões que carregam identidade on-chain verificável (por exemplo, ERC-3643) trocam transferências significativamente mais pesadas por essa propriedade; Arc troca mecânicas mais leves por confiança mantida pelo emissor. A Bloom expõe isso honestamente em vez de insinuar mais.

Poderes do emissor (com formato de agente de transferência)

ArcToken.initialize concede ao driver do assistente todas as funções:

Função
Poder

ADMIN_ROLE / DEFAULT_ADMIN_ROLE

vincular/substituir módulos de restrição, gerenciar funções

MINTER_ROLE / BURNER_ROLE

gestão do suprimento

YIELD_MANAGER_ROLE / YIELD_DISTRIBUTOR_ROLE

definir o token de rendimento, executar distribuições

UPGRADER_ROLE

fazer upgrade do token via UUPS (mantido pelo emissor; concedido à factory para upgrades mediados pela factory)

Módulo de lista de permissões WHITELIST_ADMIN_ROLE

adicionar/remover endereços, alternar o modo protegido

Consequências que vale a pena conhecer: uma carteira de investidor perdida só pode ser recuperada por ação do emissor (incluir um endereço de substituição na lista de permissões e, se necessário, usar poderes de mint/burn/upgrade conforme o processo legal deles — a Arc não possui um primitivo nativo de transferência forçada). Portanto, a custódia das chaves do emissor faz parte da postura de conformidade; o visualizador de funções do app torna visíveis os detentores de cada poder.

O que a Rome adiciona — e o que registerToken preserva

Usuários de carteira Solana aparecem como endereços EVM sintéticos (derivados da sua chave pública Solana). Para a camada de conformidade, eles são endereços comuns: o emissor os inclui na lista de permissões, o portão os verifica, o rendimento chega até eles — uma única allowlist abrange os dois mundos de carteiras. As implicações de custódia estão em LANES.md.

Como a Rome limita contas por transação, os tokens são implantados em partes e ganham status de factory por meio de ArcTokenFactoryV2.registerToken em vez do createToken. As proteções preservam exatamente o modelo de segurança upstream: o token deve ser um proxy canônico (codehash), sua implementação deve estar na lista de permissões da factory (codehash), o chamador deve possuir o ADMIN_ROLE, e o registro é único. Nada na superfície de conformidade é enfraquecido pelo caminho em partes.

Atualizado

Isto foi útil?