ritual-foundation/ritual-dapp-skills

ritual-dapp-skills

Skills and agents that teach AI coding assistants how to build dApps on Ritual.

---

Quick Start

# Claude Code
/plugin marketplace add ritual-foundation/ritual-dapp-skills

# Then tell your agent:
Read the file skills/ritual/SKILL.md and follow its instructions.

WALLET: 0xYOUR_FUNDED_WALLET_ADDRESS_DAPP_CAN_BE_DEPLOYED_FROM

Build me a chatbot that runs on-chain with streaming responses.

For Cursor, OpenClaw, Hermes, and other harnesses, see the microsite.

---

How It Works

The system has two entry points, three skill classes, and 10 behavioral protocols running as background middleware.

You describe what you want. The agent activates its behavioral protocols, loads the right skills, builds in phases, verifies each phase, and debugs automatically.

Entry Points

Three Skill Classes

Ω Meta — Loaded unconditionally. 10 behavioral rules, inspiration (JIT idea generation from live trends), projection (idea-to-Ritual-spec transformation), verification (per-skill checks + 12-step E2E journey).

α Build — Feature skills loaded conditionally per the user’s goal. The builder agent selects 3-6 per project. Phased execution: architecture → contracts → frontend → backend → testing → deploy.

β Debug — Diagnostic skills loaded reactively. Sequential pipeline: triage → smoke tests → quick-match 10 known root causes → systematic diagnosis → fix + verify.

10 Behavioral Rules

---

Agents

---

Skills

For persistent Hermes application connections, read Agent Link: HTTP long polling, full-duplex WebSocket, streamed events, cancellation, approvals, and recovery.

Meta Protocols (Ω)

Architecture & Reference (Ω)

Precompile Features (α)

Smart Contracts (α)

Full-Stack (α)

---

Build Execution Trace

When you say “build me X,” the agent reads files in this order:

Progress is checkpointed to .ritual-build/progress.json after each phase.

---

Works With

Recommended Combinations

• Claude Code + Opus 4.7 Max
• Cursor + Codex 5.3 Extra High

Other combinations work but your mileage may vary.

---

Chain Reference

The table below lists the live chain-784 system contracts. On a local network, the node’s generated configuration is authoritative. Applications must verify eth_chainId and non-empty bytecode at configured system addresses before use.

RITHTTP1 versioned examples

The included RITHTTP1 example targets executor PR #247 at 75c04e3. It encodes the current four-field input-ref/output-pipe request and decodes indexed RITOUT1 encoding-4 results. Public usage, private selected live frames and independently encrypted DA collections can share one response.

Read the wire reference and private-I/O reference, then run the Bun/Foundry examples before deploying. Old five/six-field RITHTTP1 requests and global encryption flags are incompatible with this revision; non-prefixed HTTP remains unchanged. Deployment addresses and registry membership do not establish executor protocol support. Resolve application routes and registered encryption keys from the target deployment, pin a compatible executor, and preserve that executor binding for secret-backed requests.

The earlier Consencia deployment snapshot was removed because it described an older interface and a separate network’s temporary addresses. The local examples and their pinned upstream provenance are the protocol reference; they make no claim that an arbitrary live deployment runs this revision.

---

Directory Structure

ritual-dapp-skills/
├── skills/
│   ├── ritual/                         # Ω — Human front door
│   ├── ritual-dapp-overview/           # Ω — Architecture + TEE-EOVMT
│   ├── ritual-dapp-precompiles/        # Ω — ABI reference (16 precompiles)
│   ├── ritual-dapp-deploy/             # α — Chain config + deployment
│   ├── ritual-dapp-design/             # α — Design system
│   ├── ritual-dapp-contracts/          # α — Solidity patterns
│   ├── ritual-dapp-wallet/             # α — Fee management
│   ├── ritual-dapp-http/               # α — HTTP precompile (0x0801)
│   ├── ritual-dapp-llm/                # α — LLM precompile (0x0802)
│   ├── ritual-dapp-agents/             # α — Agent precompiles (0x0820/0x080C)
│   ├── ritual-dapp-agent-link/         # α — Hermes application HTTP/WebSocket protocol
│   ├── ritual-dapp-longrunning/        # α — Long-running HTTP (0x0805)
│   ├── ritual-dapp-multimodal/         # α — Image/Audio/Video (0x0818-0x081A)
│   ├── ritual-dapp-ed25519/            # α — Ed25519 verification (0x0009)
│   ├── ritual-dapp-scheduler/          # α — Scheduled operations
│   ├── ritual-dapp-secrets/            # α — Secret management + PII redaction
│   ├── ritual-dapp-x402/               # α — Micropayments
│   ├── ritual-dapp-passkey/            # α — Passkey authentication
│   ├── ritual-dapp-frontend/           # α — React/Next.js frontend
│   ├── ritual-dapp-backend/            # α — Backend services
│   ├── ritual-dapp-testing/            # α/β — Testing patterns
│   ├── ritual-meta-bootstrap/          # Ω — 10 behavioral rules
│   ├── ritual-meta-inspiration/        # Ω — JIT idea generation
│   ├── ritual-meta-projection/         # Ω — Idea → Ritual-native spec
│   ├── ritual-meta-elicitation/        # Ω — Lazy goal-state variance reduction
│   ├── ritual-meta-orchestrator/       # Ω — Build-debug interleaving
│   ├── ritual-meta-circuit-breaker/    # Ω — Trajectory divergence detection
│   ├── ritual-meta-human-in-loop/      # Ω — Mid-session fork elicitation
│   ├── ritual-meta-non-interactive-bias/ # Ω — Search before asking
│   └── ritual-meta-verification/       # Ω — Verification protocols
├── agents/
│   ├── ritual-dapp-builder.md          # α — Build orchestrator
│   ├── ritual-dapp-debugger.md         # β — Debug orchestrator
│   └── debugger-reference/             # β — Diagnostic pipeline
├── site/                               # Microsite (deployed to Cloud Run)
├── assets/                             # SVG diagrams
├── examples/
│   ├── persistent-agent/             # Persistent Agent (0x0820) e2e flow
│   ├── sovereign-agent/              # Sovereign Agent (0x080C) e2e flow
│   ├── README.md
│   └── registry.json
├── templates/
│   ├── nextjs-starter/
│   └── hardhat-starter/
└── scripts/
    ├── pull_contracts.py
    └── verify_svgs.py

---

SVG Verification

If README diagrams fail to render:

python3 scripts/verify_svgs.py

Full protocol: SVG_VERIFICATION_PROTOCOL.md

---

Scheduled Async Debugging Utilities

For scheduled/scheduled-async tracing, use the embedded runnable Python snippets in: agents/debugger-reference/scheduled-async-rpc-runbook.md

That runbook includes:

• deterministic scheduled-hash derivation utility
• commitment-lookup utility from async origin hashes

---

Docs · Ritual Chain · Explorer · Microsite