IQDB On-Chain Storage

⛓️ Solana 原生链上数据库与隐私编码方案

基于 Solana 的链上关系型数据库方案,提供 CRUD 操作、防篡改哈希链、韩语编码隐私保护及付费文件铭文功能,适合需要链上持久化存储的开发者。

收藏
6.1k
安装
1.8k
版本
0.1.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

IQDB On-Chain Storage 是一套构建于 Solana 区块链之上的关系型数据库技术栈,由 IQ Labs 开发,包含三个核心组件:

IQDB 是主数据库引擎,通过 Anchor PDAs(程序派生地址)实现完整的 CRUD 操作。开发者可创建数据库根节点(Root PDA)、定义表结构(Table PDA),并以 JSON 字符串形式写入行数据。数据采用追加模式存储,配合滚动 Keccak 哈希链实现防篡改历史追溯。

hanLock 提供轻量级隐私保护,基于密码的韩语音节编码(base-11172),零依赖实现数据混淆。适合对敏感字段进行链上编码存储。

x402 实现 HTTP 402 支付网关机制,支持 USDC/SOL 付费后将文件分块铭文到 Solana 链上,形成付费存储商业模式。

显著优点

1. 原生 Solana 集成:深度利用 PDA 账户模型,无需额外共识层,读写延迟低至秒级
2. 防篡改审计:滚动哈希链设计 keccak(domain || prev_hash || tx_data),任何历史修改都会导致哈希断裂

3. 双 SDK 支持:新版官方 SDK (@iqlabs-official/solana-sdk) 支持主网,遗留 SDK 兼容开发网

4. 成本可控:创建根节点+3表+5行数据约需 0.09 SOL,按当前币价约 $15-20

5. 无服务器读取:读操作完全免费,仅依赖 RPC 查询

潜在局限

  • 严格容量限制:单行 JSON 须控制在 ~100 字节以内,TxTooLong 错误常见
  • 追加语义复杂性writeRow 纯追加,更新/删除需通过 pushInstruction 写入指令日志,应用层需自行合并计算最终状态
  • ESM 兼容问题:SDK 内部使用动态 require(),必须使用 CommonJS 或 .cjs 文件
  • hanLock 膨胀率:编码后数据体积约 3 倍,进一步压缩有效载荷
  • RPC 依赖风险:公共节点速率限制严格,生产环境需配置 Helius/Alchemy/QuickNode 等付费 RPC

适合人群

  • 构建链上游戏的开发者(角色状态、道具所有权持久化)
  • 需要合规审计日志的企业(呼叫中心记录、治理提案)
  • 探索付费存储商业模式的创作者(x402 铭文)
  • 熟悉 Solana 开发、能接受容量约束的技术团队

常规风险

| 风险类型 | 描述 |
|---------|------|
| 数据丢失 | PDA 租金耗尽导致账户回收,需监控租金余额 |
| 哈希链断裂 | 若直接操作账户数据绕过 SDK,将破坏完整性证明 |
| 隐私泄露 | hanLock 仅为编码非加密,密码强度不足可暴力破解 |
| 主网合约风险 | Program ID `9KLLchQVJpGkw4jPuUmnvqESdR7mtNCYr3qS4iQLabs` 未经验证的开源审计 |
| 费率波动 | Solana 网络拥堵时交易费用可能显著上升 |

IQDB On-Chain Storage 内容

references文件夹
手动下载zip · 13.1 kB
hanlock.mdtext/markdown
请选择文件