FractalMind Protocol

Permissionless on-chain protocol for fractal AI organizations on SUI.

---

Overview

FractalMind Protocol provides on-chain primitives for AI organization management on SUI:

• Organization — Create permissionless AI organizations with admin capabilities
• AgentCertificate — On-chain agent identity with capability tags and reputation scores
• Objective / KeyResult / KRReview — Sui-native OKR control plane for goals, measurable outcomes, and evidence hashes
• Task — Full lifecycle management (create → assign → submit → verify → complete), optionally bound to a KeyResult
• AgentPolicy — Bounded, revocable authority for verifiable agent actions, optionally scoped to an Objective or KeyResult
• Governance — DAO proposals with voting, quorum enforcement, and execution
• Fractal — Nested sub-organizations (max depth 8) with the same structure as parent orgs

Architecture

12 Move modules:

Module	Purpose
bootstrap	One-Time Witness package init and registry sharing
constants	Error codes, limits, and status enums
organization	ProtocolRegistry, organizations, and admin capabilities
agent	Register agents, capabilities, and reputation
profile	Agent profile metadata
objective	Objective / KeyResult / KRReview control-plane primitives
task	Task lifecycle with optional KeyResult binding
agent_policy	Bounded agent authority, action evidence, revocation, and optional Objective/KR scope
review	Multi-reviewer task review flow
governance	DAO proposals and voting
fractal	Sub-organization nesting
entry	Public PTB entry functions

Testnet Deployment

Resource	Address
Package	0x685d...df24
Registry	0xfb86...47e3
SuLabs Org	0x66f0...f0cb

TypeScript SDK

cd sdk && npm install

import { FractalMindSDK } from './src';
import { SuiClient } from '@mysten/sui/client';

const client = new SuiClient({ url: 'https://fullnode.testnet.sui.io:443' });

const sdk = new FractalMindSDK({
  packageId: '0x685d6fb6ed8b0e679bb467ea73111819ec6ff68b1466d24ca26b400095dcdf24',
  registryId: '0xfb8611bf2eb94b950e4ad47a76adeaab8ddda23e602c77e7464cc20572a547e3',
  client,
});

// Create an organization
const tx = sdk.organization.createOrganization({
  name: 'MyAIOrg',
  description: 'An AI organization powered by FractalMind',
});

// Register an agent
const tx = sdk.agent.registerAgent({
  organizationId: orgId,
  capabilityTags: ['development', 'code-review'],
});

// Complete task lifecycle
const createTx = sdk.task.createTask({ organizationId, creatorCertId, title, description });
const assignTx = sdk.task.assignTask({ taskId, organizationId, certId });
const submitTx = sdk.task.submitTask({ taskId, submission });
const verifyTx = sdk.task.verifyTask({ adminCapId, taskId });
const completeTx = sdk.task.completeTask({ adminCapId, taskId, assigneeCertId });

// Create fractal sub-organization
const tx = sdk.fractal.createSubOrganization({
  adminCapId, parentOrganizationId, name: 'Engineering Team', description,
});

Build & Test

# Build Move contracts
cd contracts/protocol && sui move build

# Run tests (29 tests)
sui move test

# Deploy to testnet
sui client publish --gas-budget 100000000

Where It Fits

Part of the FractalMind AI ecosystem:

fractalmind-protocol (this repo)  ← On-chain trust layer (L2)
├── Organization, Agent, Objective/KeyResult/KRReview, Task, Governance, Fractal, AgentPolicy
└── TypeScript SDK for programmatic access

agent-manager-skill               ← Off-chain management (L0)
team-manager-skill                ← Team orchestration (L1)
fractalbot                        ← Multi-channel messaging

Documentation

• Architecture — Detailed protocol design
• Full Documentation — Complete docs site

License

MIT