> 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/smart-contracts.md). # Contratos inteligentes 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 contrato inteligente es la pieza de código que mueve el dinero. Es lo que hace que cada venta se reparta bien y aterrice 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. Las interfaces completas, las firmas de métodos y el código de ejemplo se publican después de la revisión externa, cuando la API pública se estabilice. ## Qué hace el programa A nivel de contrato, Lid implementa: 1. **Registro de productos.** Registro on-chain del ID de un producto, precio, dirección del creador, 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 del comprador y lo enruta al creador, 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 el financiador 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 del comprador * Entra la parte del creador * Entra la parte del sharer (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 el comprador pagó sin recibir el producto, o donde el creador cobró y el sharer no. ## 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 creadores y 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 Los contratos actuales están diseñados para actualización controlada durante la fase alfa. La autoridad de actualización la tiene un multi-sig. 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 contrato. ## Postura de seguridad **Principios de diseño aplicados:** * Superficie de contrato mínima viable. * Los pagos siempre van directo a las cuentas de destino, nunca a través de cuentas intermedias de retención. * La comisión del 3% se aplica como constante del protocolo, no como campo de configuración mutable. * Ninguna función administrativa puede mover fondos de usuarios. * Todas las operaciones que cambian el estado emiten eventos para monitoreo off-chain. **Revisión externa planeada:** * Revisión formal por una firma de seguridad especializada en Solana. Los criterios ya están escritos. * Programa continuo de recompensas por errores una vez que la API pública sea estable. **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 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 la interacción con el contrato pasa por la app web de Lid y por la conexión de agentes sobre MCP (mira [Agentes en Lid](/es/agents.md)). La interacción directa on-chain es posible (los contratos están desplegados y son públicos). Hoy no hay SDK ni librería cliente publicada. La API de comercio agéntico (hoja de ruta) será la superficie para acceso programático. Siguiente: [API de comercio agéntico](/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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.lid.pro/es/developers/smart-contracts.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.