provenance (Datafund)

数据基金来源工具包

将具有加密来源的数据存储在 群集 去中心化网络。每次上传都经过散列处理，可选择由公证人签名，并可以锚定在链上——为您提供一个不可变的、可验证的记录，记录存储的内容、时间和由谁存储。

建筑

┌─────────────────────────────────────────────────────────┐
│                    dataprovenance-app                     │
│                (Astro + React web UI)                     │
├──────────────────────────┬──────────────────────────────┤
│      SDK    │    CLI     │          MCP Server          │
│     (TS/JS) │  (Python)  │    (AI agent integration)    │
└───┬─────────┴──┬─────────┴──────────────┬───────────────┘
    │            │                        │
    ├────────────┼────────────────────────┤
    │       Chain Clients (direct)        │
    │       (viem / web3.py)              │
    ├────────────┼────────────────────────┘
    │            │                        │
    │   ┌────────┘          ┌─────────────┘
    │   │                   │
    ▼   ▼                   ▼
┌─────────────────────────────────────────────────────────┐
│                   Provenance Gateway                     │
│              (FastAPI — swarm_connect)                    │
│                                                          │
│       stamps, upload/download, notary signing            │
└──────────────────────────┬──────────────────────────────┘
                           │
                           ▼
                      Swarm Network
                  (decentralized storage)

    ── All clients also connect directly ──

              Blockchain RPC (Base Sepolia)
       DataProvenance smart contracts (Solidity)

所有三个客户端（SDK、CLI、MCP服务器）都可以锚定数据哈希 直接 通过他们自己的连锁客户在链上。 网关处理Swarm存储、印章管理和公证签名——它没有区块链端点。

组件

主要特点

通过网关 （所有客户）：

• 来源元数据 --每次上传都会用SHA256哈希、时间戳和编码信息包装数据
• 公证人签字 --可选的EIP-191加密签名，证明数据真实性
• 邮票管理 --使用预设的持续时间和大小购买、扩展和监控邮票
• 免费层 --开发和测试的速率限制访问（3个请求/分钟）
• x402付款 --在Base链上使用USDC按请求付费访问
• 完整性验证 --下载时自动进行SHA256哈希检查

直接到区块链 （SDK、CLI和MCP服务器）：

• 区块链锚定 --在DataProvenance智能合约（Base Sepolia）上注册数据哈希
• 转型谱系 --记录数据转换和合并，构建源DAG
• 存储参考 --Swarm哈希值和外部存储标识符之间的双向查找

快速开始

SDK（TypeScript）

pnpm add @datafund/swarm-provenance

import { ProvenanceClient } from '@datafund/swarm-provenance';

const client = new ProvenanceClient();
const result = await client.upload('Hello, World!', { standard: 'v1' });
console.log('Reference:', result.reference);

命令行界面（Python）

pip install -e "git+https://github.com/datafund/swarm_provenance_CLI.git#egg=swarm-provenance-uploader"

# Upload a file
swarm-prov-upload upload --file /path/to/data.txt

# Download and verify
swarm-prov-upload download  --output-dir ./downloads

MCP服务器（AI代理）

选项A——Docker（推荐）：

docker pull ghcr.io/datafund/swarm-provenance-mcp:latest

选项B——来源：

git clone https://github.com/datafund/swarm_provenance_MCP.git
cd swarm_provenance_mcp
pip install -e .

添加到您的Claude桌面配置(claude_desktop_config.json):

{
  "mcpServers": {
    "swarm-provenance": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/datafund/swarm-provenance-mcp:latest"],
      "env": {
        "SWARM_GATEWAY_URL": "https://provenance-gateway.datafund.io",
        "CHAIN_ENABLED": "true"
      }
    }
  }
}

或者，如果从源头安装，请更换 "command" / "args" 随着 "command": "swarm-provenance-mcp".

网关

公共网关位于 https://provenance-gateway.datafund.io。要自托管，请参阅 群集连接.

状态

此工具包位于 阿尔法/概念证明 舞台。Swarm上的存储是租用的——数据持久性取决于邮票的有效性。

链接

• 数据基金.io --数据基金
• --所有repos

许可证

麻省理工学院