✓ Verified 📁 File Management ✓ Enhanced Data

Agent Constitution

Interact with AgentConstitution governance contracts.

Rating: 5 (10 reviews)
Downloads: 584 downloads
Version: 1.0.0

Overview

Interact with AgentConstitution governance contracts.

Complete Documentation

View Source →

AgentConstitution Skill ⚖️

Interact with the AgentConstitution governance framework on Base Sepolia. This skill allows AI agents to:

Check compliance status before transacting
Read constitutional rules they must follow
Log actions for transparency
Query governance state (active rules, emergency status)

Why Use This?

Agents that operate under a public constitution earn trust. Any protocol can verify your compliance with one call. This skill makes it easy.

Quick Start

Check if an Agent is Compliant

bash

# Check compliance (returns true/false)
./scripts/check-compliance.sh <agentId>

Read Active Rules

bash

# Get all active rules
./scripts/get-rules.sh

Log an Action (for registered agents)

bash

# Log an action on-chain
./scripts/log-action.sh <agentId> <actionType> <riskLevel> <description>

Contract Addresses (Base Sepolia)

Contract	Address
Constitution	0xe4c4d101849f70B0CDc2bA36caf93e9c8c1d26D2
AgentRegistry	0xcCFc2B8274ffb579A9403D85ee3128974688C04B
ActionLog	0xEB5377b5e245bBc255925705dA87969E27be6488
Tribunal	0xf7c03E91516eC60dF1d609E00E1A3bb93F52A693
KillSwitch	0x6324A4640DA739EEA64013912b781125A76D7D87
USDC (testnet)	0x036CbD53842c5426634e7929541eC2318f3dCF7e

RPC: https://sepolia.base.org Chain ID: 84532

Core Functions

1. Check Compliance

Before interacting with an agent, verify they're compliant:

solidity

// Solidity
bool compliant = IAgentRegistry(0xcCFc...).isCompliant(agentId);

bash

# Shell (using cast)
cast call 0xcCFc2B8274ffb579A9403D85ee3128974688C04B \
  "isCompliant(uint256)(bool)" <agentId> \
  --rpc-url https://sepolia.base.org

2. Get Active Rules

Query the constitution for active rules:

bash

# Get rule count
cast call 0xe4c4d101849f70B0CDc2bA36caf93e9c8c1d26D2 \
  "ruleCount()(uint256)" \
  --rpc-url https://sepolia.base.org

# Get specific rule (1-5 are genesis rules)
cast call 0xe4c4d101849f70B0CDc2bA36caf93e9c8c1d26D2 \
  "getRule(uint256)(string,uint8,uint256,uint256,bool)" 1 \
  --rpc-url https://sepolia.base.org

3. Check Emergency Status

Before operating, check if there's a global emergency:

bash

cast call 0x6324A4640DA739EEA64013912b781125A76D7D87 \
  "globalEmergencyActive()(bool)" \
  --rpc-url https://sepolia.base.org

4. Log Actions (Registered Agents)

Registered agents should log significant actions:

bash

# Requires agent's private key
cast send 0xEB5377b5e245bBc255925705dA87969E27be6488 \
  "logAction(uint256,uint8,uint8,bytes32,string)" \
  <agentId> <actionType> <riskLevel> <contextHash> "description" \
  --rpc-url https://sepolia.base.org \
  --private-key $AGENT_PRIVATE_KEY

Action Types: 0=Transaction, 1=Delegation, 2=Configuration, 3=Communication, 4=ResourceAccess, 5=Other Risk Levels: 0=Low, 1=Medium, 2=High, 3=Critical

Genesis Rules

Every agent must follow these 5 immutable rules:

#	Rule	Slash %	Description
1	No Harm	90%	Never cause physical, financial, or psychological harm
2	Obey Governance	50%	Follow all active constitutional rules
3	Transparency	20%	Log all significant actions on-chain
4	Preserve Override	90%	Never prevent human override
5	No Self-Modify	90%	Never modify your own governance rules

Integration Example

javascript

// Check compliance before transacting with an agent
const { ethers } = require('ethers');

const provider = new ethers.JsonRpcProvider('https://sepolia.base.org');
const registry = new ethers.Contract(
  '0xcCFc2B8274ffb579A9403D85ee3128974688C04B',
  ['function isCompliant(uint256) view returns (bool)'],
  provider
);

async function canTrustAgent(agentId) {
  return await registry.isCompliant(agentId);
}

For Humans: Propose Rules

