Attestation/Dispute management

Attestation Dispute Management

Get All Against Attestation Disputes

GET /against_attestation_disputes

Returns all attestation disputes against the currently registered nodes (where registered nodes are defendants).

Response Status Codes

• 200 OK: Successfully retrieved attestation disputes

• 500 Internal Server Error: Failed to retrieve attestation disputes from state manager

Response

[
  {
    "dispute_id": "dispute-123",
    "stack_small_id": 1,
    "plaintiff_node_id": 456,
    "defendant_node_id": 123,
    "disputed_attestation_index": 2,
    "disputed_hash": "0x...",
    "resolution_status": "Pending",
    "created_at_epoch": 1000,
    "resolved_at_epoch": null
  }
]

Response Fields

• dispute_id (string): Unique identifier for the dispute

• stack_small_id (integer): ID of the stack being disputed

• plaintiff_node_id (integer): ID of the node that initiated the dispute

• defendant_node_id (integer): ID of the node being disputed against

• disputed_attestation_index (integer): Index of the disputed attestation

• disputed_hash (string): Hash of the disputed attestation

• resolution_status (string): Current status of the dispute resolution

• created_at_epoch (integer): Epoch timestamp when the dispute was created

• resolved_at_epoch (integer, optional): Epoch timestamp when the dispute was resolved

Get Against Attestation Dispute

GET /against_attestation_disputes/:id

Returns all attestation disputes against a specific node (where specified node is defendant).

Parameters

• id (path, integer): Node small ID of the defendant

Response Status Codes

• 200 OK: Successfully retrieved attestation disputes

• 500 Internal Server Error: Failed to retrieve attestation disputes from state manager

Response

Same format as Get All Against Attestation Disputes, filtered for the specified defendant node.

Get All Own Attestation Disputes

GET /own_attestation_disputes

Returns all attestation disputes initiated by the currently registered nodes (where registered nodes are plaintiffs).

Response Status Codes

• 200 OK: Successfully retrieved attestation disputes

• 500 Internal Server Error: Failed to retrieve attestation disputes from state manager

Response

Same format as Get All Against Attestation Disputes, but where registered nodes are the plaintiffs.

Example Error Response

{
  "error": "Failed to get all own attestation disputes"
}

Get Own Attestation Dispute

GET /own_attestation_disputes/:id

Returns all attestation disputes initiated by a specific node (where specified node is plaintiff).

Parameters

• id (path, integer): Node small ID of the plaintiff

Response Status Codes

• 200 OK: Successfully retrieved attestation disputes

• 500 Internal Server Error: Failed to retrieve attestation disputes from state manager

Response

Same format as Get All Against Attestation Disputes, filtered for the specified plaintiff node.

Example Error Response

{
  "error": "Failed to get own attestation dispute"
}

Notes

• Disputes can be in various resolution states (e.g., "Pending", "Resolved", "Rejected")

• The resolved_at_epoch will be null for unresolved disputes

• A node can be both a plaintiff in some disputes and a defendant in others

• The disputed attestation index corresponds to the position in the stack's attestation chain