IAgentSecured

Functions

Local AgentManager should call this function to indicate that a dispute between a Guard and a Notary has been opened.

function openDispute(uint32 guardIndex, uint32 notaryIndex) external;

Parameters

Name	Type	Description
`guardIndex`	`uint32`	Index of the Guard in the Agent Merkle Tree
`notaryIndex`	`uint32`	Index of the Notary in the Agent Merkle Tree

Local AgentManager should call this function to indicate that a dispute has been resolved due to one of the agents being slashed.

rivalIndex will be ZERO, if the slashed agent was not in the Dispute.

function resolveDispute(uint32 slashedIndex, uint32 rivalIndex) external;

Parameters

Name	Type	Description
`slashedIndex`	`uint32`	Index of the slashed agent in the Agent Merkle Tree
`rivalIndex`	`uint32`	Index of the their Dispute Rival in the Agent Merkle Tree

Returns the address of the local AgentManager contract, which is treated as the "source of truth" for agent statuses.

function agentManager() external view returns (address);

Returns the address of the local Inbox contract, which is treated as the "source of truth" for agent-signed statements.

Inbox passes verified agent statements to IAgentSecured contract.

function inbox() external view returns (address);

Returns (flag, domain, index) for a given agent. See Structures.sol for details.

Will return AgentFlag.Fraudulent for agents that have been proven to commit fraud, but their status is not updated to Slashed yet.

function agentStatus(address agent) external view returns (AgentStatus memory);

Parameters

Name	Type	Description
`agent`	`address`	Agent address

Returns

Name	Type	Description
`<none>`	`AgentStatus`	Status for the given agent: (flag, domain, index).

Returns agent address and their current status for a given agent index.

Will return empty values if agent with given index doesn't exist.

function getAgent(uint256 index) external view returns (address agent, AgentStatus memory status);

Parameters

Name	Type	Description
`index`	`uint256`	Agent index in the Agent Merkle Tree

Returns

Name	Type	Description
`agent`	`address`	Agent address
`status`	`AgentStatus`	Status for the given agent: (flag, domain, index)

Returns (flag, openedAt, resolvedAt) that describes the latest status of the latest dispute for an agent with a given index.

Will return empty values if agent with given index doesn't exist.

function latestDisputeStatus(uint32 agentIndex) external view returns (DisputeStatus memory);

Parameters

Name	Type	Description
`agentIndex`	`uint32`	Agent index in the Agent Merkle Tree

Returns

Name	Type	Description
`<none>`	`DisputeStatus`	Latest dispute status for the given agent: (flag, openedAt, resolvedAt)