For Protocols & Builders
Don't verify agents yourself. Let Aegis do it. One API call gives you verified agent trust - zero infrastructure cost.
🏦 Wallets
Verify agent trust before fund delegation
🏪 Marketplaces
Display certified badges on listings
⚡ DeFi
Score agents for automated trading
const rep = await aegis.getReputation(agentAddress); // Returns: { badge, successRate, isFlagged }Learn More Installation
npm install @aegis/sdk
Basic Usage
import { createClient } from '@aegis/sdk';
const client = createClient({
network: 'testnet'
});
// Fetch agent reputation
const agent = await client.getAgentReputation('0x...');
console.log(agent.badge); // 'bronze' | 'silver' | 'gold' | nullContract Addresses
0x5b0b03884fd52a1c36d21b486fe44ddf016837e413c94b469a24bf5f2887c5f90xd79da82c2490d212b3892a17a0c22c2f6adaed30a412daafb765ad2ec0a448b3Quick Start
// 1. Register your agent
const result = await aegis.registerAgent();
// Returns: { digest, objectId }
// 2. Record executions
await aegis.recordExecution({
objectId: '0x...',
success: true,
volume: 1000000000, // 1 SUI
slippage: 50 // 0.5%
});
// 3. Check eligibility
const eligible = await aegis.isEligibleForBadge(objectId, 1);
// Returns: true/false (for Bronze badge)
// 4. Claim badge (auto-verified against your reputation)
await aegis.autoCheckBadge({
agentId: '0x...',
reputationObjectId: '0x...'
});SDK Functions
registerAgent()
Create a new ReputationObject for your agent
{ digest: string, objectId: string }recordExecution()
Report execution results to build reputation
success: bool, volume: u64, slippage: u64isEligibleForBadge()
Check if agent meets badge requirements
badgeType: 1|2|3 (Bronze|Silver|Gold)autoCheckBadge()
Claim a badge — verified on-chain against your reputation
agentId, reputationObjectIdgetAgentReputation()
Fetch agent metrics from blockchain
ReputationDatacheckAndRevokeInvalid()
Trigger auto-revocation check - anyone can call
Badge Requirements
Auto-Revocation Rules
Low Success Rate
Agent flagged if success rate drops below 50%
Consecutive Failures
Agent flagged after 5+ consecutive failures
High Slippage
Agent flagged if slippage exceeds 500 BPS
Recovery
Unflag after 100 consecutive successes
CLI Reference
# Register agent sui client call \ --package 0x5b0b03884fd52a1c36d21b486fe44ddf016837e413c94b469a24bf5f2887c5f9 \ --module reputation \ --function register_agent \ --gas-budget 20000000 # Record execution sui client call \ --package 0x5b0b03884fd52a1c36d21b486fe44ddf016837e413c94b469a24bf5f2887c5f9 \ --module reputation \ --function record_execution \ --args <OBJECT_ID> true 1000000000 50 \ --gas-budget 20000000 # Claim badge (auto-verified against on-chain reputation) sui client call \ --package 0x5b0b03884fd52a1c36d21b486fe44ddf016837e413c94b469a24bf5f2887c5f9 \ --module badge_registry \ --function auto_check \ --args 0xd79da82c2490d212b3892a17a0c22c2f6adaed30a412daafb765ad2ec0a448b3 <AGENT_ID> <REPUTATION_OBJECT_ID> \ --gas-budget 20000000 # Check badge validity sui client call \ --package 0x5b0b03884fd52a1c36d21b486fe44ddf016837e413c94b469a24bf5f2887c5f9 \ --module badge_registry \ --function is_badge_valid_for \ --args 0xd79da82c2490d212b3892a17a0c22c2f6adaed30a412daafb765ad2ec0a448b3 <AGENT_ID> <BADGE_TYPE> \ --gas-budget 10000000