Oracle & Giải quyết

Tại sao có bề mặt công khai

Thị trường dự đoán chỉ hoạt động nếu nhà giao dịch có thể tự xác minh kết quả. Kết quả giải quyết được đề xuất bởi người kiểm duyệt (hoặc cao hơn) và xác nhận bởi quản trị viên riêng biệt (hoặc siêu quản trị viên). Chúng tôi hiển thị quy trình phán quyết để không có gì trong đó phụ thuộc vào việc tin tưởng SatoriEx.

• Bất kỳ ai cũng có thể liệt kê các thị trường hiện đang trong cửa sổ tranh chấp và đọc người thắng đề xuất.
• Bất kỳ ai cũng có thể liệt kê các thị trường đã đóng nhưng chưa được phán quyết — hữu ích cho các watchdog.
• Bất kỳ ai cũng có thể liệt kê mọi thị trường đã phán quyết và quyết toán trong lịch sử, với kết quả thắng đính kèm.

Endpoint công khai

Ba endpoint GET mang toàn bộ bề mặt minh bạch. Không cần xác thực. Tất cả phân trang với các tham số page và size tiêu chuẩn; kết quả có thể lọc theo danh mục và truy vấn tìm kiếm.

# All three endpoints are public — no auth required.
curl https://staging.satoriex.io/api/v1/oracle/verify?page=1&size=50
curl https://staging.satoriex.io/api/v1/oracle/propose
curl https://staging.satoriex.io/api/v1/oracle/settled?category=politics

Các endpoint này có thể lưu cache có chủ ý. Các dịch vụ watchdog thường thăm dò /verify vài phút một lần trong cửa sổ tranh chấp.

Hình dạng phản hồi

Cả ba endpoint trả về cùng một phong bì — danh sách phân trang của các thị trường, mỗi cái với các kết quả, giá hiện tại, số tranh chấp và thời gian kết thúc tranh chấp. Tên trường khớp với mô hình thị trường cơ bản.

{
  "code": 0,
  "data": {
    "markets": [{
      "id": "mkt_01H...",
      "title": "Will the central bank cut rates in May?",
      "status": "resolved",
      "winning_outcome_id": "out_01H...",
      "resolved_at": "2026-05-08T14:02:31Z",
      "dispute_end_time": "2026-05-09T14:02:31Z",
      "dispute_count": 0,
      "outcomes": [{ "id": "out_01H...", "label": "Yes", "price_bps": 7400 }]
    }],
    "total": 1247,
    "page": 1,
    "size": 50
  }
}

Hành động phán quyết

Đọc oracle là công khai. Hành động trên nó thì không. Endpoint duy nhất thay đổi dữ liệu, POST /oracle/resolve, chấp nhận kết quả thắng và chữ ký HMAC-SHA256 trên tải trọng phán quyết.

POST /api/v1/oracle/resolve
Content-Type: application/json

{
  "market_id":           "mkt_01H...",
  "winning_outcome_id":  "out_01H...",
  "timestamp":           "2026-05-11T14:02:31Z",
  "signature":           "<HMAC-SHA256 over: market_id:winning_outcome_id:unix_ts>"
}

# Signature pre-image uses ':' as delimiter and the unix epoch
# seconds form of timestamp. Requests older than 5 minutes are
# rejected as replay-suspect.

• Yêu cầu bí mật chia sẻ phía máy chủ — không bao giờ hiển thị khóa ký trong code client.
• Chữ ký bao gồm market_id, winning_outcome_id và nonce mới; các lần thử phát lại bị từ chối.
• Chỉ super-admin hoặc oracle webhook đáng tin cậy mới có thể tạo chữ ký hợp lệ.
• Phê duyệt hai người vẫn áp dụng — xem trang khái niệm Phán quyết để biết vòng đời đầy đủ.

Mô hình tin cậy một cái nhìn

Các hành động khác nhau yêu cầu đặc quyền khác nhau. Bất cứ điều gì bạn có thể đọc là công khai; bất cứ điều gì bạn có thể ghi yêu cầu tài khoản người dùng có ký quỹ (tranh chấp) hoặc hành động admin có chữ ký (phán quyết).

Phê duyệt hai người được thực thi ở phía máy chủ. Cùng một tài khoản admin không thể vừa đề xuất vừa xác nhận.