¿Qué es un gateway de Label 309?

Un gateway de Label 309 es el servicio que publica registros de prueba de existencia en Cardano. Se encarga del trabajo operativo —fijación de precios, subidas, envío de transacciones, seguimiento de confirmaciones, indexación de registros, saldos, claves de API y webhooks— para que el cliente no tenga que hacerlo. El cliente prepara la prueba y conserva las claves privadas en local; el gateway lleva el registro a la red.

Label 309 es el estándar abierto y neutral respecto al proveedor para anclar el hash de un contenido en Cardano bajo la etiqueta de metadatos 309. El gateway es la parte que se encarga de publicar. No es un backend privado que solo una empresa pueda usar: es una capa de servicio definida que cualquier producto puede ejecutar o con la que puede integrarse, y la implementación de referencia es de código abierto. CardanoWall opera su propio producto comercial sobre exactamente estas mismas superficies, sin ninguna vía reservada solo para sí.

¿Por qué publicar necesita un gateway?

Verificar es ligero. Publicar es operativo.

Para verificar una prueba, normalmente partes de una referencia de transacción de Cardano, recuperas el registro desde un explorador público y vuelves a calcular tú mismo los hashes o las firmas. No hace falta ningún servicio especial: esa independencia es la razón de ser del estándar. (Consulta cómo verificar un registro Label 309 para ver el camino completo.)

Publicar tiene muchas más piezas en movimiento:

• construir un registro Label 309 válido;
• estimar el coste de la transacción de Cardano;
• subir el texto cifrado o el contenido cuando hay archivos de por medio;
• pagar los costes de almacenamiento;
• enviar la transacción de Cardano;
• esperar la confirmación;
• gestionar fallos y reembolsos;
• indexar el resultado;
• exponer el estado de vuelta al usuario;
• mantener los saldos de las cuentas exactos.

Un gateway empaqueta todas esas preocupaciones detrás de una API. Sin él, cada producto que quisiera publicar tendría que reconstruir la misma canalización de cadena y almacenamiento. Con él, un equipo de producto puede centrarse en su experiencia de usuario y su flujo de trabajo de negocio mientras el gateway se ocupa de la cadena, el almacenamiento y la contabilidad.

¿Qué hace realmente el gateway?

El gateway es dueño de la canalización de publicación y del estado de dinero, cadena y almacenamiento que hay detrás. En términos prácticos, puede:

• presupuestar una prueba antes de que publiques (el precio se mantiene durante una ventana breve, en torno a 15 minutos);
• aceptar subidas cifradas y subidas de contenido público, devolviendo URI direccionados por contenido;
• aceptar un registro de prueba ya preparado;
• construir y enviar una transacción de Cardano con comisiones exactas;
• seguir la confirmación, incluida la gestión de reorganizaciones;
• reembolsar automáticamente el cargo cuando una publicación falla de forma permanente;
• indexar cada registro Label 309 de la red en un feed público y compartido;
• gestionar los saldos prepagados de las cuentas y aplicar la fijación de precios;
• emitir claves de API y tokens de cuenta;
• enviar webhooks ante eventos del ciclo de vida.

Eso lo convierte en el motor de publicación que hay detrás de la app web de CardanoWall, la app de escritorio, la herramienta de línea de comandos, las integraciones basadas en SDK, los flujos de CI/CD y los productos de terceros por igual.

¿Qué decide el gateway no hacer deliberadamente?

El gateway no es la raíz de confianza.

Nunca necesita tu semilla de identidad. Nunca necesita las claves privadas de los destinatarios. No descifra archivos sellados. Y nunca es el único sitio donde se puede comprobar una prueba. Esas propiedades son intencionadas: mantenerlas fuera del gateway es lo que permite que una prueba se sostenga por sí sola.

Una prueba Label 309 válida descansa sobre datos públicos, no sobre la palabra del gateway:

• la transacción de Cardano;
• los metadatos de Label 309;
• el contenido original o el texto cifrado, cuando hace falta;
• las firmas de los registros y las claves públicas;
• las pruebas de Merkle, para los registros agrupados;
• las propias claves del destinatario, para el contenido sellado.

Si el gateway informa de que una prueba existe, un verificador todavía puede confirmarla contra la cadena, sin intervención alguna del gateway. Para ver qué puede y qué no puede observar quien opera un gateway, consulta qué puede ver CardanoWall.

¿Qué es el plano de datos?

