Introducción

Cómo empezar con la API REST de Trustless Work

¿Qué es la API de Trustless Work?

El API REST de Trustless Work te permite crear y gestionar contratos de escrow descentralizados en Stellar usando Soroban contratos inteligentes.

Úsala para desplegar escrows, financiarlos, seguir hitos y liberar fondos.

URLs base

Mainnet

URL base (Mainnet)

https://api.trustlesswork.com

Testnet

Capacidades principales

• Desplegar escrows con roles, hitos y condiciones.

• Financiar escrows usando activos de Stellar (ejemplo: USDC).

• Aprobar / actualizar hitos para impulsar liberaciones.

• Disputa y resolución flujos (a nivel de escrow o a nivel de hito).

• Liberar fondos solo cuando se cumplan las condiciones.

• Consultar estado de escrows, hitos y saldos.

Tipos de escrow

1. Escrow de liberación única

   • Una acción de liberación por el monto total.

2. Escrow de liberaciones múltiples

   • Pagos múltiples por hitos.

   • Cada hito puede ser aprobado, disputado y liberado de forma independiente.

Límites de tasa

Límite: 50 solicitudes por 60 segundos por cliente.

Transacciones, firma y permisos

La mayoría de los endpoints de escritura devuelven XDR no firmado. Debes firmar del lado del cliente con la cartera del rol correcto.

Las acciones son restringidas por rol (aprobar, disputar, resolver, liberar).

Mapa de endpoints (alto nivel)

Usa Swagger para la especificación completa. Estos grupos cubren la mayoría de las integraciones:

Despliegue

• /deployer/single-release

• /deployer/multi-release

Financiación

• /escrow/{type}/fund-escrow

Hitos

• /escrow/{type}/approve-milestone

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

Liberació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

• /escrow/{type}/update-escrow

Consultas / helpers

• /escrow/get-multiple-escrow-balance

• /helper/get-escrows-by-signer

• /helper/get-escrows-by-role

• /helper/set-trustline

• /helper/send-transaction

Tarifas

Mainnet cobra una tarifa de protocolo del 0.3%.

Documentación de la API (Swagger)

Mainnet

Trustless Work API Documentationapi.trustlesswork.com

Testnet

Recursos para desarrolladores

• Mapa para desarrolladores: https://www.trustlesswork.com/developers

Repositorio de GitHub

Trustless WorkGitHub