Disputas

Disputas são um mecanismo explícito, conduzido por humanos no Offer Hub.

Elas existem para lidar com casos em que:

• a entrega é contestada,

• a aprovação é retida,

• o cancelamento é solicitado,

• ou evidências devem ser revisadas.

Offer Hub não depende de timeouts ou arbitragem automatizada. Em vez disso, as disputas são resolvidas pelo plataforma do marketplace, atuando como suporte ao cliente, com resultados aplicados por contratos de escrow.

---

Objetivo

Permitir:

• compradores ou vendedores abrirem uma disputa,

• a plataforma revisar evidências e decidir o resultado,

• o escrow aplicar a resolução final (liberação ou reembolso).

---

Atores

• Comprador

• Vendedor

• UI do OfferHub

• Backend do OfferHub (Orquestrador)

• Trustless Work Escrow

• Trustless Work dApp (Backoffice)

• Endereço do Resolvedor de Disputas (controlado pela plataforma)

---

Quando uma Disputa Pode Ser Aberta

Uma disputa pode ser iniciada a qualquer momento após o escrow ser financiado e antes da liberação final.

Cenários típicos incluem:

Disputas Iniciadas pelo Comprador

• O produto nunca chegou

• O serviço não foi entregue conforme acordado

• As evidências de entrega são insuficientes

• O vendedor marcou a entrega prematuramente

Disputas Iniciadas pelo Vendedor

• O comprador está sem resposta

• O comprador se recusa a aprovar apesar da entrega

• O vendedor quer cancelar e reembolsar

• O vendedor tem fortes evidências de cumprimento

Ambas as partes têm o direito de sinalizar a transação, mas nenhuma delas pode resolvê-la por conta própria.

---

Iniciação da Disputa

1. Comprador ou Vendedor Abre uma Disputa

Usuário → UI do OfferHub: Abrir Disputa

Esta ação:

• é iniciada off-chain,

• registra a intenção de contestar,

• ainda não movimenta fundos.

OfferHub captura:

• quem abriu a disputa

• código do motivo

• evidências opcionais (mensagens, arquivos, links)

---

2. O Escrow É Marcado como Disputado

OfferHub → Trustless Work:
  Marcar escrow como Disputado

Uma vez disputado:

• o escrow é congelado,

• nenhuma liberação ou reembolso pode ocorrer automaticamente,

• o controle passa para o papel de Resolvedor de Disputas.

O status do pedido é atualizado para Disputado.

---

Resolução pela Plataforma (Fluxo de Backoffice)

Decisão de Design Importante

O Offer Hub não implementa seu próprio backoffice de disputas.

Em vez disso, ele aproveita o dApp Trustless Work existente, que já suporta:

• inspeção de escrow,

• assinatura baseada em papéis,

• execução de liberação e reembolso.

Isso evita duplicação e garante comportamento consistente.

---

3. A Plataforma Faz Login no dApp Trustless Work

Um operador da plataforma (suporte ao cliente) faz login no dApp Trustless Work usando o endereço do Resolvedor de Disputas / Assinante de Liberação atribuído ao escrow.

📌 Referência:

• Trustless Work dApp (Backoffice)

• Faça login usando a carteira do resolvedor configurada para o marketplace

---

4. A Plataforma Analisa o Caso

Usando:

• evidências fornecidas pelo OfferHub (off-chain)

• estado on-chain do escrow

• histórico de transações

A plataforma decide um dos seguintes resultados:

• Liberar fundos para o vendedor

• Reembolsar fundos ao comprador

---

5. A Plataforma Assina a Resolução

Trustless Work dApp → Escrow:
  Executar Liberação OU Reembolso

Esta ação:

• é assinado pelo endereço do resolvedor/assinante de liberação da plataforma,

• é aplicado on-chain,

• é final.

---

Estado Pós-Resolução

Após a resolução:

• O escrow passa para Liberado ou Reembolsado

• O pedido passa para Fechado

• Os fundos são transferidos de acordo

• Existe um trilho de auditoria completo (on-chain + off-chain)

---

Resultados

• ✅ Disputa registrada

• ✅ Escrow congelado durante a revisão

• ✅ Resolução aplicada on-chain

• ✅ Pedido fechado com resultado final

---

O que os Usuários Veem

Comprador

• Atualizações de status da disputa

• Resultado final (reembolso ou não)

• Explicação clara da plataforma

Vendedor

• Atualizações de status da disputa

• Resultado final (pago ou reembolsado)

• Explicação da decisão da plataforma

---

Modelo de Segurança e Confiança

• Compradores não podem liberar fundos

• Vendedores não podem liberar fundos

• Plataforma podem apenas agir dentro das regras do escrow

• Todas as ações de resolução são assinadas e auditáveis

---

Notas Educacionais

Por Que Ambas as Partes Podem Abrir Disputas

Isto reflete marketplaces reais:

• disputas são sinais, não decisões,

• abrir uma disputa não implica má conduta,

• a resolução é tratada pelo suporte ao cliente.