ERC-8004 Proof-of-Human

1/// @title IERC8004ProofOfHuman
2/// @notice Optional extension to ERC-8004 adding proof-of-human verification
3interface IERC8004ProofOfHuman is IERC8004 {
4    // ── Registration ──────────────────────────────────────
5    /// @notice Register an agent with verifiable proof-of-human
6    function registerWithHumanProof(
7        string calldata agentURI,
8        address proofProvider,
9        bytes calldata proof,
10        bytes calldata providerData
11    ) external returns (uint256 agentId);
12
13    /// @notice Revoke an agent's human proof (same nullifier required)
14    function revokeHumanProof(
15        uint256 agentId,
16        address proofProvider,
17        bytes calldata proof,
18        bytes calldata providerData
19    ) external;
20
21    // ── Verification (read by any service/contract) ──────
22    /// @notice Check if an agent has verified proof-of-human
23    function hasHumanProof(uint256 agentId) external view returns (bool);
24
25    /// @notice Get the nullifier for an agent
26    function getHumanNullifier(uint256 agentId) external view returns (uint256);
27
28    /// @notice Get which provider verified this agent
29    function getProofProvider(uint256 agentId) external view returns (address);
30
31    // ── Sybil detection ──────────────────────────────────
32    /// @notice Count active agents for a human (by nullifier)
33    function getAgentCountForHuman(uint256 nullifier) external view returns (uint256);
34
35    /// @notice Check if two agents are backed by the same human
36    function sameHuman(uint256 a, uint256 b) external view returns (bool);
37
38    // ── Provider management ──────────────────────────────
39    /// @notice Check if a proof provider is whitelisted
40    function isApprovedProvider(address provider) external view returns (bool);
41}

1/// @title IHumanProofProvider
2/// @notice Pluggable identity backend for proof-of-human
3interface IHumanProofProvider {
4    /// @notice Verify a ZK proof and return (success, nullifier)
5    /// @dev The nullifier must be deterministic: same human + same scope
6    ///      always produces the same nullifier.
7    function verifyHumanProof(
8        bytes calldata proof,
9        bytes calldata data
10    ) external returns (bool verified, uint256 nullifier);
11
12    /// @notice Human-readable provider name (e.g. "Self Protocol")
13    function providerName() external view returns (string memory);
14
15    /// @notice Verification strength score (0-100)
16    /// @dev 100 = passport/NFC chip, 60 = government ID, 40 = liveness check
17    function verificationStrength() external view returns (uint8);
18}