> 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/issuing.md).

# Emisión

Bloom te permite emitir un **activo del mundo real con permisos** como un contrato Solidity ordinario en una cadena de Rome, y administrarlo desde una consola por activo. Se puede acceder al activo desde billeteras EVM y Solana, pero **la emisión es solo EVM** — una billetera de Solana mantiene activos; no los crea. Esta guía cubre la consola del emisor, el asistente de creación, la puerta de inicio de sesión de la consola y cada una de las seis pestañas de administración.

> **No le entregas a Bloom ningún documento ni dato personal, y tu inversor tampoco.** Bloom registra el *resultado* de tu decisión de cumplimiento; la cadena registra un booleano por dirección. Tu proceso KYC/AML — tus proveedores, tus archivos, tu retención — permanece por completo en tu propio sistema. El modelo completo está en [COMPLIANCE.md](https://docs.rome.builders/es/apps-en-rome/bloom/compliance.md); esta guía remite a él en lugar de repetirlo.

***

## Lo que puedes hacer

Como administrador de un activo, todo lo que sigue lo haces tú desde la consola — y cada una de estas acciones es una transacción real en cadena, enlazada en la [Prueba](https://docs.rome.builders/es/apps-en-rome/bloom/evidence.md) página:

* **Emitir un activo** — el asistente lo despliega como tres contratos (abajo).
* **Revisar solicitudes** — aprobar o rechazar cada una (un rechazo incluye un motivo que se le debe al solicitante) y admitir una dirección aprobada en la lista de permitidos.
* **Administrar la lista de permitidos** — añadir una dirección, añadir **un lote de direcciones en una sola transacción** (`batchAddToWhitelist`), o eliminar una dirección; el token aplica la lista en cada transferencia.
* **Restringir el activo** — restringir las transferencias a la lista de permitidos (lo que hace que la oferta quede fijada), o levantar la restricción.
* **Administrar la oferta** — leer el total, y acuñar o quemar una vez que tengas el rol.
* **Gestionar la venta** — abrir una venta (unidades y precio), cerrarla, retirar el inventario no vendido y retirar los ingresos.
* **Configurar y distribuir rendimiento** — establecer la moneda de pago y luego distribuir un pago, que recorre a los tenedores una transacción a la vez; los tenedores excluidos se omiten.
* **Administrar roles** — conceder un rol a una dirección, revocarlo o renunciar al propio.

Cada uno se detalla a continuación, junto con lo que la cadena impone, en la pestaña a la que pertenece.

***

## La consola del emisor

![La consola del emisor en /issuer, que enumera los activos que conoce este despliegue y su estado de venta.](https://1082203750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F671PKS8ZQSNqtoC8PGvz%2Fuploads%2Fgit-blob-c94de7c7a94a287a4d9b90a92b2b16022213b702%2Fissuer-console.png?alt=media\&token=657509e2-8263-4579-b54b-b6b4af33b6d6)

`/issuer` enumera los activos que has emitido en esta cadena y te permite iniciar uno nuevo.

* Conecta una **Cartera EVM**. A un visitante desconectado, o a una billetera de Solana, se le muestra un aviso para conectar el tipo correcto de billetera en lugar de una consola vacía — una billetera de Solana no puede emitir, y ese es un límite del producto que la cadena aplica como una segunda barrera independiente.
* La tabla enumera cada activo con su **nombre y símbolo**, su ciclo de vida **fase**, y su **Venta** estado (un *Abre* insignia o *Cerrada*).

Dos columnas — **Tenedores** y **Por revisar** — muestran un guion. El recuento de tenedores necesita la enumeración de la lista de permitidos y la cola de revisión es un almacén fuera de la cadena en el que inicias sesión por activo; un guion dice *no consultado* donde un `0` afirmaría un hecho que la aplicación no ha leído.

Pulsa **Emitir un activo** para abrir el asistente, o selecciona una fila para abrir la consola de ese activo.

***

## Crear un activo: el asistente

![El asistente de creación en /create: los campos del activo, y luego seis tarjetas que se iluminan a medida que sus transacciones se confirman.](https://1082203750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F671PKS8ZQSNqtoC8PGvz%2Fuploads%2Fgit-blob-94683a3a49ac2418aed8cc66dbf47fad940814f7%2Fcreate-wizard.png?alt=media\&token=38b47568-d343-483d-8ce1-f437164bdeae)

`/create` recopila cuatro campos y luego despliega tu activo.

| Campo         | Regla                            |
| ------------- | -------------------------------- |
| **Nombre**    | Obligatorio.                     |
| **Símbolo**   | Obligatorio.                     |
| **Oferta**    | Un número entero mayor que cero. |
| **Decimales** | Un número entero de 0 a 18.      |

Pulsa **Iniciar**. Si un campo es inválido, el asistente te dice cuál y por qué en lugar de quedarse detrás de un botón deshabilitado. Cuando el borrador es válido, se le pide a tu billetera que firme cada paso por turno.

### Por qué se despliega por partes

> **Un token se despliega como tres contratos a lo largo de varias transacciones — nunca en una sola.** La de una sola transacción de Arc `createToken` necesitaría **77 bloqueos de cuenta**, y Rome limita una sola transacción a **62 bloqueos**. Así que el asistente despliega cada parte en su propia transacción y luego obtiene el estado de fábrica mediante `ArcTokenFactoryV2.registerToken`. Esta es una restricción de Rome hecha visible, no una optimización opcional — y las barreras preservan exactamente el modelo de seguridad ascendente de Arc (proxy canónico, implementación en lista blanca, el llamador posee el rol de administrador del token, el registro es de una sola vez). Véase [COMPLIANCE.md](https://docs.rome.builders/es/apps-en-rome/bloom/compliance.md#what-rome-adds-and-what-registertoken-preserves).

### Las seis tarjetas

El asistente muestra seis tarjetas, que siguen el progreso del despliegue. Una tarjeta pasa de **En espera** a **Firmando…** a **Hecho** (o **Fallido**) a medida que su transacción se confirma.

| # | Tarjeta                             | Qué hace                                                                                                                              |
| - | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| 1 | **Implementación**                  | La implementación compartida del activo para esta cadena — resuelta, nada que firmar. (Hecho antes de que se ejecute cualquier paso.) |
| 2 | **El activo**                       | Despliega tu activo y establece su nombre, símbolo, oferta y decimales en un solo paso.                                               |
| 3 | **Quién puede poseerlo**            | Despliega el propio módulo de permisos de este activo, contigo como administrador.                                                    |
| 4 | **Imponerlo en las transferencias** | Apunta el activo a ese módulo, de modo que cada transferencia sea verificada por el propio activo.                                    |
| 5 | **Reglas de rendimiento**           | Despliega y enlaza el módulo que decide quién cobra.                                                                                  |
| 6 | **Registro**                        | Registra el activo — esto es lo que abre la venta y te permite actualizarlo más tarde.                                                |

Las seis tarjetas agrupan ocho pasos de despliegue subyacentes, así que una sola **Iniciar** da como resultado **ocho firmas**. *"Tu billetera te pedirá que firmes cada paso. Detente en cualquier momento y retoma desde donde lo dejaste — no se pierde nada."* Que el registro sea el paso final es lo que hace que detenerse sea seguro: el activo es un despliegue real en cada etapa, y se registra al final.

Cuando termina la ejecución, el asistente muestra *"Emitido. Tu activo está en línea en …"* con un enlace a la consola del activo en `/token/[address]`.

> **`inicializar` te concede todos los roles.** El ejecutor del asistente — tu dirección EVM — recibe los roles de administrador, acuñador/quemador, gestor/distribuidor de rendimiento y actualizador del token, además del rol de administrador del módulo de lista de permitidos. La custodia de tus claves es, por tanto, parte de la postura de cumplimiento del activo: una billetera de inversor perdida solo puede recuperarse mediante tu acción de administrador, y la pestaña Derechos de la consola **Derechos** hace visible al titular de cada poder. (`UPGRADER_ROLE` es *no* otorgado a la fábrica automáticamente — concédelo explícitamente si quieres actualizaciones mediadas por la fábrica.)

***

## La consola por activo y la puerta de inicio de sesión

![La puerta de inicio de sesión de la consola: firma un mensaje con tu billetera — no hay contraseña.](https://1082203750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F671PKS8ZQSNqtoC8PGvz%2Fuploads%2Fgit-blob-a9377e3cad8460af1d9bb4eb3cf6f2a6a8f28b22%2Fconsole-signin.png?alt=media\&token=fdc19e4f-8724-4d36-999b-def1990685f9)

Abrir `/token/[address]` no **no** muestra la consola de inmediato. Muestra una **puerta de inicio de sesión**:

> *"Inicia sesión para administrar este activo. Firma un mensaje con tu billetera — no hay contraseña. Tu autoridad proviene del propio activo, y se vuelve a comprobar en cada acción, así que revocarla surte efecto de inmediato."*

Pulsa **Inicia sesión con tu billetera**. Esto es exactamente lo que sucede:

1. Se le pide a tu billetera que `personal_sign` una breve declaración legible por humanos (encabezada *"Bloom — demuestra que administras este activo"*) que nombra la única acción que autoriza — leer la cola de solicitudes de este activo — junto con la dirección del activo, el id de la cadena y una marca de tiempo.
2. La aplicación envía esa declaración firmada a `GET /api/applications`.
3. Los **servidor** la verifica: recupera tu dirección a partir de la firma, confirma que la declaración es para esta cadena y que sigue vigente (autoriza durante una ventana de dos minutos, no durante una sesión), lee el **módulo de lista de permitidos del propio token** desde la cadena, y comprueba que tu dirección posee el rol que realmente requiere la escritura en la lista de permitidos — `MANAGER_ROLE` en ese módulo.
4. Si lo posees, se devuelve la cola y se renderiza la consola. Si no, el servidor rechaza con `403` y un motivo.

![La puerta muestra un rechazo entrecomillado: se deniega el acceso a una billetera que no administra este activo.](https://1082203750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F671PKS8ZQSNqtoC8PGvz%2Fuploads%2Fgit-blob-99040b8d3c752f0f84615b913d6b75fb0d36f81b%2Fconsole-refusal.png?alt=media\&token=29c3ffcf-b826-4aa7-b9da-41bdc3ec2e1e)

> **El activo decide quién puede administrarlo — no esta aplicación.** El rol se comprueba en la lista de permitidos **módulo**, no en el token, y tener un rol con el mismo nombre en el token no *no* se transfiere — son autoridades diferentes. No hay cuenta ni sesión: cada solicitud posterior lleva su propia firma recién generada, que es lo que *"se vuelve a comprobar en cada acción"* significa. Revoca el rol de una billetera en la cadena y deja de poder iniciar sesión de inmediato.

Un rechazo muestra el motivo **entrecomillado** — Bloom nunca escribe una frase sobre por qué se rechazó una billetera. Si rechazas la firma en tu billetera, ese es tu *"no"*, no el del activo, y no se informa como un rechazo.

> **La puerta define de quién es la consola, no qué es secreto.** La oferta, el estado de la venta, el listado de la lista de permitidos y los roles son lecturas públicas de la cadena que responderá cualquier explorador. Lo que te concede la firma es la **cola de solicitudes** — las declaraciones de otras personas — y el derecho a que se te muestre la consola en absoluto.

### El encabezado de la consola

Una vez iniciada la sesión, el encabezado nombra el activo y muestra su **fase** — el hecho más importante que tiene:

| Fase            | Significado                                                                                                                                                    |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Borrador**    | Aún no se ha enlazado ningún módulo de permisos, así que nada restringe quién puede poseer esto.                                                               |
| **Abre**        | Las transferencias están abiertas y la oferta aún puede cambiar. Restringir el activo fija su oferta, y eso no puede deshacerse.                               |
| **Restringido** | Solo las direcciones incluidas en la lista de permitidos pueden poseer esto, **y su oferta es final** — no se puede acuñar ni quemar más, de forma permanente. |

Encima de las pestañas, un resumen muestra cuatro cifras — **Tenedores · Por revisar · Vendido · Rendimiento pagado**. Dos se leen de la cadena y del almacén (*Por revisar* una vez que hayas iniciado sesión; *Vendido* desde la tienda); *Tenedores* depende del recuento de tenedores de la vista previa de rendimiento, y *Rendimiento pagado* depende del cursor del historial de pagos que aún está por llegar. Cada celda en espera muestra un guion y explica lo que necesita, en lugar de un `0` que afirmaría un hecho que nadie le pidió a la cadena.

***

## Las seis pestañas

La consola tiene seis pestañas, en este orden: **Solicitudes · Quién puede poseerlo · Oferta · Venta · Rendimiento · Derechos.**

Cada escritura en estas pestañas usa un control compartido que muestra las **precondiciones con nombre** y sus **consecuencias** *antes* del botón, y nombra su fase mientras se ejecuta (*"Esperando tu cartera…"*, *"Aterrizando en la cadena…"*). Nada debería revertirse para enseñarte qué podría haberse comprobado primero.

### Solicitudes — la cola de revisión

![La pestaña Solicitudes — la cola de revisión, con una solicitud pendiente para aprobar o rechazar, y la costura de cumplimiento.](https://1082203750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F671PKS8ZQSNqtoC8PGvz%2Fuploads%2Fgit-blob-8249de8b76f757101cc945ca4a2687103428839c%2Ftab-applications.png?alt=media\&token=ab0def9b-0bcb-49eb-b785-fd78e6fa2f92)

Esta pestaña enumera quién ha solicitado poseer el activo. Cada fila muestra la dirección del solicitante, la jurisdicción, el tipo de tenedor, una **Comprobaciones** columna (*Aprobado* si tu proveedor registró un resultado, o *Declarado*), y una **Estado** (*Por revisar*, *Aprobado*, *Rechazado*). Expande una fila para ver sus hechos y dos controles: **Aprobar — puede poseerlo** y **Rechazar**. Un rechazo requiere un motivo, que se convierte en la respuesta del solicitante.

> **Aprobar son dos actos separados, y la pestaña los mantiene honestos.** Al pulsar **Aprobar** *registra* tu decisión en el almacén de solicitudes. Poner la dirección en la lista de permitidos del activo en la cadena es una **segunda firma** — `batchAddToWhitelist` — y hasta que se confirme la fila lo indica. Cuando la decisión registrada y la cadena no coinciden, la pestaña nombra la discrepancia y ofrece la escritura que la cierra: **Admitir** para añadir una dirección aprobada a la lista de permitidos, o (para una dirección rechazada que aún figura en la lista) el control para eliminarla. La dirección no puede poseer el activo hasta que la escritura de la lista de permitidos se confirme.

Una nota permanente en esta pestaña — la **costura de cumplimiento** — indica dónde encaja tu propio proceso:

> *"No se piden ni se guardan documentos aquí — las comprobaciones son tuyas. Conecta a tu proveedor detrás de la `Solicitudes` interfaz, o importa decisiones que ya hayas tomado. Bloom registra el resultado y la cadena registra un sí o no contra la dirección."*

Esa es la interfaz que reemplaza un emisor autoalojado: sustituye la implementación del almacén de solicitudes por la tuya, duradera, y ningún llamador cambia. Bloom no realiza comprobaciones ni guarda ningún documento.

### Quién puede poseerlo — la puerta de transferencias

![La pestaña Quién puede poseerlo — el recuento de la lista de permitidos y el control de restringir transferencias, mostrando sus consecuencias de puerta de un solo sentido.](https://1082203750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F671PKS8ZQSNqtoC8PGvz%2Fuploads%2Fgit-blob-d32c410e3b5798d86dc5b914bce2f927eb4b1620%2Ftab-holders.png?alt=media\&token=aefe491d-2ce8-4478-a776-b9e612536d60)

Esta pestaña informa cuántas direcciones están en la lista de permitidos del activo, y te permite cambiar si la lista de permitidos está **aplicada**:

* Cuando las transferencias están **sin restricción**, ofrece **restringir las transferencias a la lista de permitidos**. Las consecuencias de la escritura indican que hacerlo vuelve final la oferta y es una puerta de un solo sentido para los no administradores.
* Cuando las transferencias están **restringidas**, ofrece **levantar la restricción**. Sus consecuencias dejan claro que esto no es un deshacer.

En un *sin restricciones* (activo) en borrador sin ningún módulo de permisos enlazado, la pestaña lo indica — *"No hay ningún módulo de permisos enlazado, así que nada restringe quién puede poseer esto"* — y el interruptor no se muestra.

> **El token comprueba ambos lados de cada transferencia.** Mientras el activo esté restringido, una transferencia en la que cualquiera de las partes no esté en la lista de permitidos se revierte en la cadena con un error tipado. La misma puerta se aplica a una transferencia desde una billetera EVM, una transferencia firmada por Solana, una venta en la tienda y el movimiento inicial de liquidez — no hay forma de rodearla salvo con tus propios poderes de administrador.

### Oferta

![La pestaña Oferta — unidades totales existentes.](https://1082203750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F671PKS8ZQSNqtoC8PGvz%2Fuploads%2Fgit-blob-29eb2d741e5193eef3ea94a214a199f2eb404fe7%2Ftab-supply.png?alt=media\&token=2ab35474-ed9a-4d30-b978-5f69e1c0e7b9)

Esta pestaña informa de la oferta total existente, en unidades enteras.

### Venta — abrir, cerrar y retirar ingresos

![La pestaña Venta — una venta abierta, con los controles para cerrar la venta, retirar lo no vendido y retirar los ingresos.](https://1082203750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F671PKS8ZQSNqtoC8PGvz%2Fuploads%2Fgit-blob-573a99f9028a984b038162dc885a16b715673293%2Ftab-sale.png?alt=media\&token=18f59a19-9d83-4780-abf2-47e4a3e37d14)

Esta pestaña gestiona la venta principal a través del contrato de la tienda.

* **Cuando no hay ninguna venta abierta**, ofrece abrir una: introduce **Unidades a vender** y **Precio por unidad** (en `wUSDC`), luego pulsa **Abrir la venta**. Primero se muestran las precondiciones de la escritura — el token debe estar registrado, la tienda debe tener el inventario de la venta y la propia tienda debe estar en la lista de permitidos del token que vende — así que una venta que aún no puede abrirse dice exactamente lo que necesita.
* **Cuando una venta está abierta**, muestra cuántas unidades quedan de la oferta y ofrece **Cerrar esta venta**.
* **Retirar unidades no vendidas** mueve el inventario no vendido desde la tienda de vuelta a un destinatario (por defecto, tú). Esto es **no** un cierre — la venta sigue habilitada, y la consecuencia de la escritura lo dice, así que un retiro no puede confundirse con una reversión.
* **Retirar ingresos** envía los ingresos de la tienda a una dirección (por defecto, la tuya). Los ingresos se acumulan de forma independiente al estado de la venta, así que pueden retirarse tanto si la venta está abierta como cerrada.

### Rendimiento — pagar a los tenedores, uno por transacción

![La pestaña Rendimiento — el campo de importe de distribución, con el recordatorio de establecer primero una moneda de pago.](https://1082203750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F671PKS8ZQSNqtoC8PGvz%2Fuploads%2Fgit-blob-cc8150ea6fee72d99bd5a2254073779cbd896c11%2Ftab-yield.png?alt=media\&token=d190f7bd-1a1c-4ed2-b9a2-d27a399602f6)

Esta pestaña distribuye un pago de rendimiento a los tenedores.

> **Una distribución es un recorrido, no un clic.** En Rome, `distributeYieldWithLimit` paga **un tenedor por transacción** (el límite de cuentas), así que un pago es una secuencia de ventanas, cada una con su propia firma. Introduces el importe una sola vez, en unidades enteras de la moneda de pago, y queda bloqueado una vez que comienza el recorrido. La **primero** ventana toma de ti todo el pago y abona al primer tenedor; cada ventana posterior solo mueve dinero que ya está dentro del contrato del token. Bloom vuelve a leer el cursor de la cadena después de cada ventana — el conjunto de tenedores se reordena a medida que cambian los saldos, y enviar un índice obsoleto reiniciaría desde cero y tomaría tu dinero una segunda vez.

La pestaña muestra el progreso — *"Pagando al tenedor N de M"* — y termina cuando el cursor vuelve al inicio. Si el activo no tiene establecida una moneda de pago, la pestaña lo indica; establecer la moneda de pago es el único campo de una distribución que solo tú puedes elegir.

> **Las participaciones de los tenedores restringidos permanecen en el contrato.** Una dirección excluida por el módulo de lista negra de rendimiento se omite, y su parte proporcional permanece en el contrato del token en lugar de pagarse.

Los pagos anteriores aún no se muestran — leerlos recorre los eventos de distribución hasta el primer bloque del activo, lo que necesita un cursor de historial que aún está por venir. La pestaña lo dice dentro de sí misma en lugar de mostrar un `0`.

### Derechos — los roles

![La pestaña Derechos — cada rol y si está poseído, y el control para conceder / revocar / renunciar.](https://1082203750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F671PKS8ZQSNqtoC8PGvz%2Fuploads%2Fgit-blob-fb54f6c73c2d194dd5b6321bc3cb0af825f6f637%2Ftab-rights.png?alt=media\&token=6f545a79-96f8-4c9e-ac38-ce435e547deb)

Esta pestaña enumera cada rol que declara el token y si está poseído, cada uno leído con una sola `hasRole` llamada al token. Un rol que está **no** poseído se muestra como tal en lugar de omitirse — en una pestaña de derechos, una fila ausente y un *"no"* son hechos diferentes.

Debajo de la lista, un control modifica los roles:

| Acción                    | Actúa sobre                                                            | Autoridad            |
| ------------------------- | ---------------------------------------------------------------------- | -------------------- |
| **Conceder a una cuenta** | Una dirección que introduces                                           | `DEFAULT_ADMIN_ROLE` |
| **Revocar de una cuenta** | Una dirección que introduces                                           | `DEFAULT_ADMIN_ROLE` |
| **Renunciar al propio**   | A ti mismo (OpenZeppelin requiere que la confirmación sea el llamador) | Tú                   |

Las opciones de rol son las del propio token, así que el control nunca puede ofrecer un rol que el token no tenga. Como en cada escritura, la fila de autoridad y la consecuencia se muestran antes del botón, así que la puerta y su carácter de un solo sentido se declaran antes de que firmes.

***

## Lo que nunca toca Bloom ni la cadena

Para dejar claro dónde reside el cumplimiento:

| Cosa                                                 | Dónde reside                                                                                       |
| ---------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| Documentos KYC/AML y datos personales identificables | Tu propio sistema, con tus propios proveedores y retención — **nunca** esta aplicación o la cadena |
| Tu decisión de admitir una dirección                 | Un registro fuera de la cadena; tú eres dueño del almacén                                          |
| El efecto en cadena de esa decisión                  | Un booleano — `isWhitelisted(address)` — escrito por `batchAddToWhitelist`                         |
| Aplicación de la regla                               | El contrato del activo, en cada transferencia                                                      |
| Quién puede administrar el activo                    | El rol poseído en el módulo de lista de permitidos del activo, verificado en cada solicitud        |

Para ver el modelo de cumplimiento completo, lee [COMPLIANCE.md](https://docs.rome.builders/es/apps-en-rome/bloom/compliance.md); para la mecánica de dos carriles (EVM y Solana) que usan tus tenedores, lee [LANES.md](https://docs.rome.builders/es/apps-en-rome/bloom/lanes.md).


---

# 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/issuing.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.
