ritual-dapp-da

Describe data availability storage patterns for Ritual dApps using StorageRef pointers and encryptedSecrets.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Data Availability (storage) patterns provide a standardized approach for keeping large blobs off-chain while preserving secure, verifiable on-chain orchestration for Ritual dApps. This skill guides developers on how to store and retrieve external data such as multimodal outputs, conversation histories, agent state, FHE ciphertexts, and artifact files, ensuring storage is managed by providers like GCS, HF, and Pinata and accessed via StorageRef pointers.

Core Features & Use Cases

  • Credential-driven storage guidance: how to configure encryptedSecrets and storage credentials across platforms (GCS, HF, Pinata) to enable secure data I/O.
  • Unified StorageRef model: using StorageRef triplets (platform, path, keyRef) to point to off-chain data and integrate with precompiles.
  • DKMS considerations for agents: per-sender encryption for sovereign/persistent agents and when to use DKMS-encrypted content.
  • Error handling and DA lifecycle: how failures are reported on-chain and how to recover.

Quick Start

Consult this skill to design and implement data availability storage patterns for Ritual dApps.

Frequently Asked Questions about ritual-dapp-da

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

FAQPage Schema
How do I manage off-chain data availability for Ritual dApps?

Manage off-chain data availability for Ritual dApps by using StorageRef triplets to point to external storage platforms like GCS, HF, and Pinata, while preserving secure on-chain orchestration. This skill guides how to store and retrieve large blobs off-chain.

What is a StorageRef pointer and how does it work with precompiles?

A StorageRef pointer is a triplet containing platform, path, and keyRef used to reference off-chain data. It integrates with precompiles to allow Ritual dApps to securely access large blobs stored externally without keeping the full payload on-chain.

How do I configure encryptedSecrets and storage credentials across GCS, HF, and Pinata?

Configure encryptedSecrets and storage credentials by setting up platform-specific authentication for GCS, HF, and Pinata. This enables secure data I/O for your Ritual dApp, ensuring off-chain storage providers can verify access to stored blobs.

When do I need DKMS encryption for agent state in Ritual dApps?

Use DKMS encryption for agent state when implementing sovereign or persistent agents that require per-sender encryption. This ensures conversation histories and agent state remain securely isolated per user.

How are data availability failures reported on-chain and how do I recover?

Data availability failures are reported on-chain through robust error handling mechanisms within precompiles. This skill outlines how to detect these failure states and implement recovery procedures for DA lifecycle management.