iqdb-onchain-storage

What This Skill Does

The iqdb-onchain-storage skill integrates the IQ Labs tech stack into your OpenClaw agent, enabling robust interaction with Solana-based persistent storage solutions. This skill manages three distinct core protocols: IQDB for full CRUD relational database operations via Anchor PDAs, hanLock for secure password-based Hangul syllabic encoding, and x402 for payment-gated file inscription. It is designed for developers who need to move data management from centralized servers to the immutable, tamper-evident environment of the Solana blockchain, leveraging rolling keccak hashes and HTTP 402 protocols for high-integrity storage applications.

Installation

To integrate this skill into your agent, run the following command in your terminal:

clawhub install openclaw/skills/skills/emanz1/iqdb

Ensure your development environment has Node.js 18+ and the Solana CLI installed. Depending on your target network, you will need to install either the current @iqlabs-official/solana-sdk for mainnet operations or the legacy @iqlabsteam/iqdb package for devnet-specific testing. For production deployments, ensure your anchor keypair is properly configured via the ANCHOR_WALLET environment variable.

Use Cases

This skill is ideal for building decentralized applications that require persistent, verifiable records. Common use cases include:

1. On-chain relational databases for game state storage or player statistics.
2. Private data storage using password-encoded Hangul syllabic strings to obfuscate on-chain content.
3. Paid inscription services where users pay in SOL or USDC to have files inscribed on-chain, utilizing the x402 payment-gated architecture.
4. Audit trails where rolling hashes are required to verify the integrity of a series of database transactions.

Example Prompts

1. "Initialize a new IQDB table named 'user_inventory' on Solana mainnet and save the current item list from this JSON object."
2. "Use hanLock to encode the following private string using the password 'secretKey123' and store the resulting data in my existing PDA."
3. "Set up an x402 payment gate for a new file upload, requiring a 0.5 USDC fee for users to register their inscription on the blockchain."

Tips & Limitations

When working with public Solana RPCs, be aware of aggressive rate limiting; it is highly recommended to use a dedicated provider like Helius or QuickNode for production-level traffic to avoid transaction failures. For the legacy SDK, ensure that your NETWORK_URL and ANCHOR_PROVIDER_URL are identical to prevent synchronization errors between read and write connections. Always handle your private keypair files with extreme caution. The IQDB system is designed for high-integrity small-to-medium datasets; for massive unstructured binary blobs, consider using this skill to store the resulting URI hashes rather than the raw file data itself.