Skip to main content

Disputes

If a score seems incorrect, users can submit disputes for review.

Submit a Dispute​

POST /api/v1/dispute
Content-Type: application/json

{
  "walletAddress": "0x1234...",
  "category": "DEFI_LENDING",
  "reason": "IncorrectData",
  "description": "My Aave v3 positions on Arbitrum are not being counted."
}

Dispute Reasons​

InaccurateScore, MissingActivity, IncorrectCategory, DataOutdated, WrongWallet, FraudulentData, ComplianceError, Other

Dispute Lifecycle​

Pending → Under Review → Evidence Requested → Resolved / Rejected
                                              ↓
                                          Escalated (on-chain governance)

Escalate to Governance​

If you disagree with a resolution, escalate to on-chain governance:

POST /api/v1/dispute/{id}/escalate
Content-Type: application/json

{"reason": "Unresolved after 14 days"}

Escalated disputes are reviewed by GOVERNANCE_ROLE holders and resolved on-chain via the ReputationOracle contract.

Withdraw a Dispute​

POST /api/v1/dispute/{id}/withdraw
Content-Type: application/json

{"walletAddress": "0x1234..."}