Saltar al contenido principal
Los contratos de V2 gestionan ahora correctamente los tokens que no tienen 18 decimales (USDC = 6 decimales, USDT = 6 decimales). El documento de la política de disputa General Escrow se finalizó y se subió a IPFS (marzo de 2026).

Estructuras de datos principales

Estructura Transaction

Enumeración Status

Enumeraciones Party y Resolution


Crear transacciones

Transacción en ETH nativo

Transacción en tokens ERC20

Ambas funciones aplican límites de importe por token mediante el modificador shouldNotExceedCap. Las transacciones que superan el límite se revierten con el error AmountExceedsCap().

Gestionar las transacciones

Funciones de pago

Comportamientos clave:
  • pay() y reimburse() pueden llamarse varias veces con importes parciales
  • Cuando se paga o se reembolsa el importe completo, el estado cambia a TransactionResolved
  • executeTransaction() transfiere todos los fondos restantes al vendedor una vez vencido el plazo
  • Las tres funciones exigen que el estado sea NoDispute; de lo contrario, se revierten con TransactionDisputed()

Sistema de acuerdos

Funciones de acuerdo

Flujo del acuerdo

1

Inicia la propuesta

Cualquiera de las partes propone un importe de acuerdo con proposeSettlement().
2

Cambio de estado

El estado cambia a WaitingSettlementBuyer o WaitingSettlementSeller.
3

Respuesta

La otra parte puede aceptar el acuerdo o proponer una contraoferta.
4

Contraofertas

Las contraofertas reinician lastFeePaymentTime y cambian el estado de espera.
5

Opción de disputa

La parte que no propuso el acuerdo puede abrir una disputa de inmediato pagando la tasa de arbitraje. La parte que lo propuso debe esperar a que transcurra settlementTimeout antes de poder abrir una disputa.
Aceptación del acuerdo: al aceptarse, los fondos se reparten de inmediato. El vendedor recibe el importe de acuerdo propuesto y el comprador, el resto. En los tokens ERC20, la biblioteca SafeERC20 garantiza que ambas transferencias se realicen de forma atómica.

Gestión de las disputas

Funciones de las tasas de arbitraje

Proceso de creación de la disputa

Cálculo de las tasas

Reglas de tiempo límite:
  • Quienes proponen un acuerdo deben esperar settlementTimeout antes de pagar las tasas
  • Si una de las partes no paga dentro de feeTimeout, la otra parte gana por defecto
  • La parte ganadora recibe todos los fondos depositados y el reembolso de su tasa

Funciones de consulta

Consultas de transacciones

Cálculo de los pagos

Lógica de los pagos:

Otras consultas


Funciones del governor

Todas las funciones del governor están restringidas a la dirección del governor actual.

Eventos

Eventos de transacciones

Eventos de gestión


Formato de los metadatos de las transacciones

Las transacciones almacenan los metadatos en la cadena mediante data URI. La estructura JSON de los metadatos:
Para las transacciones de cripto a cripto:

Crear data URI

Pautas para los metadatos:
  • Los metadatos se almacenan directamente en la cadena mediante data URI, lo que elimina las dependencias de IPFS
  • Mantén concisos los metadatos principales, ya que la codificación base64 aumenta el tamaño de la transacción
  • Usa extraDescriptionUri para los adjuntos grandes o los documentos de evidencia