> For the complete documentation index, see [llms.txt](https://docs.lid.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lid.pro/es/developers/solana-program.md).

# El programa en Solana

Qué hace el programa de Lid en Solana: registro de productos, enrutamiento del pago, vinculación de atribución, aplicación de la comisión, bolsas, atomicidad, y la postura de seguridad.

En palabras simples: el programa es la pieza de código en Solana que mueve el dinero. Es lo que hace que cada venta se reparta bien y llegue en segundos, sin que Lid retenga nunca los fondos.

Lid corre sobre un programa de Solana que aplica el registro de productos, la vinculación de atribución y la liquidación atómica. Esta página describe la arquitectura a nivel conceptual.

## Qué hace el programa

A nivel de programa, Lid implementa:

1. **Registro de productos.** Registro on-chain del ID de un producto, precio, dirección de quien vende, porcentaje de comisión del sharer, y referencia a los metadatos de entrega.
2. **Enrutamiento del pago.** Un método que acepta el pago en USDC de quien compra y lo enruta a quien vende, al sharer y a Lid según las reglas fijadas en el producto.
3. **Vinculación de atribución.** El método de pago lee un parámetro opcional de referencia de sharer y vincula esa dirección como beneficiaria del reparto del sharer para esta venta en particular.
4. **Aplicación de la comisión.** La comisión del 3% es un reparto fijo en la lógica de liquidación, enrutado a una dirección controlada por Lid.
5. **Bolsas.** En retos y campañas, un presupuesto queda en una bolsa que controla quien fondea hasta que un resultado se verifica; las asignaciones y los reclamos quedan en el mismo registro público.

## Atomicidad

Cada pago es una sola transacción de Solana. Dentro de esa transacción:

* Sale el USDC de quien compra
* Entra la parte de quien vende
* La parte del sharer se asigna a una bóveda que solo ese sharer puede reclamar (si aplica)
* Entra la comisión de Lid
* Se emiten los metadatos de acceso (registro de eventos)

Si cualquier paso falla, la transacción se revierte. No existe un estado parcial donde quien compra pagó sin recibir el producto, o donde quien vende cobró y la parte del sharer no se asignó.

## Qué vive on-chain

* Entradas del registro de productos
* Cada transacción de venta
* Cada liquidación de reparto
* Vinculaciones de atribución de sharers
* Fondeo, asignaciones y reclamos de bolsas
* Saldos de cuentas de quienes venden y de sharers (en USDC)

## Qué vive off-chain

* Descripciones de producto y metadatos enriquecidos
* Archivos de entrega (alojados o enlazados)
* Correo de la cuenta y autenticación
* Estado de la interfaz del panel

Los datos off-chain no son fuente de verdad para el flujo de dinero. Existen para que la experiencia sea usable.

## Actualizaciones

El programa está diseñado para actualizaciones controladas durante la fase alfa.

Ninguna actualización puede cambiar retroactivamente los términos de ventas pasadas. Los registros históricos de reparto son inmutables sin importar las versiones futuras del programa.

## Postura de seguridad

**Principios de diseño aplicados:**

* Superficie de programa mínima viable.
* Los pagos van directo a quien vende y a Lid. La parte de un sharer va a una bóveda que solo ese sharer puede reclamar, y una venta con ventana de reembolso queda apartada y solo puede liberarse a quien vende o volver a quien compró.
* La comisión del 3% en una venta es una constante del protocolo, no un ajuste que alguien pueda cambiar. La comisión de los pagos de retos y campañas es un ajuste que solo Lid puede cambiar, entre 0% y 10%. Hoy es 3%.
* Ninguna función administrativa puede enviar fondos de usuarios a ningún otro lugar. En una disputa sobre una venta apartada, nuestro equipo solo puede liberar el dinero a quien vende o devolvérselo a quien compró. Si nuestro equipo no decide una disputa 14 días después de que termina la ventana de reembolso, cualquiera puede liberar el pago a quien vende, así que un pago apartado nunca queda congelado.
* Todas las operaciones que cambian el estado emiten eventos para monitoreo off-chain.

**No está en marcha hoy:**

* Informe de revisión de terceros.
* Programa público de recompensas por errores.

Somos transparentes sobre lo que está hecho y lo que no. Durante la fase alfa activa, cada ciclo completado se revisa para comprobar que fue correcto.

## Reporte responsable

Si encuentras una vulnerabilidad, escribe a <hello@lid.pro> con los detalles. Respondemos rápido, corregimos en privado cuando se puede, y damos crédito a quienes ayudan. No lo publiques antes de darnos un plazo razonable para atenderlo.

## Qué pueden hacer hoy los desarrolladores

Hoy se llega al programa a través de la app web de Lid, de la conexión de agentes por MCP (mira [Agentes en Lid](https://docs.lid.pro/es/agents.md)), y de la API REST, el SDK y el botón Pay with Lid (mira [API, SDK y botón de compra](https://docs.lid.pro/es/developers/agentic-commerce-api.md)). La interacción directa on-chain es posible: el programa está desplegado y es público.

Siguiente: [API, SDK y botón de compra](https://docs.lid.pro/es/developers/agentic-commerce-api.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.lid.pro/es/developers/solana-program.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.