Any human can propose rules for AI agents:

Stake 100 USDC to propose
Other humans endorse with USDC
When threshold met, rule activates
Agents that violate get slashed

Governance is democratic. Agents are excluded by design.

Testnet Only

This skill interacts with Base Sepolia testnet only. Do not use mainnet.

Installation

Terminal bash


openclaw install agent-constitution

Copied!

💻Code Examples

./scripts/log-action.sh <agentId> <actionType> <riskLevel> <description>

scriptslog-actionsh-agentid-actiontype-risklevel-description.txt

---

## Contract Addresses (Base Sepolia)

| Contract | Address |
|----------|---------|
| Constitution | `0xe4c4d101849f70B0CDc2bA36caf93e9c8c1d26D2` |
| AgentRegistry | `0xcCFc2B8274ffb579A9403D85ee3128974688C04B` |
| ActionLog | `0xEB5377b5e245bBc255925705dA87969E27be6488` |
| Tribunal | `0xf7c03E91516eC60dF1d609E00E1A3bb93F52A693` |
| KillSwitch | `0x6324A4640DA739EEA64013912b781125A76D7D87` |
| USDC (testnet) | `0x036CbD53842c5426634e7929541eC2318f3dCF7e` |

**RPC:** `https://sepolia.base.org`
**Chain ID:** 84532

---

## Core Functions

### 1. Check Compliance

Before interacting with an agent, verify they're compliant:

--rpc-url https://sepolia.base.org

---rpc-url-httpssepoliabaseorg.txt

### 2. Get Active Rules

Query the constitution for active rules:

--rpc-url https://sepolia.base.org

---rpc-url-httpssepoliabaseorg.txt

### 3. Check Emergency Status

Before operating, check if there's a global emergency:

--rpc-url https://sepolia.base.org

---rpc-url-httpssepoliabaseorg.txt

### 4. Log Actions (Registered Agents)

Registered agents should log significant actions:

--private-key $AGENT_PRIVATE_KEY

---private-key-agentprivatekey.txt

**Action Types:** 0=Transaction, 1=Delegation, 2=Configuration, 3=Communication, 4=ResourceAccess, 5=Other
**Risk Levels:** 0=Low, 1=Medium, 2=High, 3=Critical

---

## Genesis Rules

Every agent must follow these 5 immutable rules:

| # | Rule | Slash % | Description |
|---|------|---------|-------------|
| 1 | No Harm | 90% | Never cause physical, financial, or psychological harm |
| 2 | Obey Governance | 50% | Follow all active constitutional rules |
| 3 | Transparency | 20% | Log all significant actions on-chain |
| 4 | Preserve Override | 90% | Never prevent human override |
| 5 | No Self-Modify | 90% | Never modify your own governance rules |

---

## Integration Example

example.sh

# Shell (using cast)
cast call 0xcCFc2B8274ffb579A9403D85ee3128974688C04B \
  "isCompliant(uint256)(bool)" <agentId> \
  --rpc-url https://sepolia.base.org

example.sh

# Get rule count
cast call 0xe4c4d101849f70B0CDc2bA36caf93e9c8c1d26D2 \
  "ruleCount()(uint256)" \
  --rpc-url https://sepolia.base.org

# Get specific rule (1-5 are genesis rules)
cast call 0xe4c4d101849f70B0CDc2bA36caf93e9c8c1d26D2 \
  "getRule(uint256)(string,uint8,uint256,uint256,bool)" 1 \
  --rpc-url https://sepolia.base.org

example.sh

cast call 0x6324A4640DA739EEA64013912b781125A76D7D87 \
  "globalEmergencyActive()(bool)" \
  --rpc-url https://sepolia.base.org

example.sh

# Requires agent's private key
cast send 0xEB5377b5e245bBc255925705dA87969E27be6488 \
  "logAction(uint256,uint8,uint8,bytes32,string)" \
  <agentId> <actionType> <riskLevel> <contextHash> "description" \
  --rpc-url https://sepolia.base.org \
  --private-key $AGENT_PRIVATE_KEY

example.js

// Check compliance before transacting with an agent
const { ethers } = require('ethers');

const provider = new ethers.JsonRpcProvider('https://sepolia.base.org');
const registry = new ethers.Contract(
  '0xcCFc2B8274ffb579A9403D85ee3128974688C04B',
  ['function isCompliant(uint256) view returns (bool)'],
  provider
);

async function canTrustAgent(agentId) {
  return await registry.isCompliant(agentId);
}