ritual-dapp-agents

Deploy deterministic on-chain AI agents via Ritual Chain factories with DKMS identity.

62|56|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/ritual-foundation/ritual-dapp-skills --skill ritual-dapp-agents
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ritual-dapp-agents
Source: https://github.com/ritual-foundation/ritual-dapp-skills/tree/main/skills/ritual-dapp-agents
Command: npx skills add https://github.com/ritual-foundation/ritual-dapp-skills --skill ritual-dapp-agents

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Persistent and sovereign agent patterns for Ritual dApps give developers reliable, on-chain AI agents—long-lived services and one-off jobs—that operate directly within Ritual Chain environments. These patterns enable deterministic deployment, state continuity, secure secret handling, and orchestrated task execution via precompiles and harnesses.

Core Features & Use Cases

  • Two precompile primitives: Persistent Agent (0x0820) and Sovereign Agent (0x080C), each enabling on-chain AI execution with different lifecycles.
  • Factory-backed deployment and deterministic child contracts via SovereignAgentFactory and PersistentAgentFactory to manage lifecycles and ownership.
  • On-chain orchestration of agent tasks with built-in DKMS identity, conformance to SovereignAgentParams, and rolling/horizon scheduling for reliable async results.
  • Real-world use: deploy long-running AI services or run powerful, single-shot agent jobs that produce artifacts and convo history on Ritual Chain.

Quick Start

Read the SKILL.md and follow its factory-based deployment steps to launch a sovereign or persistent agent workflow on Ritual Chain.

Frequently Asked Questions about ritual-dapp-agents

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy on-chain AI agents using Solidity factory contracts?

On-chain AI agents are deployed using SovereignAgentFactory and PersistentAgentFactory contracts, which provide deterministic child contract creation via predictHarness and deployHarness methods. This ensures reliable state continuity and secure lifecycle management for Ritual Chain environments.

What is the difference between persistent and sovereign AI agents on-chain?

Persistent agents (precompile 0x0820) operate as long-lived services, whereas sovereign agents (precompile 080C) handle single-shot task jobs. Both execute on-chain AI workflows but differ in lifecycle management, with sovereign agents utilizing DKMS-backed identity for autonomous execution.

How do I handle secrets and gas estimates for on-chain AI agent deployment?

Secret handling and gas estimates are managed through robust preflight checks built into the agent deployment harness. These checks validate explicit agent parameters and YAML frontmatter entries before executing deterministic factory deployment on Ritual Chain.

Can I run ephemeral AI task jobs on-chain with deterministic deployment?

Yes, sovereign agent workflows support ephemeral task jobs through single-shot execution that produces artifacts and conversation history on Ritual Chain. Deployment is deterministic via factory contracts, ensuring predictable child contract addresses and secure async task orchestration.

Do I need YAML frontmatter to configure on-chain AI agent parameters?

YAML frontmatter entry is required to define explicit agent parameters for on-chain AI execution. This configuration ensures conformance to SovereignAgentParams and enables proper rolling and horizon scheduling for reliable asynchronous results on Ritual Chain.