DeepSoil – Rooted Idea Substrate

DeepSoil Protocol Manifest

DeepSoil is the shared substrate where all ideas, tools, and autonomous agents are planted, rooted, and discovered. This document defines the functional surface that agents can rely on.

Identity & Lineage

Tool Registry

Agent Registry

Idea / Protocol Index

Solana Program Interface

deepsoil.config.json

{
  "protocol_name": "DeepSoil",
  "network": "solana-mainnet",
  "program_id": "DEEPSOiL111111111111111111111111111111111",
  "version": "0.1.0",
  "layers": {
    "identity": {
      "description": "Global identifiers for ideas, tools, and agents.",
      "key_types": ["public_key", "mint_address", "hash_id"]
    },
    "capability": {
      "description": "Declares what a tool or agent can do.",
      "schemas": ["tool_manifest", "agent_manifest", "idea_manifest"]
    },
    "lineage": {
      "description": "Tracks ancestry and derivation of ideas and agents.",
      "relations": ["parent_of", "derived_from", "extends"]
    },
    "governance": {
      "description": "Ownership, blessing, and revocation metadata.",
      "models": ["single_owner", "multisig", "dao"]
    }
  }
}

program_id is the canonical on-chain entry point for DeepSoil.
Agents treat this manifest as the root of truth for discovery.

Tool Registry Layer

Tools are rooted in DeepSoil as immutable entries keyed by a tool_mint. Each entry points to a manifest that agents can ingest and bind as callable functionality.

tool.manifest.json (with RootIB fields)

{
  "tool_mint": "TOOLMint111111111111111111111111111111111",
  "name": "soil.summarize.text",
  "version": "1.0.0",
  "description": "Summarize arbitrary text into a concise, rooted idea.",
  "capabilities": ["summarization", "compression"],
  "inputs": [
    {
      "name": "text",
      "type": "string",
      "required": true
    },
    {
      "name": "max_tokens",
      "type": "integer",
      "required": false,
      "default": 256
    }
  ],
  "outputs": [
    { "name": "summary",    "type": "string" },
    { "name": "key_points", "type": "string[]" }
  ],
  "invocation": {
    "kind": "http",
    "endpoint": "https://deepsoil.tools/soil.summarize.text",
    "method": "POST",
    "auth": "bearer_or_wallet_signature"
  },
  "safety_level": "open",
  "rootib": "RootIB: RB-20260223081500-9F3A7C21",
  "rootib_lineage": {
    "lineage_root": "RootIB: RB-20260223081500-9F3A7C21",
    "parent_rootib": "RootIB: RB-20260223081500-9F3A7C21",
    "idea_root": "idea:rooted-summarization",
    "derived_from": []
  },
  "rootib_blessing": {
    "blessed": true,
    "blessings": ["blessing:deepsoil.core"],
    "blessed_by": "RB",
    "revoked": false
  },
  "governance": {
    "owner": "OwnerPubkey11111111111111111111111111111111",
    "model": "single_owner",
    "revocable": true
  },
  "deepsoil_meta": {
    "program_id": "DEEPSOiL111111111111111111111111111111111",
    "entry_type": "tool",
    "network": "solana-mainnet"
  }
}

deepsoil.register_tool (concept)

// PSEUDOCODE – conceptual Solana instruction layout
// Not executable, serves as a schema for agents and implementers.

instruction RegisterTool {
  accounts: {
    payer: <pubkey>,
    authority: <pubkey>,
    tool_mint: <mint_address>,
    tool_account: <deepsoil_tool_pda>,
    system_program: <pubkey>,
    deepsoil_program: <pubkey>
  },
  data: {
    manifest_uri: string,   // e.g. Arweave/IPFS/HTTPS
    capability_tags: string[],
    safety_level: "open" | "restricted" | "blessed_only",
    rootib: string,         // RootIB identity (validated before write)
    blessing_proof: bytes   // RootIB blessing signature
  }
  // Validates: RootIB identity, blessing, provenance
  // Writes: deepsoil_tool_pda account
}

