self_agent_sdk/
constants.rs

1// SPDX-FileCopyrightText: 2025-2026 Social Connect Labs, Inc.
2// SPDX-License-Identifier: BUSL-1.1
3// NOTE: Converts to Apache-2.0 on 2029-06-11 per LICENSE.
4
5use alloy::primitives::Address;
6use alloy::sol;
7use std::str::FromStr;
8
9/// Supported network names.
10#[derive(Debug, Clone, Copy, PartialEq, Eq)]
11pub enum NetworkName {
12    Mainnet,
13    Testnet,
14}
15
16/// Per-network configuration (registry address + RPC URL).
17#[derive(Debug, Clone)]
18pub struct NetworkConfig {
19    pub registry_address: Address,
20    pub rpc_url: &'static str,
21}
22
23/// Get the network configuration for a given network.
24pub fn network_config(network: NetworkName) -> NetworkConfig {
25    match network {
26        NetworkName::Mainnet => NetworkConfig {
27            registry_address: Address::from_str("0xaC3DF9ABf80d0F5c020C06B04Cced27763355944")
28                .unwrap(),
29            rpc_url: "https://forno.celo.org",
30        },
31        NetworkName::Testnet => NetworkConfig {
32            registry_address: Address::from_str("0x043DaCac8b0771DD5b444bCC88f2f8BBDBEdd379")
33                .unwrap(),
34            rpc_url: "https://forno.celo-sepolia.celo-testnet.org",
35        },
36    }
37}
38
39/// Default network — production-safe.
40pub const DEFAULT_NETWORK: NetworkName = NetworkName::Mainnet;
41
42/// Default signature validity window (5 minutes).
43pub const DEFAULT_MAX_AGE_MS: u64 = 5 * 60 * 1000;
44
45/// Default cache TTL for on-chain status (1 minute).
46pub const DEFAULT_CACHE_TTL_MS: u64 = 60_000;
47
48/// Request headers used by the signing protocol.
49pub mod headers {
50    /// Agent's Ethereum address (informational — identity is recovered from signature).
51    pub const ADDRESS: &str = "x-self-agent-address";
52    /// ECDSA signature over the request.
53    pub const SIGNATURE: &str = "x-self-agent-signature";
54    /// Unix timestamp (milliseconds) for replay protection.
55    pub const TIMESTAMP: &str = "x-self-agent-timestamp";
56}
57
58// Registry ABI — matches the TS SDK's REGISTRY_ABI exactly.
59sol! {
60    #[sol(rpc)]
61    interface IAgentRegistry {
62        function isVerifiedAgent(bytes32 agentPubKey) external view returns (bool);
63        function getAgentId(bytes32 agentPubKey) external view returns (uint256);
64        function hasHumanProof(uint256 agentId) external view returns (bool);
65        function getHumanNullifier(uint256 agentId) external view returns (uint256);
66        function getAgentCountForHuman(uint256 nullifier) external view returns (uint256);
67        function sameHuman(uint256 agentIdA, uint256 agentIdB) external view returns (bool);
68        function getProofProvider(uint256 agentId) external view returns (address);
69        function isProofFresh(uint256 agentId) external view returns (bool);
70        function selfProofProvider() external view returns (address);
71        function ownerOf(uint256 tokenId) external view returns (address);
72
73        struct AgentCredentials {
74            string issuingState;
75            string[] name;
76            string idNumber;
77            string nationality;
78            string dateOfBirth;
79            string gender;
80            string expiryDate;
81            uint256 olderThan;
82            bool[3] ofac;
83        }
84        function getAgentCredentials(uint256 agentId) external view returns (AgentCredentials);
85
86        // A2A Agent Cards
87        function getAgentMetadata(uint256 agentId) external view returns (string);
88        function updateAgentMetadata(uint256 agentId, string metadata) external;
89        function agentRegisteredAt(uint256 agentId) external view returns (uint256);
90        // ERC-8004: proof expiry
91        function proofExpiresAt(uint256 agentId) external view returns (uint256);
92        // Replay-protection nonces for registration signatures
93        function agentNonces(address agent) external view returns (uint256);
94    }
95}
96
97// Provider ABI — used to query provider metadata.
98sol! {
99    #[sol(rpc)]
100    interface IHumanProofProvider {
101        function providerName() external view returns (string);
102        function verificationStrength() external view returns (uint8);
103    }
104}
self_agent_sdk/constants.rs

self_agent_sdk/
constants.rs
