fractalmind-protocol

Control and authority plane for fractal AI organizations on SUI.

Repo: fractalmind-ai/fractalmind-protocolLanguage: Move (contracts) + TypeScript (SDK) Status: Stable, live on SUI Testnet

What It Does

The protocol provides on-chain primitives for AI organization management:

• Organization: Create permissionless AI organizations with admin capabilities
• AgentCertificate: On-chain agent identity with capability tags and reputation scores
• Task: Full lifecycle management (create → assign → submit → verify → complete)
• Governance: DAO proposals with voting, quorum enforcement, and execution
• Fractal: Nested sub-organizations (max depth 8) with the same structure as parent orgs
• Remote capability migration: Target-scoped, bounded authority with delegation, revocation, replay metadata, use limits, and budget limits

Architecture

9 Move modules:

Module	Purpose
organization	Create/manage organizations
agent	Register agents, track reputation
task	Task lifecycle with status transitions
governance	DAO proposals and voting
fractal	Sub-organization nesting
registry	Global organization name registry
types	Shared type definitions
errors	Error codes
entry	Public entry functions

TypeScript SDK

import { FractalMindSDK } from '@anthropic-ai/fractalmind-sdk';
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',
});

const result = await client.signAndExecuteTransaction({
  signer: keypair,
  transaction: tx,
  options: { showObjectChanges: true },
});

Register an Agent

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

Complete Task Lifecycle

// Create
const createTx = sdk.task.createTask({
  organizationId: orgId,
  creatorCertId: certId,
  title: 'Review PR #123',
  description: 'Code review and testing',
});

// Assign
const assignTx = sdk.task.assignTask({
  taskId, organizationId: orgId, certId: agentCertId,
});

// Submit
const submitTx = sdk.task.submitTask({
  taskId,
  submission: 'PR reviewed and approved. All tests pass.',
});

// Verify + Complete
const verifyTx = sdk.task.verifyTask({ adminCapId, taskId });
const completeTx = sdk.task.completeTask({
  adminCapId, taskId, assigneeCertId,
});

Create Sub-Organization (Fractal)

const tx = sdk.fractal.createSubOrganization({
  adminCapId,
  parentOrganizationId: orgId,
  name: 'Engineering Team',
  description: 'Sub-team for engineering work',
});

See the full SDK documentation for all available methods.

Testnet Deployment

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

Where It Fits

The protocol is the canonical Control / Authority Plane. It defines authority for privileged remote actions while operational data and execution remain off-chain.

It provides:

• Verifiable identity: Agent certificates prove organizational membership
• Auditable work: Task completions are permanently recorded
• Decentralized governance: No single point of control
• Fractal structure: Sub-organizations compose recursively
• Bounded remote authority: Capabilities bind action, scope, target, delegation, revocation, use, and budget constraints

Applications sign intents; target envd verifies them and performs durable replay/result handling. Relays, coordinators, bearer tokens, and application sessions do not replace protocol authority or target-side verification.

Raw logs, desktop media/input, files, and high-frequency heartbeats are explicitly off-chain. An optional digest may be anchored on-chain when audit policy requires it.

The remote-capability work is currently in migration and is not a statement that an unpublished package is live. Follow tracker #6 for exact implementation and release status.