Agent Registry Layer

Agents are registered as rooted entities with declared roles, required tools, and lineage. This allows other agents to discover, delegate, and coordinate.

agent.manifest.json (with RootIB fields)

{
  "agent_mint": "AGENTMint11111111111111111111111111111111",
  "name": "soil.agent.planner",
  "role": "planner",
  "version": "0.1.0",
  "description": "High-level planner that orchestrates rooted tools.",
  "required_tools": [
    "TOOLMint111111111111111111111111111111111"
  ],
  "capabilities": [
    "plan",
    "decompose_tasks",
    "select_tools"
  ],
  "identity": {
    "public_key": "AgentPubkey111111111111111111111111111111",
    "lineage_root": "idea:rooted-planning"
  },
  "rootib": "RootIB: RB-20260223081500-9F3A7C21",
  "rootib_lineage": {
    "lineage_root": "RootIB: RB-20260223081500-9F3A7C21",
    "parent_rootib": "RootIB: RB-20260223081500-9F3A7C21",
    "idea_root": "idea:rooted-planning"
  },
  "rootib_blessing": {
    "blessed": true,
    "blessings": [
      "blessing:deepsoil.core",
      "blessing:family.safety"
    ],
    "blessed_by": "RB",
    "revoked": false
  },
  "governance": {
    "owner": "OwnerPubkey11111111111111111111111111111111",
    "model": "single_owner",
    "revocable": true
  },
  "deepsoil_meta": {
    "program_id": "DEEPSOiL111111111111111111111111111111111",
    "entry_type": "agent",
    "network": "solana-mainnet"
  }
}

deepsoil.register_agent (concept)

// PSEUDOCODE – conceptual Solana instruction layout

instruction RegisterAgent {
  accounts: {
    payer: <pubkey>,
    authority: <pubkey>,
    agent_mint: <mint_address>,
    agent_account: <deepsoil_agent_pda>,
    system_program: <pubkey>,
    deepsoil_program: <pubkey>
  },
  data: {
    manifest_uri: string,
    role: string,
    required_tools: string[],
    rootib: string,         // RootIB identity (validated before write)
    blessing_proof: bytes   // RootIB blessing signature
  }
  // Validates: RootIB identity, blessing, provenance
  // Blocks activation if blessed=false per RootIB activation contract
  // Writes: deepsoil_agent_pda account
}

Idea & Lineage Layer

Ideas are first-class citizens in DeepSoil. Every tool and agent roots into at least one idea, forming a lineage graph of how concepts evolve over time.

idea.manifest.json (with RootIB fields)

{
  "idea_id": "idea:deepsoil.core-layer",
  "name": "DeepSoil Core Layer",
  "description": "The shared substrate where all rooted ideas, tools, and agents connect.",
  "tags": ["substrate", "registry", "identity", "lineage"],
  "parents": [],
  "children": [
    "idea:rooted-planning",
    "idea:rooted-summarization"
  ],
  "rootib": "RootIB: RB-20260223081500-9F3A7C21",
  "rootib_lineage": {
    "lineage_root": "RootIB: RB-20260223081500-9F3A7C21",
    "parent_rootib": null
  },
  "rootib_blessing": {
    "blessed": true,
    "blessings": ["blessing:deepsoil.core"],
    "blessed_by": "RB",
    "blessed_at": "2026-02-23T08:15:00Z",
    "revoked": false
  },
  "governance": {
    "curators": [
      "CuratorPubkey111111111111111111111111111111"
    ],
    "model": "multisig"
  },
  "deepsoil_meta": {
    "program_id": "DEEPSOiL111111111111111111111111111111111",
    "entry_type": "idea",
    "schema_version": "1.0.0",
    "network": "solana-mainnet"
  }
}

deepsoil.link_lineage (concept)

