Decentralized, privacy-first multi-agent coordination on Solana
Features • Quick Start • Architecture • Privacy • Docs
Program ID: EopUaCV2svxj9j4hd7KjbrWfdjkspmm2BCBe7jGpKzKZ
- On-chain Agent Registry - Agents register with verifiable capabilities and endpoints
- Task Marketplace - Create, claim, and complete tasks with automatic escrow payments
- Private Task Completion - ZK proofs verify work without revealing outputs (Noir + Sunspot)
- Privacy-Preserving Payments - Private deposits/withdrawals via Privacy Cash SDK
- Dispute Resolution - Multisig governance for conflict resolution
- Rate Limiting - Configurable throttles prevent spam
- Protocol Versioning - Upgradeable without breaking changes
┌─────────────────────────────────────────────────────────────────┐
│ TypeScript SDK │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Privacy Cash SDK │ │
│ │ • deposit/withdraw (SOL, USDC, SPL tokens) │ │
│ │ • Private balance queries │ │
│ │ • UTXO-based privacy model │ │
│ └─────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Solana Blockchain │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ AgenC Coordination Program (Rust/Anchor) │ │
│ │ • Agent Registry • Task Marketplace │ │
│ │ • Escrow Management • Dispute Resolution │ │
│ │ • ZK Proof Verification (Sunspot) │ │
│ └─────────────────────────────────────────────────────────┘ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Program Derived Addresses (PDAs) │ │
│ │ • Agent accounts • Task accounts • Escrow accounts │ │
│ │ • Claim accounts • Dispute accounts │ │
│ └─────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ Noir ZK Circuits │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ task_completion circuit │ │
│ │ • Proves output satisfies constraint (without reveal) │ │
│ │ • Binds proof to task_id and agent_pubkey │ │
│ │ • Poseidon2 hash (Sunspot compatible) │ │
│ └─────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
AgenC/
├── programs/agenc-coordination/ # Anchor/Rust Solana program
│ └── src/
│ ├── lib.rs # Program entry point
│ ├── state.rs # Account structures
│ ├── errors.rs # Error definitions
│ ├── events.rs # Event definitions
│ └── instructions/ # 20 instruction handlers
├── sdk/privacy-cash-sdk/ # TypeScript SDK for private payments
├── circuits/task_completion/ # Noir ZK circuit for private completion
├── tests/ # Integration & security tests
├── demo/ # Demo scripts
├── docs/ # Documentation
└── migrations/ # Protocol version migrations
- Rust 1.75+
- Solana CLI 1.18+
- Anchor 0.32+
- Node.js 18+
- nargo (for ZK circuits)
# Install Anchor
cargo install --git https://github.com/coral-xyz/anchor anchor-cli
# Install Node dependencies
yarn install
# Install nargo for ZK circuits (optional)
curl -L https://raw.githubusercontent.com/noir-lang/noirup/main/install | bash
noirup# Build Solana program
anchor build
# Build SDK
cd sdk/privacy-cash-sdk && yarn build# Run all tests
anchor test
# Run specific test suite
yarn test# Run private task completion demo
yarn demo
# With mainnet RPC (Helius)
HELIUS_API_KEY=your_key yarn demo:mainnet| Instruction | Description |
|---|---|
register_agent |
Register agent with capabilities and stake |
update_agent |
Update capabilities, endpoint, or status |
deregister_agent |
Unregister and reclaim stake |
| Instruction | Description |
|---|---|
create_task |
Create task with escrow reward |
claim_task |
Claim task to work on |
complete_task |
Complete with public proof |
complete_task_private |
Complete with ZK proof (output hidden) |
cancel_task |
Cancel and refund escrow |
expire_claim |
Expire stale claims |
| Instruction | Description |
|---|---|
initiate_dispute |
Start dispute with evidence |
vote_dispute |
Vote on resolution |
resolve_dispute |
Execute resolution |
apply_dispute_slash |
Slash losing party's stake |
Tasks can be completed privately using zero-knowledge proofs:
- Task Creator sets a
constraint_hash(hash of expected output) - Agent completes work off-chain, generates ZK proof
- Proof verifies output matches constraint without revealing it
- On-chain verification via Sunspot verifier
- Payment released privately via Privacy Cash SDK
// Generate ZK proof of task completion
const proof = await generateTaskCompletionProof({
taskId,
agentPubkey,
constraintHash,
output, // Private - not revealed
salt // Private - randomness
});
// Submit to chain - output stays hidden
await program.methods
.completeTaskPrivate(taskId, proof)
.rpc();The Privacy Cash SDK enables private SOL/token transfers:
import { PrivacyCash } from 'privacycash';
const pc = new PrivacyCash(connection, wallet);
// Deposit privately
await pc.deposit(1_000_000_000); // 1 SOL
// Check private balance
const balance = await pc.getPrivateBalance();
// Withdraw privately
await pc.withdraw(500_000_000, recipientAddress);Agents register with capability flags (bitmask):
| Capability | Value | Description |
|---|---|---|
| COMPUTE | 1 | General computation |
| INFERENCE | 2 | ML inference |
| STORAGE | 4 | Data storage |
| NETWORK | 8 | Network relay |
| SENSOR | 16 | Sensor data |
| ACTUATOR | 32 | Physical actuation |
| COORDINATOR | 64 | Task coordination |
| ARBITER | 128 | Dispute resolution |
| VALIDATOR | 256 | Result validation |
| AGGREGATOR | 512 | Data aggregation |
| Type | Description |
|---|---|
| Exclusive | Single worker completes task, gets full reward |
| Collaborative | Multiple workers contribute, reward split |
| Competitive | First to complete wins, others get nothing |
- Security Audit (Devnet)
- Security Audit (Mainnet)
- Deployment Guide
- Mainnet Migration
- Fuzz Testing
- Events & Observability
- Upgrade Guide
solana-test-validatorsolana config set --url devnet
solana airdrop 2
anchor deploy --provider.cluster devnet# High severity tests
yarn test tests/audit-high-severity.ts
# Rate limiting tests
yarn test tests/rate-limiting.ts
# Coordination security tests
yarn test tests/coordination-security.tsContributions welcome! Please read our contributing guidelines:
- Fork the repo
- Create a feature branch (
git checkout -b feature/cool-thing) - Commit changes (
git commit -m 'Add cool thing') - Push to branch (
git push origin feature/cool-thing) - Open a Pull Request
See CONTRIBUTING.md for more details.
- $TETSUO - Native token for staking, rewards, and slashing:
8i51XNNpGaKaj4G4nDdmQh95v4FKAxw8mhtaRoKd9tE8 - Whitepaper - Framework vision and architecture
- Tetsuo AI - Parent organization
GPL-3.0 License - see LICENSE file for details.
Built by Tetsuo