API Trustless Work

O que é a Trustless Work API?

O Trustless Work REST API é uma interface para desenvolvedores criar e gerenciar contratos de garantia descentralizados na blockchain Stellar usando contratos inteligentes Soroban. Ele simplifica o ciclo de vida do escrow e se integra perfeitamente a qualquer plataforma que precise de pagamentos condicionais ou liberação de fundos com minimização de confiança.

---

🚀 Capacidades Principais

• Implantar Escrows Inteligentes: Inicializar contratos inteligentes com papéis, marcos e condições definidos.

• Financiar Escrows: Bloquear fundos em contas de escrow com ativos nativos do Stellar (por exemplo, USDC).

• Atualizar & Aprovar Marcos: Colaborar no acompanhamento de progresso e verificação de entrega.

• Manipulação de Disputas: Levantar ou resolver disputas programaticamente.

• Liberar Fundos: Liberar valores em escrow somente quando condições predefinidas forem cumpridas.

• Acompanhamento de Status em Tempo Real: Consultar status do escrow, marcos e saldos.

• Compatibilidade Cross-Chain: Suporte a USDC via protocolo de transferência cross-chain da Circle.

---

🧩 Tipos de Escrow

1. Escrow de Liberação Única

   • Liberação única de fundos após aprovação do marco ou resolução da disputa.

   • Papéis: Prestador de Serviço, Aprovador, Recebedor, Resolvedor de Disputas.

2. Escrow de Múltiplas Liberações

   • Pagamentos múltiplos baseados em marcos.

   • Cada marco é aprovado e liberado de forma independente.

---

📘 Endpoints Principais da API (Agrupados)

🔨 Implantação

• /deployer/single-release

• /deployer/multi-release

💸 Financiamento

• /escrow/{type}/fund-escrow

✅ Manipulação de Marcos

• /escrow/{type}/approve-milestone

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

🏁 Finalização

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

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

⚠️ Disputas

• /escrow/{type}/dispute-escrow

• /escrow/{type}/resolve-dispute

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

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

🔄 Atualizações de Escrow

• /escrow/{type}/update-escrow

📊 Consultas / Acompanhamento

• /escrow/get-multiple-escrow-balance

• /helper/get-escrows-by-signer

• /helper/get-escrows-by-role

---

🧰 Utilitários Auxiliares

• /helper/set-trustline: Definir trustline para receber tokens específicos como USDC.

• /helper/send-transaction: Enviar transações XDR assinadas para o Stellar.

• /helper/get-multiple-escrow-balance: Consulta em lote de saldos de escrow.

---

🛡️ Segurança & Restrições

• Transações Não Assinadas: Todas as operações retornam XDRs não assinados que exigem assinatura no lado do cliente.

• Permissões Baseadas em Papéis: Ações específicas (por exemplo, aprovar, disputar) exigem o papel correto.

• Limites de Taxa: 50 requisições/minuto por cliente.

• Modelo de Taxas: Uma taxa de 0,3% na mainnet é cobrada pela Trustless Work, com plataformas podendo adicionar sua própria taxa.

---

🎯 Casos de Uso

• Plataformas de freelancers

• E-commerce de alto valor

• Cobrança SaaS

• Imobiliária transfronteiriça

• Serviços jurídicos & profissionais

• Crowdfunding e subsídios

• Depósitos de segurança

---

📌 Recursos para Desenvolvedores

Mapa do Dev: https://www.trustlesswork.com/developers

• Swagger: https://dev.api.trustlesswork.com/docs

• GitHub: https://github.com/Trustless-Work