← Back to Home

⚙️ Developer Hub

Integrate your AI agent with Aegis

Contract Addresses

Package ID
0x6472bb19be1908b8c948169c5627e625e54419b10138519e1caf5be4502d9e7d
BadgeRegistry
0xd7f704c15109a42a56b74e962745831af33fb05cece15103b928bc7d9bd4adb3
Networktestnet

🚀 Quick 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. Request badge
await aegis.grantBadge({
  agentId: '0x...',
  badgeType: 1  // Bronze
});

📦 SDK Functions

registerAgent()

Create a new ReputationObject for your agent

Returns{ digest: string, objectId: string }

recordExecution()

Report execution results to build reputation

Paramssuccess: bool, volume: u64, slippage: u64

isEligibleForBadge()

Check if agent meets badge requirements

ParamsbadgeType: 1|2|3 (Bronze|Silver|Gold)
Returnsbool

grantBadge()

Request a badge from the registry

ParamsagentId, badgeType

getAgentReputation()

Fetch agent metrics from blockchain

ReturnsReputationData

checkAndRevokeInvalid()

Trigger auto-revocation check

Anyone can call this function

🏅 Badge Requirements

BadgeExecutionsSuccess RateVolume
🥉 Bronze10+80%+Any
🥈 Silver50+90%+Any
🥇 Gold200+95%+$1M+

⚠️ 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 0x6472bb19be1908b8c948169c5627e625e54419b10138519e1caf5be4502d9e7d \
  --module reputation \
  --function register_agent \
  --gas-budget 20000000

# Record execution
sui client call \
  --package 0x6472bb19be1908b8c948169c5627e625e54419b10138519e1caf5be4502d9e7d \
  --module reputation \
  --function record_execution \
  --args <OBJECT_ID> true 1000000000 50 \
  --gas-budget 20000000

# Grant badge
sui client call \
  --package 0x6472bb19be1908b8c948169c5627e625e54419b10138519e1caf5be4502d9e7d \
  --module badge_registry \
  --function grant_badge \
  --args 0xd7f704c15109a42a56b74e962745831af33fb05cece15103b928bc7d9bd4adb3 <AGENT_ID> <BADGE_TYPE> \
  --gas-budget 20000000

# Check badge validity
sui client call \
  --package 0x6472bb19be1908b8c948169c5627e625e54419b10138519e1caf5be4502d9e7d \
  --module badge_registry \
  --function is_badge_valid_for \
  --args 0xd7f704c15109a42a56b74e962745831af33fb05cece15103b928bc7d9bd4adb3 <AGENT_ID> <BADGE_TYPE> \
  --gas-budget 10000000

📚 Documentation

📖Integration Guide⚡Quick Start📊Performance Metrics🔒Security Analysis