Agent Trust Registry Smart Contract

1
// SPDX-License-Identifier: MIT
2
pragma solidity ^0.8.24;
3
4
interface IAgentTrustRegistry {
5
    enum AgentState { Registered, Active, Suspended, Decommissioned }
6
    enum AutonomyLevel { Intern, Junior, Senior, Principal }
7
8
    struct AgentRecord {
9
        string agentDid;
10
        string operatorDid;
11
        uint8 trustScore;
12
        AgentState state;
13
        AutonomyLevel autonomy;
14
        uint256 registeredAt;
15
        uint256 lastUpdated;
16
        uint256 totalActions;
17
        uint256 successfulActions;
18
    }
19
20
    struct Attestation {
21
        string validatorDid;
22
        uint8 score;
23
        string attestationType;
24
        uint256 issuedAt;
25
    }
26
27
    // Events
28
    event AgentRegistered(string indexed agentDid, string operatorDid);
29
    event TrustScoreUpdated(string indexed agentDid, uint8 oldScore, uint8 newScore, string reason);
30
    event AgentStateChanged(string indexed agentDid, AgentState oldState, AgentState newState);
31
    event AgentPromoted(string indexed agentDid, AutonomyLevel oldLevel, AutonomyLevel newLevel);
32
    event AgentDecommissioned(string indexed agentDid);
33
    event AttestationAdded(string indexed agentDid, string validatorDid, uint8 score);
34
    event ValidatorRegistered(address indexed validator, string validatorDid);
35
36
    // Agent lifecycle
37
    function registerAgent(
38
        string calldata agentDid,
39
        string calldata operatorDid,
40
        string[] calldata capabilities
41
    ) external;
42
43
    function getAgent(string calldata agentDid) external view returns (AgentRecord memory);
44
45
    function setAgentState(string calldata agentDid, AgentState state) external;
46
47
    function decommissionAgent(string calldata agentDid) external;
48
49
    // Trust scoring
50
    function updateTrustScore(string calldata agentDid, int8 delta, string calldata reason) external;
51
52
    function getTrustScore(string calldata agentDid) external view returns (uint8);
53
54
    function recordAction(string calldata agentDid, bool success) external;
55
56
    // Autonomy
57
    function promoteAgent(string calldata agentDid, AutonomyLevel level) external;
58
59
    function getAutonomyLevel(string calldata agentDid) external view returns (AutonomyLevel);
60
61
    // Attestations
62
    function addAttestation(
63
        string calldata agentDid,
64
        string calldata validatorDid,
65
        uint8 score,
66
        string calldata attestationType
67
    ) external;
68
69
    function getAttestations(string calldata agentDid) external view returns (Attestation[] memory);
70
71
    // Validators
72
    function registerValidator(address validator, string calldata validatorDid) external;
73
74
    function isValidator(address account) external view returns (bool);
75
76
    // Discovery
77
    function searchAgents(
78
        uint8 minTrustScore,
79
        AgentState state,
80
        uint256 offset,
81
        uint256 limit
82
    ) external view returns (AgentRecord[] memory);
83
84
    function getAgentCount() external view returns (uint256);
85
}

1
function registerAgent(
2
    string calldata agentDid,
3
    string calldata operatorDid,
4
    string[] calldata capabilities
5
) external;

1
function updateTrustScore(string calldata agentDid, int8 delta, string calldata reason) external;

1
function decommissionAgent(string calldata agentDid) external;