Introdução

Como começar na API REST do Trustless Work

O que é a Trustless Work API?

O Trustless Work REST API permite que você crie e gerencie contratos de custódia descentralizados em Stellar usando Soroban smart contracts.

Use-o para implantar custódias, financiá-las, acompanhar marcos e liberar fundos.

URLs base

Mainnet

URL Base (Mainnet)

https://api.trustlesswork.com

Testnet

Capacidades principais

• Implantar custódias com papéis, marcos e condições.

• Financiar custódias usando ativos Stellar (exemplo: USDC).

• Aprovar / atualizar marcos para acionar liberações.

• Fluxos de disputa e resolução (no nível da custódia ou do marco).

• Liberar fundos apenas quando as condições forem atendidas.

• Consultar status de custódias, marcos e saldos.

Tipos de custódia

1. Custódia com liberação única

   • Uma ação de liberação para o valor total.

2. Custódia com múltiplas liberações

   • Pagamentos por múltiplos marcos.

   • Cada marco pode ser aprovado, contestado e liberado independentemente.

Limites de taxa

Limite: 50 solicitações a cada 60 segundos por cliente.

Transações, assinatura e permissões

A maioria dos endpoints de escrita retorna XDR não assinado. Você deve assinar no lado do cliente com a carteira do papel correto.

As ações são restritas por papel (aprovar, contestar, resolver, liberar).

Mapa de endpoints (visão geral)

Use o Swagger para a especificação completa. Esses grupos cobrem a maioria das integrações:

Implantação

• /deployer/single-release

• /deployer/multi-release

Financiamento

• /escrow/{type}/fund-escrow

Marcos

• /escrow/{type}/approve-milestone

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

Liberação

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

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

Disputas

• /escrow/{type}/dispute-escrow

• /escrow/{type}/resolve-dispute

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

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

Atualizações

• /escrow/{type}/update-escrow

Consulta / auxiliares

• /escrow/get-multiple-escrow-balance

• /helper/get-escrows-by-signer

• /helper/get-escrows-by-role

• /helper/set-trustline

• /helper/send-transaction

Taxas

A Mainnet cobra uma taxa de protocolo de 0,3%.

Documentação da API (Swagger)

Mainnet

Trustless Work API Documentationapi.trustlesswork.com

Testnet

Recursos para desenvolvedores

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

Repositório no GitHub

Trustless WorkGitHub