🚀Inicio rápido para desarrolladores
Esta guía es tu recurso todo en uno para integrar, desplegar y ampliar Trustless Work. Ya seas desarrollador, equipo de producto o estés iniciando un agente de IA, esta página te da todo.
¡Hola! ¡Esta página está optimizada para ser exportada y cargada en el agente de IA que elijas! ¡también puedes usar el nuestro en la barra de búsqueda!
🚀 ¿Qué es Trustless Work?
Trustless Work es una plataforma Escrow-as-a-Service (EaaS) diseñada para la economía de stablecoins. Te permite mantener fondos de forma segura en contratos inteligentes no custodiados hasta que se completen y aprueben los hitos.
Úsalo para:
Bloquear fondos con lógica programable de hitos
Permitir liberaciones de fondos transparentes para servicios, subvenciones, alquileres, etc.
Automatizar flujos de fondos usando roles basados en firmantes
🧪 Inicio rápido — Despliega tu primer escrow
▶ Probar la demostración — No se requiere código
Requisitos previos
Freighter billetera
USDC de testnet + XLM (Obtener tokens de prueba)
Paso a paso
Abre el app de demostración
Completa los detalles del escrow (roles, hitos)
Haz clic en desplegar → firma la transacción
Envía USDC de testnet al address del contrato de escrow
Marca, aprueba y libera hitos desde la interfaz
✍️ 2. Diseña el ciclo de vida de tu escrow
Antes de desplegar, define:
Quién puede marcar hitos como completados
Quién debe aprobar el trabajo
Quién puede liberar fondos
Quién puede resolver disputas
📬 Resumen de la API
Obtén tu clave API en nuestra dApp: Solicitar clave API
La API de Trustless Work es tu puerta para desplegar y gestionar escrows descentralizados en la blockchain Stellar usando contratos inteligentes Soroban. Todas las interacciones devuelven XDR sin firmar, que deben ser firmados en el cliente usando la billetera asociada con el rol correspondiente.
📘 URL base: https://api.trustlesswork.com
🔨 Despliegue
POST
/deployer/single-release
Despliega un escrow de liberación única
POST
/deployer/multi-release
Despliega un escrow de liberaciones múltiples
💸 Financiamiento
POST
/escrow/{type}/fund-escrow
Devuelve XDR para financiar un escrow
✅ Manejo de hitos
POST
/escrow/{type}/approve-milestone
Aprobar un hito
POST
/escrow/{type}/change-milestone-status
Marcar un hito como completo/incompleto
🏁 Finalización
POST
/escrow/{type}/release-funds
Liberar todos los fondos (único)
POST
/escrow/{type}/release-milestone-funds
Liberar un hito (múltiple)
⚠️ Disputas
POST
/escrow/{type}/dispute-escrow
Iniciar una disputa en un escrow único
POST
/escrow/{type}/resolve-dispute
Resolver una disputa de escrow de liberación única
POST
/escrow/{type}/dispute-milestone
Iniciar disputa sobre un hito
POST
/escrow/{type}/resolve-milestone-dispute
Resolver disputa de hito (múltiple)
🔄 Actualizaciones del escrow
POST
/escrow/{type}/update-escrow
Actualizar metadatos/configuración del escrow
📊 Consultas y seguimiento
GET
/escrow/get-multiple-escrow-balance
Saldos por lotes para muchos escrows
GET
/helper/get-escrows-by-signer
Consultar escrows asociados con un firmante
GET
/helper/get-escrows-by-role
Consultar escrows por asignación de rol
🧰 Utilidades auxiliares
POST
/helper/set-trustline
Permitir a la billetera del escrow aceptar un token
POST
/helper/send-transaction
Enviar XDR firmado a Stellar
📌 Para la documentación completa de Swagger, visita: https://dev.api.trustlesswork.com/docs
Todas las acciones de escritura deben ser firmadas por la billetera que tenga el rol correspondiente del escrow (marker, approver, releaser, resolver).
🧠 Integración del SDK de React
npm i @trustless-work/escrow
Configuración del proveedor
importar {
TrustlessWorkConfig,
development, // o mainNet
} desde "@trustless-work/escrow";
exportar función TrustlessWorkProvider({ children }) {
const apiKey = process.env.NEXT_PUBLIC_API_KEY || "";
return (
<TrustlessWorkConfig baseURL={development} apiKey={apiKey}>
{children}
</TrustlessWorkConfig>
);
}
Envuelve tu app:
export default function RootLayout({ children }) {
return (
<html lang="en">
<body>
<TrustlessWorkProvider>
{children}
</TrustlessWorkProvider>
</body>
</html>
);
}
Una vez envuelta, puedes usar los hooks y funciones de mutación del SDK de escrow en toda tu aplicación.
🔑 Billeteras y passkeys
Cada rol (marker, approver, releaser, etc.) necesita una billetera compatible con Stellar-Soroban.
Billeteras compatibilizadas:
Billeteras Passkey (biométricas, basadas en contratos)
🔁 Ciclo de vida del escrow explicado
Iniciación – Definir roles, activo y hitos
Financiamiento – Depositar stablecoins (USDC) en el contrato
Hito marcado – El proveedor marca el progreso
Aprobación – El cliente o aprobador da su conformidad
Liberación – Se liberan los fondos
Disputa – Opcional: interviene el resolver
Cada acción requiere la firma de la dirección de billetera asignada.
🧩 Roles y permisos
Marker
Marca hitos como completados
Approver
Aprueba la finalización de hitos
Releaser
Firma la liberación final de fondos
Resolver
Puede anular el flujo en caso de disputa
Receiver
Recibe los fondos liberados
Dirección de la plataforma
Recibe una comisión (opcional, % de cada liberación)
📐 Referencia del esquema de escrow (para agentes y desarrolladores)
Campos compartidos
engagementId
string
Identificador único para el escrow
title
string
Nombre del escrow
description
string
Descripción de la función del escrow
roles
object
Asignaciones de roles: marker, approver, etc.
platformFee
number
% de comisión para la plataforma
trustline
object
Tipo de token (p. ej., USDC, XLM) y decimales
Objeto Hito (solo para multi-release)
description
string
Lo que representa el hito
status
string
Estado: approved, in_dispute, etc.
amount
number
Cantidad liberada tras la aprobación
evidence
string
(Opcional) Prueba de soporte
flags
object
Incluye disputed, resolved, approved
Objeto Trustline
address
string
Emisor del token o dirección
🛠 Herramientas y enlaces para desarrolladores
🤝 Únete al ecosistema
🧵 Twitter/X: @trustlesswork
🌐 Centro de documentación: docs.trustlesswork.com
Construido para la economía de stablecoins. Código abierto. Enfoque en desarrolladores.
¡Cuéntanos qué estás construyendo!
Última actualización
¿Te fue útil?