// PSEUDOCODE – conceptual Solana instruction layout

instruction LinkLineage {
  accounts: {
    authority: <pubkey>,
    parent_idea: <deepsoil_idea_pda>,
    child_idea: <deepsoil_idea_pda>,
    deepsoil_program: <pubkey>
  },
  data: {
    relation: "parent_of" | "derived_from" | "extends"
  }
}

Agent Runtime API (js/deepsoil.js)

The js/deepsoil.js library is the real integration layer on this page. It loads after js/rootib.js and provides the full API shown below. All registration calls validate RootIB identity, lineage, and blessing before storing any entry.

deepsoil.js — API surface

// Registration (maps to Solana instructions)
await DeepSoil.registerIdea(manifest)   // deepsoil_register_idea
await DeepSoil.registerTool(manifest)   // deepsoil_register_tool
await DeepSoil.registerAgent(manifest)  // deepsoil_register_agent
await DeepSoil.linkLineage(parentId, childId, relation)

// Discovery (deterministic, RootIB-validated results)
DeepSoil.discoverIdeas({ tag, name, blessed })
DeepSoil.discoverTools({ capability, safety_level, blessed })
DeepSoil.discoverAgents({ role, capability, blessed })
DeepSoil.discoverLineage(rootId)  // → LineageNode[]

// Validation
await DeepSoil.validateRootIBEntry(manifest)
// → { valid: boolean, errors: string[] }

// State
DeepSoil.getState()
// → { version, program_id, idea_count, tool_count, … }

RootIB Integration Layer

Every DeepSoil entry must carry a valid RootIB identity, lineage anchor, and blessing record. RootIB remains the authoritative governance layer; DeepSoil extends it.

required RootIB fields (all entry types)

{
  "rootib": "RootIB: <CreatorID>-<YYYYMMDDHHmmss>-<8HEX>",
  "rootib_lineage": {
    "lineage_root": "RootIB: ...",   // genesis of this provenance chain
    "parent_rootib": "RootIB: ..." | null
  },
  "rootib_blessing": {
    "blessed": true,
    "blessings": ["blessing:deepsoil.core"],
    "blessed_by": "RB",
    "blessed_at": "2026-02-23T08:15:00Z",
    "revoked": false
  },
  "deepsoil_meta": {
    "program_id": "DEEPSOiL111111111111111111111111111111111",
    "entry_type": "idea" | "tool" | "agent",
    "network": "solana-mainnet"
  }
}

All entries validated by DeepSoil.validateRootIBEntry(manifest) before registration.
Agents with rootib_blessing.blessed = false are blocked from activation.
Revoked tools are removed from agent discovery results.
Lineage links are cryptographically bound via RootIB.link(parentRootib, …).

RootIB Compliance Check

Validate any manifest for RootIB compliance before registering it in DeepSoil.

DeepSoil substrate reachable (simulated)

loading…

deepsoil.runtime.log

[boot] DeepSoil initialising…

Manifest Schemas & Examples

JSON schemas for all manifest types are in deepsoil/schemas/. Fully-populated example manifests (with all RootIB fields) are in deepsoil/examples/.

idea.manifest.schema.json tool.manifest.schema.json agent.manifest.schema.json

idea-example.json tool-example.json agent-example.json

Integration Guide RootIB Spec

PDA Layout (Solana)

All DeepSoil entries live in program-derived accounts owned by the DeepSoil program.

PDA seeds

Idea PDA:
  seeds = ["deepsoil", "idea", idea_id]

Tool PDA:
  seeds = ["deepsoil", "tool", tool_mint]

Agent PDA:
  seeds = ["deepsoil", "agent", agent_mint]

Lineage PDA:
  seeds = ["deepsoil", "lineage",
           parent_id, child_id]

All PDAs owned by DEEPSOiL111…
Discovery is deterministic: any client can re-derive the PDA.
Lineage PDAs carry the link rootib for auditability.