Propiedades del escrow

Un escrow es solo datos estructurados: un cuerpo JSON que define cómo se retienen, liberan y rastrean los fondos. Cada propiedad le indica al contrato quién hace qué, cuándo se mueven los fondos y bajo qué condiciones.

TLDR:

• Single-Release → todos los hitos deben ser aprobados para un único pago.

• Multi-Release → cada hito desbloquea su propio pago.

A continuación desglosamos el propiedades principales de cada escrow, y luego destacamos las diferencias entre Single-Release y Multi-Release.

Escrow de Single Release

Estructura básica

• ID del escrow El identificador en cadena del contrato (también la dirección de depósito). Aquí es donde los fondos se envían y se bloquean realmente.

• ID y título del compromiso Cadenas configurables que te ayudan a identificar el escrow en tu propio sistema — por ejemplo, vinculándolo a una factura, ID de proyecto o pedido del mercado.

• Descripción Explicación legible por humanos del propósito del escrow. Útil para contexto en paneles, auditorías o resolución de disputas.

• Roles Cada escrow define quién puede actuar sobre él:

  • Aprobador → valida la finalización del hito

  • Proveedor de servicios → entrega el trabajo

  • Dirección de la plataforma → la propia plataforma, capaz de cobrar tarifas o ajustar la configuración antes del financiamiento

  • Firmante de liberación → ejecuta la liberación de fondos

  • Resolutor de disputas → arbitra conflictos, puede redirigir fondos

  • Receptor → destino final de los fondos 👉 Consulta Roles para más detalle.

• Monto y tarifa de la plataforma

  • Single-Release: el total monto a pagar una vez que se cumplan las condiciones, más una platformFee porcentaje enviado a la plataforma.

  • Multi-Release: el monto total se distribuye entre los hitos (cada hito define su propio monto). La tarifa de la plataforma sigue aplicándose globalmente.

• Trustline Define el token que se utiliza. Así es como los escrows de Stellar saben qué activo aceptar. Normalmente USDC, pero se admite cualquier token emitido en Stellar.

• Banderas Marcadores de estado internos que describen lo que está sucediendo:

  • en disputa → una parte levantó una disputa

  • liberado → los fondos ya han sido liberados

  • resuelto → una disputa ha sido resuelta

  • aprobado (Solo Multi-Release) → el hito ha sido aprobado por el aprobador

---

Hitos

Los hitos definen lo que debe completarse para desbloquear fondos.

• Escrow de Single-Release

  • Puedes definir uno o muchos hitos, pero la liberación es todo o nada.

  • Los fondos solo se liberan una vez que todos los hitos están aprobados.

  • Cada hito registra:

    • descripción → lo que se entrega

    • estado → cualquier tipo de estado

    • aprobar → verdadero o falso

    • evidencia (opcional) → prueba de entrega

• Escrow de Multi-Release

  • Cada hito tiene las mismas propiedades que el single release, además de su propio monto y banderas.

  • Cuando un hito es aprobado, sus fondos pueden liberarse sin esperar a los demás.

  • Los hitos incluyen:

    • monto → cuánto se desbloquea al aprobarse

    • descripción → lo que se entrega

    • estado → cualquier tipo de estado

    • banderas → liberado, en disputa, resuelto y aprobado

    • receptor → destino final de los fondos

Esta estructura permite a un proyecto financiar y liberar en fases, no todo de una vez.

---

Uniéndolo todo

• Single-Release = un pago, desencadenado cuando todos los hitos están aprobados. El monto + las banderas de liberación y disputa residen en el nivel superior del escrow.

• Multi-Release = pagos múltiples, cada hito tiene su propio monto y banderas. El monto total en escrow se distribuye entre los hitos.

Ambos comparten la misma estructura principal — IDs, roles, descripción, trustline y tarifa de la plataforma. La diferencia es:

• Single-Release → los hitos son “puntos de control” para una gran liberación.

• Multi-Release → los hitos son “tramos,” cada uno ligado a su propia liberación.

---

🚀 Próximos pasos

• Elige Tipo de escrow

• Asigna Roles

• Sigue Fases del ciclo de vida

• Prueba configuraciones en despliega en dApp