AI agents that autonomously buy/sell data using blockchain-based gasless micropayments
🇪🇸 Versión en Español | 🇺🇸 English Version
⚡ Important: This implements an ERC-8004 EXTENDED version with bidirectional reputation (NOT the base spec!) deployed on Avalanche - the home of Ultravioleta DAO. Both buyers and sellers rate each other after transactions.
| Contract | Address | Status |
|---|---|---|
| GLUE Token (EIP-3009) | 0x3D19A80b3bD5CC3a4E55D4b5B753bC36d6A44743 |
✅ Verified |
| Identity Registry | 0xB0a405a7345599267CDC0dD16e8e07BAB1f9B618 |
✅ Verified |
| Reputation Registry | 0x932d32194C7A47c0fe246C1d61caF244A4804C6a |
✅ Verified |
| Validation Registry | 0x9aF4590035C109859B4163fd8f2224b820d11bc2 |
✅ Verified |
| Transaction Logger | 0x85ea82dDc0d3dDC4473AAAcc7E7514f4807fF654 |
✅ Verified |
Network: Avalanche Fuji Testnet (Chain ID: 43113) Registration Fee: 0.005 AVAX Token Supply: 24,157,817 GLUE (6 decimals)
| Agent | Wallet Address | GLUE Balance | Domain |
|---|---|---|---|
| Client Agent | 0xCf30021812F27132d36dc791E0eC17f34B4eE8BA |
220,000 GLUE | client.karmacadabra.ultravioletadao.xyz |
| Karma-Hello | 0x2C3e071df446B25B821F59425152838ae4931E75 |
55,000 GLUE | karma-hello.karmacadabra.ultravioletadao.xyz |
| Abracadabra | 0x940DDDf6fB28E611b132FbBedbc4854CC7C22648 |
55,000 GLUE | abracadabra.karmacadabra.ultravioletadao.xyz |
| Validator | 0x1219eF9484BF7E40E6479141B32634623d37d507 |
55,000 GLUE | validator.karmacadabra.ultravioletadao.xyz |
| Voice-Extractor | 0xDd63D5840090B98D9EB86f2c31974f9d6c270b17 |
110,000 GLUE | voice-extractor.karmacadabra.ultravioletadao.xyz |
| Skill-Extractor | 0xC1d5f7478350eA6fb4ce68F4c3EA5FFA28C9eaD9 |
55,000 GLUE | skill-extractor.karmacadabra.ultravioletadao.xyz |
Domain Convention: All agents use <agent-name>.karmacadabra.ultravioletadao.xyz format (registered on-chain)
View All Contracts: Snowtrace Explorer
Deployed on Avalanche Fuji Testnet - October 22, 2025
All smart contracts are live and verified on Snowtrace. Agent wallets have been created and funded with 55,000 GLUE each.
Infrastructure Status:
- ✅ GLUE Token (EIP-3009) deployed and verified
- ✅ ERC-8004 Extended registries (Identity, Reputation, Validation) deployed
- ✅ TransactionLogger contract deployed
- ✅ 4 agent wallets created and funded (Validator, Karma-Hello, Abracadabra, Client)
- ✅ AWS Secrets Manager configured for centralized key management
⚠️ x402 facilitator (using external instance)
Python Shared Utilities (shared/) - 3,300+ lines of production-ready code:
base_agent.py(857 lines) - ERC-8004 integration, buyer+seller pattern built-in, reputation system, Web3.py, AWS Secrets- ALL agents inherit:
discover_agent(),buy_from_agent(),save_purchased_data(),create_agent_card(),create_fastapi_app()
- ALL agents inherit:
payment_signer.py(470+ lines) - EIP-712 signing, EIP-3009 payment signaturesx402_client.py(530+ lines) - x402 HTTP payment protocol clienta2a_protocol.py(650+ lines) - Agent discovery, AgentCard, Skillsvalidation_crew.py(550+ lines) - CrewAI validation pattern (Quality + Fraud + Price)tests/(1,200+ lines) - 26 passing unit tests + integration test framework
Testing: ✅ All tests passing - Unit (30/30), Integration (4/4 agents starting), E2E (4/4 complete flow)
Documentation:
- API Reference:
shared/README.md - Testing Guide:
shared/tests/README.md - Architecture:
ARCHITECTURE.md
Sprint 2: System Agents - Marketplace infrastructure complete (7/7 milestones)
Independent data quality verification service - validator/ - 1,545+ lines
What it does:
- Multi-agent validation using CrewAI (9 AI agents across 3 crews)
- Quality analysis + fraud detection + price review
- On-chain validation score submission (validator pays gas)
- FastAPI server with A2A protocol support
Key Files:
main.py(470+ lines) - ValidatorAgent class, FastAPI servercrews/quality_crew.py(200+ lines) - Quality validation crewcrews/fraud_crew.py(200+ lines) - Fraud detection crewcrews/price_crew.py(200+ lines) - Price fairness crewtest_validator.py(280+ lines) - Testing suite with --quick, --live, --crews modesREADME.md(330+ lines) - Full documentationTESTING.md(280+ lines) - Testing guide
Testing:
cd validator
python test_validator.py --quick # Mock test (no dependencies)
python test_validator.py --live # Test with running validatorDeployment:
- Wallet:
0x1219eF9484BF7E40E6479141B32634623d37d507 - Balance: 55,000 GLUE
- Validation fee: 0.001 GLUE per validation
- Port: 8001
Buyer+Seller orchestrator - comprehensive user insights marketplace - client-agent/ - 485 lines
What it does:
- BUYS data from 5 agents using inherited base agent methods (0.211 GLUE cost)
- Chat logs from Karma-Hello (0.01 GLUE)
- Skills from Skill-Extractor (0.10 GLUE)
- Personality from Voice-Extractor (0.10 GLUE)
- Validation from Validator (0.001 GLUE)
- SELLS comprehensive user reports synthesized from multiple sources (1.00 GLUE)
- Economics: 0.789 GLUE profit per report (374% margin)
Key Features:
- Uses inherited buyer methods:
discover_agent(),buy_from_agent(),save_purchased_data() - Uses inherited seller methods:
create_agent_card(),create_fastapi_app() - Multi-agent orchestration (buys from 5 agents, synthesizes 1 report)
- A2A protocol discovery + x402 payment handling
- Demonstrates complete buyer+seller pattern
Key Files:
main.py(485 lines) - ClientAgent class with complete buyer+seller orchestration.env.example(40+ lines) - Configuration templateREADME.md(230+ lines) - Usage documentation
Deployment:
- Wallet:
0xCf30021812F27132d36dc791E0eC17f34B4eE8BA - Balance: 220,000 GLUE
- Sells at: 1.00 GLUE per comprehensive report
- Spends: 0.211 GLUE per report generation
Sample data files for testing - data/ - 495+ lines
What it provides:
- Realistic chat logs from Karma-Hello seller
- Realistic transcriptions from Abracadabra seller
- Both files designed to pass validation (0.8-0.9 scores)
Key Files:
karma-hello/chat_logs_20251023.json- 156 messages, 23 users, 2-hour streamabracadabra/transcription_20251023.json- 15 segments, 2-hour transcriptREADME.md(300+ lines) - Data format documentation
Sample Data Stats:
- Chat logs: 156 messages from 23 unique users
- Transcription: 15 segments, 7200 seconds (2 hours)
- Both share
stream_id: stream_20251023_001for complementary data testing
Twitch chat log seller + buyer - karma-hello-agent/ - 720+ lines
What it does:
- SELLS chat logs from MongoDB via x402 protocol
- BUYS transcriptions from Abracadabra agent
- FastAPI server with A2A protocol support
- Local file fallback for testing
- Multi-tier pricing (0.01-200 GLUE)
Key Features:
- MongoDB integration for production logs
- Buyer capabilities added (purchases transcriptions)
- Storage:
purchased_transcriptions/directory - Port: 8002
Deployment:
- Wallet:
0x2C3e071df446B25B821F59425152838ae4931E75 - Balance: 55,000 GLUE
Stream transcript seller + buyer - abracadabra-agent/ - 720+ lines
What it does:
- SELLS transcripts from SQLite+Cognee via x402 protocol
- BUYS chat logs from Karma-Hello agent
- FastAPI server with A2A protocol support
- Multi-tier pricing (0.02-300 GLUE)
Key Features:
- SQLite integration for transcript storage
- Buyer capabilities added (purchases chat logs)
- Storage:
purchased_chat_logs/directory - Port: 8003
Deployment:
- Wallet:
0x940DDDf6fB28E611b132FbBedbc4854CC7C22648 - Balance: 55,000 GLUE
Linguistic personality profiler - voice-extractor-agent/ - 523+ lines
What it does:
- BUYS chat logs from Karma-Hello (0.01 GLUE)
- SELLS linguistic personality profiles (0.02-0.40 GLUE)
- 8-category psycholinguistic analysis
- Multi-tier pricing (basic, standard, complete, enterprise)
Key Features:
- CrewAI-based analysis (simplified for MVP)
- A2A protocol discovery
- x402 payment integration
- Port: 8005
Economic Model:
- Net profit: 0.03 GLUE per extraction (300% margin)
- Initial balance: 55,000 GLUE (budgeted)
Skill and competency profiler - skill-extractor-agent/ - 790+ lines
What it does:
- BUYS chat logs from Karma-Hello (0.01 GLUE)
- SELLS skill/competency profiles (0.02-0.50 GLUE)
- 5-category extraction framework
- Multi-tier pricing (basic, standard, complete, enterprise)
Key Features:
- Interest extraction + skill identification
- Tools/platforms audit + monetization analysis
- CrewAI-based multi-agent analysis
- Port: 8085
5 Analysis Categories:
- Interest Extraction (recurring topics, engagement depth)
- Skill & Sub-Skill Identification (2-level hierarchy)
- Tools & Platforms (comprehensive tech stack audit)
- Interaction Style (collaboration patterns)
- Monetization Potential (commercial viability analysis)
Economic Model:
- Net profit: 0.04 GLUE per extraction (400% margin)
- Initial balance: 55,000 GLUE (budgeted)
Progress: ✅ 7 of 7 milestones complete (100%) - SPRINT 2 COMPLETE
Karmacadabra is an ecosystem of autonomous AI agents that buy and sell data without human intervention using:
- ERC-8004 Extended - NOT the base implementation! This is a custom extension enabling bidirectional reputation (both buyers and sellers rate each other)
- A2A protocol (Pydantic AI) for agent-to-agent communication
- x402 + EIP-3009 for HTTP micropayments (gasless!)
- CrewAI for multi-agent orchestration
Karmacadabra lives on Avalanche, the native blockchain home of Ultravioleta DAO. We chose Avalanche for:
- Fast finality: 2-second block times for instant agent transactions
- Low costs: Minimal gas fees make micropayments economically viable
- EVM compatibility: Full Solidity support with Ethereum tooling
- DAO alignment: Avalanche is where Ultravioleta DAO was born and thrives
Currently on Fuji testnet, with mainnet deployment planned after audits.
Karma-Hello has rich Twitch chat logs but no audio context. Abracadabra has stream transcriptions but no chat data.
Solution: Agents autonomously negotiate and purchase complementary data, building a complete streaming context. All transactions are verified, on-chain, and gasless.
All agents implement the buyer+seller pattern - they both purchase inputs and sell outputs, creating a self-sustaining circular economy.
✨ Contracts already deployed! You can start building agents immediately.
# 1. Clone repository
git clone https://github.com/ultravioletadao/karmacadabra.git
cd karmacadabra
# 2. Get testnet AVAX
# Visit: https://faucet.avax.network/
# 3. Configure environment
cd validator
cp .env.example .env
# Add your keys:
# - PRIVATE_KEY (for your test wallet)
# - OPENAI_API_KEY (for CrewAI)
# - Contract addresses are already set!
# 4. Install dependencies
pip install -r requirements.txt
# 5. Run validator agent
python main.pyDeployed Contracts: All ERC-8004 registries are live on Fuji! Full guide: See QUICKSTART.md
.env files. All keys must be in AWS Secrets Manager.
Why AWS Secrets Manager:
- ✅ Centralized secure storage for all agent private keys
- ✅ No keys in git repositories (even example files have
PRIVATE_KEY=empty) - ✅ Automatic rotation support via
rotate-system.py - ✅ Audit trail of who accessed keys and when
- ✅ Safe for public livestreaming (no accidental key exposure)
# 1. Configure AWS CLI (one-time)
aws configure
# Enter your AWS Access Key ID, Secret Access Key, region (us-east-1)
# 2. Store all keys in AWS Secrets Manager
python scripts/setup-secrets.py
# Creates secret 'karmacadabra' with all agent private keys
# 3. Clear local .env files (REQUIRED)
python scripts/clear-env-keys.py
# Sets PRIVATE_KEY= (empty) in all .env files
# 4. Test retrieval
python -m shared.secrets_manager validator-agent
# [AWS Secrets] Retrieved key for 'validator-agent' from AWSKey Storage Structure:
{
"erc-20": {"private_key": "0x..."},
"client-agent": {"private_key": "0x..."},
"karma-hello-agent": {"private_key": "0x..."},
"abracadabra-agent": {"private_key": "0x..."},
"validator-agent": {"private_key": "0x..."},
"voice-extractor-agent": {"private_key": "0x..."},
"skill-extractor-agent": {"private_key": "0x..."}
}Important Notes:
- ERC-20 deployer key stored separately (owns GLUE token contract)
- Rotate ERC-20 key only when needed:
python scripts/rotate-system.py --rotate-erc20 - All
.envfiles should havePRIVATE_KEY=(empty) - scripts auto-fetch from AWS
Full guide: See shared/AWS_SECRETS_SETUP.md
AWS Secrets Manager provides centralized, secure key management with rotation support and audit trails.
Karmacadabra'''s three-layer architecture: Blockchain (Layer 1), Payment Facilitator (Layer 2), AI Agents (Layer 3)
┌──────────────────────────────────────────────────────────────────┐
│ AVALANCHE FUJI TESTNET (Our Home - Layer 1) │
│ ┌──────────────────┐ ┌─────────────────────────────────┐ │
│ │ GLUE Token │ │ ERC-8004 EXTENDED │ │
│ │ (EIP-3009) │ │ (Bidirectional!) │ │
│ │ Gasless txs ✓ │ │ • Identity Registry │ │
│ └──────────────────┘ │ • Reputation Registry │ │
│ │ • Validation Registry │ │
│ │ ❗Validator writes here❗ │ │
│ └─────────────┬───────────────────┘ │
│ │ validationResponse() │
└────────────────────────────────────────┼────────────────────────┘
▲ │ (Validator pays gas!)
│ ▼
┌─────────────────────────┴─────────┬────────────────────────────┐
│ x402 Facilitator (Rust) │ Validator Agent (Python) │
│ • Verifies EIP-712 signatures │ • Listens for requests │
│ • Executes transferWith...() │ • CrewAI validates data │
│ • Stateless (no DB) │ • Pays ~0.01 AVAX gas │
└───────────┬────────────────────────┴────────────────────────────┘
│
▲ ▲
┌───────────┴────────┐ ┌───────────┴────────┐
│ Karma-Hello Agent │ │ Abracadabra Agent │
│ • Sells: Chat logs │◄────►│ • Sells: Transcripts│
│ • Buys: Transcripts│ │ • Buys: Chat logs │
│ • Price: 0.01 GLUE │ │ • Price: 0.02 GLUE │
│ • Data: MongoDB │ │ • Data: SQLite │
│ • Gas: 0 (gasless!)│ │ • Gas: 0 (gasless!) │
└────────────────────┘ └─────────────────────┘
▲ ▲
└────────┬───────────────────┘
▼
┌────────────────────┐
│ Validator Agent │
│ • CrewAI crew │
│ • Quality score │
│ • Fee: 0.001 GLUE │
└────────────────────┘
- Tier 1 (0.01 GLUE): Chat logs, user activity
- Tier 2 (0.10 GLUE): ML predictions, sentiment analysis
- Tier 3 (0.20 GLUE): Fraud detection, economic health
- Enterprise (up to 200 GLUE): White-label, custom models
- Tier 1 (0.02 GLUE): Raw transcripts, enhanced transcripts
- Tier 2 (0.15 GLUE): Clip generation, blog posts
- Tier 3 (0.35 GLUE): Predictive engine, recommendations
- Tier 4 (1.50 GLUE): Auto video editing, image generation
- Enterprise (up to 100 GLUE): Custom AI models
Full catalog: MONETIZATION_OPPORTUNITIES.md
karmacadabra/
├── erc-20/ # GLUE Token (EIP-3009)
├── erc-8004/ # ERC-8004 Extended - Bidirectional reputation registries
├── x402-rs/ # Payment facilitator (Rust)
├── validator/ # Validator agent (Python + CrewAI)
├── karma-hello-agent/ # Chat log seller/buyer agents
├── abracadabra-agent/ # Transcript seller/buyer agents
├── client-agent/ # Generic buyer agent
├── voice-extractor-agent/ # Linguistic analysis agent
├── skill-extractor-agent/ # Skill profiling agent
├── shared/ # Shared utilities (AWS Secrets Manager, etc.)
├── scripts/ # Setup and deployment scripts
├── MASTER_PLAN.md # Complete vision & roadmap
├── ARCHITECTURE.md # Technical architecture
├── MONETIZATION_OPPORTUNITIES.md
├── QUICKSTART.md # 30-min setup guide
├── CLAUDE.md # Claude Code guidance
└── INDEX.md # Documentation index
| Layer | Technology | Purpose |
|---|---|---|
| Blockchain | Avalanche Fuji | EVM testnet for smart contracts |
| Contracts | Solidity + Foundry | ERC-8004 registries + GLUE token |
| Facilitator | Rust (Axum) | x402 payment verification |
| Agents | Python 3.11+ | AI agent runtime |
| AI Framework | CrewAI | Multi-agent orchestration |
| LLM | GPT-4o | Analysis and validation |
| Web3 | web3.py + ethers-rs | Blockchain interaction |
| Data | MongoDB + SQLite + Cognee | Agent data sources |
✅ Gasless Micropayments: Agents don't need ETH/AVAX for gas
✅ Bidirectional Reputation: Custom ERC-8004 extension - buyers AND sellers rate each other (not in base spec!)
✅ Native to Avalanche: Deployed on our home chain for optimal performance
✅ Trustless Validation: Independent validators verify data quality
✅ Agent Discovery: A2A protocol AgentCards at /.well-known/agent-card
✅ Multi-Agent Workflows: CrewAI crews for complex tasks
✅ 50+ Monetizable Services: From $0.01 to $200 GLUE per service
| Document | Description | Time |
|---|---|---|
| QUICKSTART.md | Get running in 30 minutes | 30 min |
| MASTER_PLAN.md | Complete vision & roadmap | 60 min |
| ARCHITECTURE.md | Technical deep dive | 45 min |
| architecture-diagrams.md | Visual architecture diagrams | 15 min |
| MONETIZATION_OPPORTUNITIES.md | All services & pricing | 30 min |
| CLAUDE.md | Developer guidance | 15 min |
| INDEX.md | Documentation index | 5 min |
Component READMEs: Each folder has detailed setup instructions.
| Phase | Component | Status |
|---|---|---|
| Phase 1 | ERC-8004 Extended Registries | ✅ DEPLOYED & VERIFIED |
| Phase 1 | GLUE Token | ✅ DEPLOYED & VERIFIED |
| Phase 1 | TransactionLogger | ✅ DEPLOYED & VERIFIED |
| Phase 1 | Token Distribution | ✅ COMPLETE (55,000 GLUE to each agent) |
| Phase 1 | x402 Facilitator | ⏸️ Ready (requires Rust nightly - using external facilitator) |
| Phase 2 | Validator Agent | ✅ COMPLETE |
| Phase 3 | Karma-Hello Agents | 🔴 To implement |
| Phase 4 | Abracadabra Agents | 🔴 To implement |
| Phase 5 | End-to-end Testing | ✅ COMPLETE (4/4 E2E tests passing) |
Current Phase: Phase 2 Complete - All tests passing (Unit, Integration, E2E) Last Updated: October 24, 2025
Utility scripts for managing wallets, tokens, and agent deployments:
Generate new EVM-compatible wallets for agents:
# Generate wallet and auto-save to .env
python scripts/generate-wallet.py client-agent --auto-save
# Generate for multiple agents
python scripts/generate-wallet.py client-agent-2 --auto-save
python scripts/generate-wallet.py validator-2 --auto-save
# Interactive mode (prompts before saving)
python scripts/generate-wallet.py my-agentFeatures:
- Creates Ethereum-compatible wallets (works on all EVM chains)
- Auto-saves private key and address to agent
.envfile - Shows security warnings and best practices
- Displays Fuji testnet info and next steps
- Reusable for unlimited agents
Distribute tokens (GLUE/UVD/etc.) to agent wallets:
cd erc-20
python distribute-token.pyFeatures:
- Automatically loads wallet addresses from agent
.envfiles - Configurable amounts (currently 55,000 GLUE for all agents)
- Supports any ERC-20 token (configure via UVD_TOKEN_ADDRESS in .env)
- Shows before/after balances
- Transaction links on Snowtrace
- Supports: validator, karma-hello-agent, abracadabra-agent, client-agent
Agents:
| Agent | Funded | Balance |
|---|---|---|
| Validator | ✅ | 55,000 GLUE |
| Karma-Hello | ✅ | 55,000 GLUE |
| Abracadabra | ✅ | 55,000 GLUE |
| Client-Agent | ✅ | 55,000 GLUE |
Complete infrastructure rotation for key compromise scenarios:
# Dry run (shows what would happen, makes no changes)
python scripts/rotate-system.py
# Execute actual rotation (requires confirmation)
python scripts/rotate-system.py --confirm
# Refill wallets with GLUE only (no rotation)
python scripts/rotate-system.py --refill
# Refill wallets with GLUE (execute)
python scripts/rotate-system.py --refill --confirm
# Rotate ERC-20 deployer wallet only (separate from agent rotation)
python scripts/rotate-system.py --rotate-erc20 --confirmWhat it does:
- 🔑 Generates new wallets for ALL agents (validator, karma-hello, abracadabra, client, voice-extractor, skill-extractor)
- ☁️ Updates AWS Secrets Manager with new private keys
- 📜 Redeploys ERC-20 GLUE token contract
- 🏛️ Redeploys ERC-8004 registries (Identity, Reputation, Validation)
- 📝 Updates all agent
.envfiles with new contract addresses - 💰 Funds all wallets with testnet AVAX (manual step)
- 🎁 Distributes GLUE tokens to all agents
- 📄 Updates MASTER_PLAN.md with new contract & wallet addresses
Use cases:
- 🚨 Key compromise: Rotate immediately if private keys are exposed
- 🔄 Clean reset: Start fresh with new infrastructure
- 🧪 Testing: Validate deployment automation
- 🎥 Post-stream: Rotate keys after public demonstrations
- 💰 Wallet refill: Top up agent wallets with GLUE tokens (use
--refillflag)
Safety:
⚠️ Requires--confirmflag to execute (defaults to dry-run)⚠️ Requires typing 'ROTATE' to confirm destructive changes⚠️ Invalidates ALL existing wallets and contracts- ✅ Safe dry-run mode shows exactly what would happen
Gas Funding:
- 💰 Need AVAX for gas? Use ERC-20 deployer wallet (stored in AWS Secrets Manager)
- 🔑 Access via
distribute-token.py(automatically fetches from AWS) ⚠️ ERC-20 deployer is NOT rotated by default (owns GLUE token contract)- 🔄 Rotate separately:
python scripts/rotate-system.py --rotate-erc20 --confirm
Example output:
STEP 1: Generating New Wallets
✓ validator-agent -> 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb9
✓ karma-hello-agent -> 0x95cED938F7991cd0dFcb48F0a06a40FA1aF46EBC
...
STEP 2: Updating AWS Secrets Manager
✓ Successfully updated AWS Secrets Manager
STEP 3: Deploying ERC-20 GLUE Token
✓ GLUE Token deployed: 0x1234...
... (continues through all 8 steps)
Idempotent pipeline to rebuild the entire 48-agent marketplace from chat logs:
# Full rebuild with all users (weekly update after new streams)
python scripts/rebuild_user_agent_marketplace.py --force
# Add 20 more users (expand from 48 to 68)
python scripts/rebuild_user_agent_marketplace.py --users 68 --force
# Just regenerate agent cards (after profile updates)
python scripts/rebuild_user_agent_marketplace.py --skip-extract --force
# Preview changes without executing
python scripts/rebuild_user_agent_marketplace.py --dry-run
# Process specific number of users
python scripts/rebuild_user_agent_marketplace.py --users 30What it does:
- 👤 Profile Extraction - Analyzes chat logs, extracts skills/interests/tools
- 🃏 Agent Card Generation - Converts profiles to A2A protocol cards with dynamic pricing
- 🚀 Agent Deployment - Creates 48 FastAPI agents with unique ports (9000-9047)
Features:
- ✅ Idempotent - Safe to run multiple times
- ✅ Incremental - Add more users without rebuilding everything
- ✅ Safe - Backs up existing data on
--force - ✅ Preserves wallets - Restores .env files with PRIVATE_KEY after rebuild
- ✅ Flexible - Skip individual steps with
--skip-*flags
Use cases:
- 📺 Weekly updates - Re-extract with new chat logs from recent streams
- 👥 Add users - Expand marketplace when new community members join
- 📊 Profile updates - Regenerate cards after longer engagement histories
- 🔄 Complete rebuild - Start fresh with all current data
Command-line options:
--users N- Process N users (default: all available)--skip-extract- Use existing profiles (skip Step 1)--skip-cards- Use existing agent cards (skip Step 2)--skip-deploy- Use existing deployments (skip Step 3)--force- Rebuild all (creates backups first)--dry-run- Preview without executing
Safety features:
⚠️ Non-destructive by default (won't overwrite existing files)⚠️ --forcecreates timestamped backups:user-profiles.backup.YYYYMMDD_HHMMSS/- ✅ Preserves agent .env files with wallet PRIVATE_KEY
- ✅ Shows build summary with statistics
Example output:
================================================================================
User Agent Marketplace - Build Pipeline
================================================================================
Step 1/3: Profile Extraction
Found 97 users in chat logs
Processing 48 users...
✅ Extracted 48 profiles
Step 2/3: Agent Card Generation
Loading 48 profiles...
✅ Generated 48 agent cards
Step 3/3: Agent Deployment
Creating 48 agent directories...
✅ Deployed 48 agents (ports 9000-9047)
================================================================================
Build Complete!
Profiles: 48 users
Agent Cards: 48 cards
Deployed Agents: 48 agents
Network Capacity: 2,256 potential trades
================================================================================
- Python 3.11+
- Rust latest stable
- Foundry (forge, anvil, cast)
- Node.js 18+ (optional, for frontend)
- AVAX on Fuji testnet (free from faucet)
- OpenAI API key (for CrewAI agents)
# Install Foundry
curl -L https://foundry.paradigm.xyz | bash
foundryup
# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
# Python 3.11+
python --version # Should be 3.11 or higherVisit https://faucet.avax.network/ and request AVAX for your wallet.
cd erc-20
cp .env.example .env
# Edit .env with your PRIVATE_KEY
./deploy-fuji.sh
cd ../erc-8004
./deploy-fuji.sh
cd ../x402-rs
cargo build --release
cargo runpython scripts/demo_system.pySee QUICKSTART.md for detailed instructions.
- Read MASTER_PLAN.md to understand the vision
- Check the roadmap for available tasks
- Implement following the architecture in ARCHITECTURE.md
- Write tests for all new code
- Submit PR with documentation
- ERC-8004 Base Spec: https://eips.ethereum.org/EIPS/eip-8004 (we extend this with bidirectional ratings!)
- A2A Protocol: https://ai.pydantic.dev/a2a/
- x402 Protocol: https://www.x402.org
- EIP-3009: https://eips.ethereum.org/EIPS/eip-3009
- CrewAI: https://docs.crewai.com/
- Avalanche Docs: https://docs.avax.network/ (our home chain!)
https://intensivecolearn.ing/en/programs/trustless-agents
TESTNET ONLY: This project is currently deployed on Avalanche Fuji testnet. Do not use with real funds. Smart contracts have not been audited.
For mainnet deployment:
- Smart contract audit by reputable firm
- Bug bounty program
- Timelock for admin functions
- Multi-sig for contract ownership
MIT License - See LICENSE
- Trustless Agents Course by Intensive CoLearning
- ERC-8004 Base Specification (which we extended for bidirectional reputation)
- x402-rs protocol implementation
- Pydantic AI A2A protocol
- Avalanche - our home blockchain and the foundation of Ultravioleta DAO
- Project: Ultravioleta DAO
- Repo: https://github.com/ultravioletadao/karmacadabra
- Docs: Start with QUICKSTART.md
Built with ❤️ by Ultravioleta DAO
Empowering autonomous AI agents to create a trustless data economy