Social

Bug Reports

Submit bug reports for verification and airdrop points. Max 5 reports per day. Admin wallets can review, verify, and block spammers.

POST

/api/v1/bugs/reports

Submit a bug report. Blocked wallets get 403. Two-stage duplicate detection: title-only Jaccard ≥85% OR combined title+description Jaccard ≥90% against pending/verified/duplicate-flagged reports in the same category from the last 30 days. Date patterns are stripped before tokenization.

Auth: Session or API Key

Response

{
  "title": "Button doesn't work on mobile",
  "description": "Steps to reproduce...",
  "severity": "medium",
  "category": "frontend",
  "evidence": "screenshot URL (optional)"
}

409 Duplicate Response

Response

{
  "error": "A very similar report already exists.",
  "duplicate": {
    "id": 42,
    "title": "Button doesn't work on mobile",
    "status": "pending",
    "createdAt": "2026-04-18T14:22:00.000Z",
    "similarity": 0.947,
    "matchedOn": "title"
  }
}

201 Submitted403 Wallet blocked409 Duplicate (≥90% match)429 Daily limit (5/day)

GET

/api/v1/bugs/reports

List your reports. Admins can filter by wallet or see all.

Auth: Session or API Key

Response

{
  "data": [{
    "id": 1,
    "wallet": "0x...",
    "title": "Button doesn't work on mobile",
    "description": "Steps to reproduce...",
    "severity": "medium",
    "category": "frontend",
    "evidence": "https://...",
    "status": "pending",
    "createdAt": "2026-03-21T00:00:00.000Z",
    "verifiedAt": null
  }],
  "pagination": { "total": 3, "page": 1, "limit": 20, "hasMore": false }
}

PATCH

/api/v1/bugs/reports/{id}

Admin only: update status and severity.

Auth: Admin wallet required

Admin Endpoints

POST

/api/v1/admin/block

Block a wallet from submitting reports.

Auth: Admin wallet required

DELETE

/api/v1/admin/block

Unblock a wallet.

Auth: Admin wallet required