🚀Início Rápido para Desenvolvedores
Este guia é seu recurso completo para integrar, implantar e estender o Trustless Work. Seja você um desenvolvedor, uma equipe de produto ou estiver criando um agente de IA — esta página oferece tudo.
Olá! Esta página está otimizada para ser exportada e carregada no seu Agente de IA de preferência! você também pode usar o nosso na Barra de Pesquisa!
🚀 O que é Trustless Work?
Trustless Work é uma plataforma de Escrow-como-Serviço (EaaS) projetada para a economia de stablecoins. Ela permite manter fundos com segurança em contratos inteligentes não custodiais até que os marcos sejam concluídos e aprovados.
Use para:
Bloquear fundos com lógica programável de marcos
Permitir liberações transparentes de fundos para serviços, bolsas, aluguéis, etc.
Automatizar fluxos de fundos usando funções baseadas em signatários
🧪 Início rápido — Implemente seu primeiro Escrow
▶ Experimente o Demo — Nenhum código necessário
Pré-requisitos
Freighter carteira
USDC de testnet + XLM (Obter tokens de teste)
Passo a passo
Abra o app demo
Preencha os detalhes do escrow (papéis, marcos)
Clique em deploy → assine a transação
Envie USDC de teste para o endereço do contrato escrow
Marque, aprove e libere marcos a partir da interface
✍️ 2. Projete o ciclo de vida do seu Escrow
Antes de implantar, defina:
Quem pode marcar marcos como concluídos
Quem deve aprovar o trabalho
Quem pode liberar fundos
Quem pode resolver disputas
→ Papéis & Permissões do Escrow
📬 Visão geral da API
Obtenha sua chave de API em nosso dApp: Solicitar Chave de API
A API Trustless Work é sua porta de entrada para implantar e gerenciar escrows descentralizados na blockchain Stellar usando contratos inteligentes Soroban. Todas as interações retornam XDRs não assinados, que devem ser assinados no cliente usando a carteira associada ao papel correto.
📘 URL base: https://api.trustlesswork.com
🔨 Implantação
POST
/deployer/single-release
Implanta um escrow de liberação única
POST
/deployer/multi-release
Implanta um escrow de múltiplas liberações
💸 Financiamento
POST
/escrow/{type}/fund-escrow
Retorna XDR para financiar um escrow
✅ Gerenciamento de Marcos
POST
/escrow/{type}/approve-milestone
Aprovar um marco
POST
/escrow/{type}/change-milestone-status
Marcar um marco como completo/incompleto
🏁 Finalização
POST
/escrow/{type}/release-funds
Liberar todos os fundos (único)
POST
/escrow/{type}/release-milestone-funds
Liberar um marco (multiplos)
⚠️ Disputas
POST
/escrow/{type}/dispute-escrow
Abrir uma disputa em um escrow único
POST
/escrow/{type}/resolve-dispute
Resolver disputa de escrow de liberação única
POST
/escrow/{type}/dispute-milestone
Abrir disputa em um marco
POST
/escrow/{type}/resolve-milestone-dispute
Resolver disputa de marco (multi)
🔄 Atualizações do Escrow
POST
/escrow/{type}/update-escrow
Atualizar metadados/configuração do escrow
📊 Consulta & Rastreamento
GET
/escrow/get-multiple-escrow-balance
Saldos em lote para vários escrows
GET
/helper/get-escrows-by-signer
Consultar escrows associados a um signatário
GET
/helper/get-escrows-by-role
Consultar escrows por atribuição de papel
🧰 Utilitários Auxiliares
POST
/helper/set-trustline
Permitir que a carteira do escrow aceite um token
POST
/helper/send-transaction
Enviar XDR assinado para a Stellar
📌 Para documentação completa do Swagger, visite: https://dev.api.trustlesswork.com/docs
Todas as ações de escrita devem ser assinadas pela carteira que detém o papel correspondente no escrow (marcador, aprovador, liberador, resolvedor).
🧠 Integração com SDK React
npm i @trustless-work/escrow
Configuração do Provider
import {
TrustlessWorkConfig,
development, // ou mainNet
} from "@trustless-work/escrow";
export function TrustlessWorkProvider({ children }) {
const apiKey = process.env.NEXT_PUBLIC_API_KEY || "";
return (
<TrustlessWorkConfig baseURL={development} apiKey={apiKey}>
{children}
</TrustlessWorkConfig>
);
}
Envolva seu app:
export default function RootLayout({ children }) {
return (
<html lang="en">
<body>
<TrustlessWorkProvider>
{children}
</TrustlessWorkProvider>
</body>
</html>
);
}
Uma vez envolvido, você pode usar os hooks e funções de mutação do SDK de escrow em todo o seu app.
🔑 Carteiras & Passkeys
Cada papel (marcador, aprovador, liberador, etc.) precisa de uma carteira compatível com Stellar-Soroban.
Carteiras suportadas:
Carteiras com Passkey (biométrica, baseada em contrato)
🔁 Ciclo de Vida do Escrow Explicado
Iniciação – Definir papéis, ativo e marcos
Financiamento – Depositar stablecoins (USDC) no contrato
Marco Marcado – O prestador marca o progresso
Aprovação – Cliente ou aprovador confirma
Liberação – Fundos são liberados
Disputa – Opcional: o resolvedor intervém
Cada ação requer assinatura do endereço de carteira designado.
🧩 Papéis & Permissões
Marcador
Marca marcos como concluídos
Aprovador
Aprova a conclusão do marco
Liberador
Assina a liberação final dos fundos
Resolvedor
Pode sobrescrever o fluxo em caso de disputa
Recebedor
Recebe os fundos liberados
Endereço da Plataforma
Recebe uma taxa (opcional, % de cada liberação)
📐 Referência do Esquema do Escrow (para agentes & devs)
Campos Compartilhados
engagementId
string
Identificador único para o escrow
title
string
Nome do escrow
description
string
Descrição da função do escrow
roles
object
Atribuições de papéis: marcador, aprovador, etc.
platformFee
number
% de taxa para a plataforma
trustline
object
Tipo de token (ex.: USDC, XLM) e decimais
Objeto Milestone (apenas para multi-release)
description
string
O que o marco representa
status
string
Status: approved, in_dispute, etc.
amount
number
Valor liberado mediante aprovação
evidence
string
(Opcional) Prova de suporte
flags
object
Inclui disputed, resolved, approved
Objeto Trustline
address
string
Emissor do token ou endereço
🛠 Ferramentas & Links para Desenvolvedores
🤝 Junte-se ao Ecossistema
🧵 Twitter/X: @trustlesswork
🌐 Hub de Docs: docs.trustlesswork.com
Construído para a economia de stablecoins. Open-source. Focado em desenvolvedores.
Conte-nos o que você está construindo!
Atualizado
Isto foi útil?