> For the complete documentation index, see [llms.txt](https://docs.rome.builders/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rome.builders/es/apps-en-rome/bloom/compliance.md).

# Modelo de cumplimiento

Bloom ejecuta el framework Arc de Plume sin modificaciones. El cumplimiento es **aplicado por el propio contrato del token** — no por ningún filtro fuera de cadena, filtro del secuenciador ni política del mercado. Esa es la propiedad que lo hace portable: las reglas viajan con el token a cualquier ruta de ejecución, en ambos carriles de billetera.

## Arquitectura de aplicación

```
ArcToken._update (cada transferencia/mint/burn)
   └─ RestrictionsRouter (uno por cadena, registro de tipo de módulo)
        ├─ TRANSFER_RESTRICTION → WhitelistRestrictions (por token)
        ├─ YIELD_RESTRICTION    → YieldBlacklistRestrictions (por token)
        └─ GLOBAL_SANCTIONS     → (la ranura existe; no hay ningún módulo global desplegado)
```

* **WhitelistRestrictions** — la lista blanca. Mientras `transfersAllowed` sea falso (modo restringido), una transferencia en la que cualquiera de las partes esté fuera de la lista revierte con el error tipado `TransferRestricted()` (`0xe827105e`). La verificación se ejecuta dentro del token en cada movimiento de saldo — una transferencia entre billeteras EVM, una transferencia firmada en Solana, una venta en un escaparate y el movimiento inicial de liquidez pasan todos por la misma puerta. No hay forma de rodearla salvo por los poderes administrativos propios del emisor.
* **YieldBlacklistRestrictions** — excluye direcciones de las distribuciones de rendimiento; su parte proporcional permanece en el contrato del token.
* **GLOBAL\_SANCTIONS** — el router admite módulos de toda la cadena aplicados a cada token (por ejemplo, una lista de sanciones). Hoy no hay ninguno desplegado; la ranura es el lugar natural para uno operado a nivel de cadena.

## El modelo de confianza, dicho con honestidad

**La bandera de lista blanca es una decisión fuera de cadena del emisor.** KYC/AML ocurre en el proceso del emisor (sus proveedores, sus reglas); la cadena registra y aplica el *resultado* — `isWhitelisted(addr)`. [Incorporación y revisión](https://docs.rome.builders/es/apps-en-rome/bloom.md) es el mecanismo alrededor de esa decisión — cómo solicita un inversor, cómo decide el emisor y la pista de auditoría que deja — y no cambia este modelo: sigue siendo decisión del emisor, sigue siendo solo un booleano en cadena, y no hay documentos en ninguna parte. Este es el modelo propio del framework Arc tal como se usa en Plume. Está deliberadamente *no* un sistema de identidad en cadena: no hay reclamaciones de identidad, no hay atestaciones en cadena, no hay prueba criptográfica de a quién pertenece una dirección. Los estándares que incorporan identidad verificable en cadena (p. ej., ERC-3643) intercambian transferencias significativamente más pesadas por esa propiedad; Arc intercambia mecánicas más ligeras por confianza en manos del emisor. Bloom muestra esto con honestidad en lugar de insinuar más.

## Poderes del emisor (con forma de agente de transferencias)

`ArcToken.initialize` otorga al controlador del asistente todos los roles:

| Rol                                             | Poder                                                                                                                        |
| ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `ADMIN_ROLE` / `DEFAULT_ADMIN_ROLE`             | vincular/sustituir módulos de restricción, gestionar roles                                                                   |
| `MINTER_ROLE` / `BURNER_ROLE`                   | gestión del suministro                                                                                                       |
| `YIELD_MANAGER_ROLE` / `YIELD_DISTRIBUTOR_ROLE` | establecer el token de rendimiento, ejecutar distribuciones                                                                  |
| `UPGRADER_ROLE`                                 | actualizar el token mediante UUPS (retenido por el emisor; conceder al factory para actualizaciones mediadas por el factory) |
| Módulo de lista blanca `WHITELIST_ADMIN_ROLE`   | añadir/eliminar direcciones, alternar el modo restringido                                                                    |

Consecuencias que conviene conocer: una **billetera de inversor perdida** solo es recuperable mediante una acción del emisor (poner en lista blanca una dirección de reemplazo y, si es necesario, usar los poderes de mint/burn/upgrade según su proceso legal — Arc no tiene un primitivo de transferencia forzada incorporado). La custodia de la clave del emisor forma por tanto parte de la postura de cumplimiento; el visor de roles de la aplicación hace visibles los titulares de cada poder.

## Lo que añade Rome — y lo que preserva registerToken

Los usuarios de billeteras Solana aparecen como **direcciones EVM sintéticas** (derivadas de su clave pública de Solana). Para la capa de cumplimiento son direcciones ordinarias: el emisor las pone en lista blanca, la puerta las verifica, el rendimiento les llega — una sola lista blanca abarca ambos mundos de billetera. Las implicaciones de custodia están en [LANES.md](https://docs.rome.builders/es/apps-en-rome/bloom/lanes.md).

Como Rome limita la cantidad de cuentas por transacción, los tokens se despliegan por partes y obtienen estado de factory mediante `ArcTokenFactoryV2.registerToken` en lugar de la creación única `createToken`. Las salvaguardas preservan exactamente el modelo de seguridad aguas arriba: el token debe ser un proxy canónico (codehash), su implementación debe estar en la lista blanca del factory (codehash), el llamador debe poseer el token's `ADMIN_ROLE`, y el registro es de una sola vez. Nada en la superficie de cumplimiento se debilita por la ruta por partes.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.rome.builders/es/apps-en-rome/bloom/compliance.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