El plano de datos es la API de cara al usuario. Es lo que llama un cliente cuando actúa en nombre de un usuario o una cuenta —una app web, la app de escritorio, la CLI, un SDK o un script de automatización— para pedir un presupuesto, subir, publicar, leer un saldo o listar registros. Vive en la ruta /api/v1/*.

El flujo conceptual es corto:

1. Pide un presupuesto.
2. Sube el contenido o el texto cifrado, cuando hay archivos de por medio.
3. Publica la prueba.
4. Sigue el estado.
5. Lee los registros y los saldos.

Es el mismo camino que usa el producto de referencia. Si un flujo funciona para CardanoWall, está disponible para cualquiera a través del plano de datos público.

¿Qué es el plano de control?

El plano de control es para operadores y backends de producto, y vive en la ruta /control/v1/*.

Si una empresa construye su propio producto sobre un gateway, su backend necesita crear cuentas, aplicar créditos de facturación, emitir tokens de cuenta de corta vida, fijar márgenes por cuenta, crear claves de API y ejecutar tareas a nivel de operador. Eso es trabajo del plano de control, y debe ocurrir desde un backend de confianza, nunca desde código de navegador ni desde un cliente móvil.

El plano de control es lo que permite que un gateway dé servicio a más de un producto. Otro equipo puede ejecutar encima su propia capa de proveedor: sus propios usuarios, su facturación, su interfaz, su soporte y su semántica de producto, mientras el gateway se ocupa de la canalización base de publicación por debajo. La frontera entre ambos es la API HTTP y el firehose de webhooks, no la base de datos del gateway, que se mantiene privada dentro del motor.

¿Qué significa «sin puerta privada»?

Significa que el producto de referencia publica a través de las mismas superficies que recibe todo el mundo. No hay ninguna vía secreta, más rápida o privilegiada reservada para CardanoWall.

Esto importa para la credibilidad. Si un proyecto afirmara que su estándar es abierto pero publicara a través de una maquinaria interna oculta, el ecosistema seguiría dependiendo de ese único proveedor. El modelo de gateway elimina esa dependencia: CardanoWall puede ser el primer producto pulido, mientras otros equipos construyen sus propias herramientas, servicios, paneles, clientes de escritorio y flujos de trabajo sectoriales sobre el mismo camino estándar. Si estás construyendo sobre él, consulta cómo construir sobre un gateway de Label 309.

¿Puede una empresa ejecutar su propio gateway?

Sí. El núcleo del gateway es de código abierto —un único binario de Rust más PostgreSQL— y una empresa puede ejecutarlo por su cuenta: financiar sus propias carteras de Cardano y Arweave, crear sus propias cuentas y claves de API, y publicar registros Label 309 sin depender de CardanoWall como operador alojado.

Alojarlo uno mismo puede tener sentido para:

• publicación de alto volumen;
• políticas estrictas respecto a proveedores;
• entornos regulados o aislados de la red;
• flujos de trabajo de cumplimiento interno;
• sistemas de prueba legal;
• infraestructura de procedencia de IA;
• canalizaciones de prueba en CI/CD;
• equipos que ya operan su propia infraestructura de nube y de cadena.

Alojarlo uno mismo no cambia el estándar de los registros: un gateway autoalojado produce los mismos registros, verificables por cualquiera. Solo cambia quién opera el servicio de publicación. La configuración práctica se cubre en cómo ejecutar tu propio gateway.

¿Cuándo conviene usar el gateway alojado de CardanoWall?

Usa el gateway alojado cuando la comodidad importe más que operar la infraestructura por tu cuenta.

El servicio alojado gestiona por ti la financiación, la fijación de precios, el envío, las confirmaciones, el almacenamiento y la administración de cuentas. Eso encaja con usuarios individuales, equipos pequeños, integraciones tempranas y empresas que quieren empezar rápido. Sigues obteniendo registros estándar, sigues pudiendo verificar a partir de datos públicos y sigues pudiendo pasarte más adelante a tu propia herramienta o a tu propio gateway. Que sea alojado no significa quedar atado.

¿Cuándo conviene alojarlo uno mismo?

Aloja el gateway tú mismo cuando el control operativo importe más que la comodidad. Buenas razones para ello:

• publicas a gran volumen;
• quieres tus propias políticas de comisiones y financiación;
• tu organización no puede depender de un servicio alojado por terceros;
• tus registros pertenecen a un flujo de trabajo interno y regulado;
• tu producto necesita su propio modelo de facturación;
• quieres ofrecer publicación de Label 309 bajo tu propia marca;
• quieres control directo sobre las claves de API, las cuentas y los webhooks.

Alojarlo uno mismo da más trabajo. Tú ejecutas el gateway, financias las carteras, supervisas a los proveedores, gestionas los secretos, operas la base de datos, te ocupas de las actualizaciones y mantienes el servicio sano. La recompensa es la independencia.

¿Cómo encaja la fijación de precios?

Publicar cuesta dinero porque el gateway paga costes reales. Cada prueba ancla una transacción de Cardano, que conlleva una comisión de red. Cuando hay archivos de por medio, el gateway también paga el almacenamiento en Arweave. Por encima de eso, asume la gestión del tipo de cambio, la financiación, la infraestructura, la supervisión, el soporte, los reembolsos y el riesgo.

Por eso un gateway alojado cobra sobre la base del traslado de costes más un margen de servicio. Los tipos de cambio son en tiempo real —el gateway fija el precio de cada presupuesto a partir de las tarifas actuales de mercado, no de una constante codificada a mano— y el tipo que respalda un presupuesto puede moverse, razón por la cual un presupuesto solo es válido durante una ventana breve. El precio mostrado puede variar según la cuenta, el socio o la política del operador. Para entender la razón de cobrar siquiera, consulta por qué publicar tiene un precio.

Si quieres evitar el margen de un intermediario alojado, la respuesta no es publicar gratis: los costes de cadena y de almacenamiento son reales de cualquier modo. La respuesta es ejecutar un gateway, financiarlo directamente y asumir tú mismo el trabajo operativo.

¿Cómo se relaciona la app de escritorio con el gateway?

CardanoWall Desktop —una app de escritorio de código abierto construida sobre el SDK de Rust— es un cliente del gateway, no un operador de cadena.

Conserva las identidades en local, sincroniza y hace descifrado de prueba de los registros sellados en tu propia máquina, almacena datos en caché para uso sin conexión, prepara y firma registros, cifra archivos y verifica pruebas, todo en local. Explícitamente no es una cartera: no custodia ADA ni construye y envía transacciones de Cardano por sí misma. Para cualquier cosa que toque la cadena o el almacenamiento, apunta a un gateway y deja que el gateway sea dueño de la canalización de publicación.

Tú eliges qué gateway:

• el gateway alojado de CardanoWall;
• el gateway propio de tu empresa;
• cualquier gateway de terceros;
• un gateway local o de desarrollo.

La app de escritorio es dueña de la experiencia local; el gateway es dueño de la publicación. Más sobre la app en CardanoWall Desktop.

¿Qué deben tener presente quienes desarrollan?

Construye contra la frontera del estándar —los planos HTTP y los webhooks—, no contra el funcionamiento interno del gateway.

Unas pocas reglas mantienen honesta una integración:

• No consultes la base de datos del gateway directamente; es interna del motor y puede cambiar sin previo aviso.
• No pongas credenciales de operador en los clientes. Todo lo que requiera autoridad de operador pertenece a tu backend.
• No trates un saldo en caché como la fuente de verdad para una decisión de gasto; lee el saldo del gateway cuando este condicione un cargo.
• No construyas tu propia vía de reembolso para los fallos de publicación: el gateway ya reembolsa de forma automática, y un segundo reembolso supondría pagar el doble.
• No le pidas al gateway que descifre el contenido del usuario.

La forma limpia es directa: tu cliente o tu backend captan la intención del usuario, tu cliente mantiene los secretos en local, el gateway se ocupa del presupuesto, la subida, la publicación, la confirmación y la indexación, tu producto construye encima su propia interfaz y sus propios modelos de lectura, y la verificación sigue siendo independiente. Así es como un único estándar puede dar soporte a muchos productos sin convertir a cada producto en un operador de cadena y almacenamiento.

La versión corta

Un gateway de Label 309 es la capa de publicación. Presupuesta, sube, publica, confirma, indexa y expone registros. Lo puede alojar CardanoWall, lo puede alojar una empresa por su cuenta, o se puede integrar en otro producto.

No es la raíz de confianza, y no guarda tus claves privadas. Publica registros estándar que cualquiera puede verificar a partir de datos públicos de Cardano, que es exactamente lo que mantiene abierto el estándar.

Para seguir leyendo

• Cómo construir sobre un gateway de Label 309: patrones de integración para los planos de datos y de control.
• Cómo ejecutar tu propio gateway: operar una instancia autoalojada.
• Por qué publicar tiene un precio: el modelo de costes que hay detrás de un presupuesto.
• Verificar un registro Label 309: comprobar una prueba solo a partir de datos públicos.
• El estándar abierto en label309.org y el código abierto en github.com/cardanowall. Label 309 se ha presentado al proceso CIP de Cardano y está bajo revisión por los editores de CIP como propuesta de la categoría Metadata (PR abierta).