Attestation/Dispute management
Attestation Dispute Management
Get All 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 disputes500 Internal Server Error
: Failed to retrieve attestation disputes from state manager
Response
Response Fields
dispute_id
(string): Unique identifier for the disputestack_small_id
(integer): ID of the stack being disputedplaintiff_node_id
(integer): ID of the node that initiated the disputedefendant_node_id
(integer): ID of the node being disputed againstdisputed_attestation_index
(integer): Index of the disputed attestationdisputed_hash
(string): Hash of the disputed attestationresolution_status
(string): Current status of the dispute resolutioncreated_at_epoch
(integer): Epoch timestamp when the dispute was createdresolved_at_epoch
(integer, optional): Epoch timestamp when the dispute was resolved
Get Against Attestation Dispute
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 disputes500 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
Returns all attestation disputes initiated by the currently registered nodes (where registered nodes are plaintiffs).
Response Status Codes
200 OK
: Successfully retrieved attestation disputes500 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
Get Own Attestation Dispute
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 disputes500 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
Notes
Disputes can be in various resolution states (e.g., "Pending", "Resolved", "Rejected")
The
resolved_at_epoch
will be null for unresolved disputesA 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
Last updated