API de Trustless Work

¿Qué es la API de Trustless Work?

El API REST de Trustless Work es una interfaz para desarrolladores para crear y gestionar contratos de escrow descentralizados en la blockchain Stellar usando contratos inteligentes Soroban. Simplifica el ciclo de vida del escrow e se integra sin problemas en cualquier plataforma que necesite pagos condicionales o liberación de fondos minimizada en confianza.


🚀 Capacidades principales

  • Desplegar escrows inteligentes: Inicializar contratos inteligentes con roles, hitos y condiciones definidos.

  • Financiar escrows: Bloquear fondos en cuentas de escrow con activos nativos de Stellar (p. ej., USDC).

  • Actualizar y aprobar hitos: Colaborar en el seguimiento del progreso y la verificación de entregas.

  • Gestión de disputas: Elevar o resolver disputas de forma programática.

  • Liberar fondos: Liberar las cantidades en escrow solo cuando se cumplan las condiciones predefinidas.

  • Seguimiento de estado en tiempo real: Consultar el estado del escrow, los hitos y los saldos.

  • Compatibilidad entre cadenas: Soporte de USDC a través del protocolo de transferencia entre cadenas de Circle.


🧩 Tipos de escrow

  1. Escrow de liberación única

    • Liberación de fondos única tras la aprobación de un hito o la resolución de una disputa.

    • Roles: Proveedor de servicio, Aprobador, Receptor, Resolutor de disputas.

  2. Escrow de liberaciones múltiples

    • Pagos múltiples basados en hitos.

    • Cada hito se aprueba y libera de forma independiente.


📘 Endpoints clave de la API (agrupados)

🔨 Despliegue

  • /deployer/single-release

  • /deployer/multi-release

💸 Financiación

  • /escrow/{type}/fund-escrow

✅ Gestión de hitos

  • /escrow/{type}/approve-milestone

  • /escrow/{type}/change-milestone-status

🏁 Finalización

  • /escrow/{type}/release-funds (único)

  • /escrow/{type}/release-milestone-funds (múltiple)

⚠️ Disputas

  • /escrow/{type}/dispute-escrow

  • /escrow/{type}/resolve-dispute

  • /escrow/{type}/dispute-milestone (múltiple)

  • /escrow/{type}/resolve-milestone-dispute (múltiple)

🔄 Actualizaciones de escrow

  • /escrow/{type}/update-escrow

📊 Consulta / Seguimiento

  • /escrow/get-multiple-escrow-balance

  • /helper/get-escrows-by-signer

  • /helper/get-escrows-by-role


🧰 Utilidades auxiliares

  • /helper/set-trustline: Establecer trustline para recibir tokens específicos como USDC.

  • /helper/send-transaction: Enviar transacciones XDR firmadas a Stellar.

  • /helper/get-multiple-escrow-balance: Consulta por lotes de saldos de escrow.


🛡️ Seguridad y restricciones

  • Transacciones sin firmar: Todas las operaciones devuelven XDRs sin firmar que requieren firma en el lado del cliente.

  • Permisos basados en roles: Acciones específicas (p. ej., aprobar, disputar) requieren el rol correcto.

  • Límites de tasa: 50 solicitudes/minuto por cliente.

  • Modelo de tarifas: Se aplica una tarifa del 0,3% en mainnet por Trustless Work, y las plataformas pueden añadir su propia tarifa.


🎯 Casos de uso

  • Plataformas de freelance

  • Comercio electrónico de alto valor

  • Facturación SaaS

  • Bienes raíces transfronterizos

  • Servicios legales y profesionales

  • Crowdfunding y subvenciones

  • Depósitos de seguridad


📌 Recursos para desarrolladores

Mapa de desarrollo: https://www.trustlesswork.com/developers

Última actualización

¿Te fue útil?