Propriedades da Caução

Uma caução é 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.

TL;DR:

  • 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 todo 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 você a identificar o escrow em seu próprio sistema — por exemplo, vinculando-o a uma fatura, ID de projeto ou pedido do marketplace.

  • Descrição Explicação em linguagem humana do 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

    • Resolutor de Disputas → arbitra conflitos, pode redirecionar fundos

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

  • Valor e Taxa da Plataforma

    • Liberação Única: o total valor a ser pago quando as condições forem atendidas, mais uma opcional taxaDaPlataforma percentual enviado 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 usado (endereço e decimais). É 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 (Somente 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 vários marcos, mas a liberação é tudo ou nada.

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

    • Cada marco registra:

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

      • status → pendente, aprovado, em disputa, etc.

      • evidência (opcional) → prova de entrega

      • flagAprovado → verdadeiro quando o aprovador aprova

  • 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

      • flags → liberado, em disputa, resolvido

      • Receptor → destino final dos fundos

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

Colocando Tudo Junto

  • 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 = múltiplos pagamentos, cada marco tem seu próprio valor e flags. O valor total 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

AnteriorPapéis em Trabalho TrustlessPróximoTipos de Caução

Atualizado

Isto foi útil?