Propriedades do Escrow

Um escrow é apenas dados estruturados — um corpo JSON que define como os fundos são mantidos, liberados e rastreados. Cada propriedade diz ao contrato quem faz o quê, quando os fundos se movem e sob quais condições.

Resumo:

• Liberação Única → todos os marcos devem ser aprovados para um único pagamento.

• Liberação Múltipla → cada marco desbloqueia seu próprio pagamento.

Abaixo detalhamos as propriedades principais de cada escrow, e então destacamos as diferenças entre Liberação Única e Liberação Múltipla.

Escrow de Liberação Única

Estrutura Principal

• ID do Escrow O identificador on-chain do contrato (também o endereço de depósito). É para onde os fundos são realmente enviados e bloqueados.

• ID e Título do Envolvimento Strings configuráveis que ajudam a identificar o escrow no seu próprio sistema — por exemplo, vinculando-o a uma fatura, ID de projeto ou pedido do marketplace.

• Descrição Explicação legível por humanos sobre o propósito do escrow. Útil para contexto em painéis, auditorias ou resolução de disputas.

• Papéis Cada escrow define quem pode agir sobre ele:

  • Aprovador → valida a conclusão do marco

  • Prestador de Serviço → entrega o trabalho

  • Endereço da Plataforma → a própria plataforma, capaz de cobrar taxas ou ajustar a configuração antes do financiamento

  • Assinante de Liberação → executa a liberação dos fundos

  • Resolvedor de Disputas → arbitra conflitos, pode redirecionar fundos

  • Recebedor → destino final dos fundos 👉 Veja Papéis para detalhes completos.

• Valor & Taxa da Plataforma

  • Liberação Única: o total valor a ser pago quando as condições forem atendidas, mais uma taxaDaPlataforma opcional percentagem enviada para a plataforma.

  • Liberação Múltipla: o valor total é distribuído entre os marcos (cada marco define seu próprio valor). A taxa da plataforma ainda se aplica globalmente.

• Trustline Define o token utilizado. É assim que os escrows Stellar sabem qual ativo aceitar. Tipicamente USDC, mas qualquer token emitido na Stellar é suportado.

• Flags Marcadores de estado internos que descrevem o que está acontecendo:

  • em disputa → uma parte abriu uma disputa

  • liberado → os fundos já foram liberados

  • resolvido → uma disputa foi resolvida

  • aprovado (Apenas Liberação Múltipla) → o marco foi aprovado pelo aprovador

---

Marcos

Os marcos definem o que deve ser concluído para desbloquear fundos.

• Escrow de Liberação Única

  • Você pode definir um ou muitos marcos, mas a liberação é tudo ou nada.

  • Os fundos só são liberados quando todos os marcos são aprovados.

  • Cada marco acompanha:

    • descrição → o que está sendo entregue

    • status → qualquer tipo de status

    • aprovar → verdadeiro ou falso

    • evidência (opcional) → prova de entrega

• Escrow de Liberação Múltipla

  • Cada marco tem as mesmas propriedades da liberação única, além de seu próprio valor e flags.

  • Quando um marco é aprovado, seus fundos podem ser liberados sem esperar pelos outros.

  • Os marcos incluem:

    • valor → quanto é desbloqueado mediante aprovação

    • descrição → o que está sendo entregue

    • status → qualquer tipo de status

    • flags → liberado, em disputa, resolvido e aprovado

    • recebedor → destino final dos fundos

Essa estrutura permite que um projeto financie e libere em fases, e não tudo de uma vez.

---

Juntando Tudo

• Liberação Única = um pagamento, acionado quando todos os marcos são aprovados. Valor + flags de liberação e disputa vivem no nível superior do escrow.

• Liberação Múltipla = pagamentos múltiplos, cada marco tem seu próprio valor e flags. O valor total colocado em escrow é distribuído entre os marcos.

Ambos compartilham a mesma estrutura principal — IDs, papéis, descrição, trustline e taxa da plataforma. A diferença é:

• Liberação Única → os marcos são “pontos de verificação” para uma grande liberação.

• Liberação Múltipla → os marcos são “tranches”, cada um vinculado à sua própria liberação.

---

🚀 Próximos Passos

• Escolha Tipo de Escrow

• Atribua Papéis

• Siga Fases do Ciclo de Vida

• Teste configurações em implante no dApp