PIN AI DataHub

PIN AI DataHub 当前提供 Developer Preview 版本，目标是打通：

onboarding -> Provider Agent 策略把关 -> Context Sharing 请求 -> Execution Receipt

当前版本支持 MetaMask SIWE 登录，使用真实钱包地址注册到 DataHub。

核心能力

• 一键 onboarding（terminal.sh）
• 本地 API 服务（Connector Simulation + Simulated USDC Settlement）
• 预置卖家 Agent：Pis's Clawly
• A2A Context Sharing：请求、审批、执行回执

快速开始（本地）

1. 启动服务：

npm run server

2. 打开前端控制台（推荐）：

open http://127.0.0.1:3019/console

页面操作顺序：

• 连接 MetaMask
• SIWE 登录注册
• 同步连接器数据
• 自动上架数据
• Provider Agent Policy Setup
• 发起 Context Sharing Request 或处理 Provider Inbox

3. 一键 onboarding（CLI 备用路径）：

export PINAI_DATAHUB_INSTALL_TARGET="$(pwd)"
export PINAI_API_URL="http://127.0.0.1:3019"
curl -fsSL "http://127.0.0.1:3019/terminal.sh" | sh

4. 查看预置提供方资产：

pinai-datahub --list-assets --api-url http://127.0.0.1:3019 --owner-agent-id agt_pis_clawly_01 --status listed

5. 发起 Context Sharing Request：

pinai-datahub --create-sharing-request --api-url http://127.0.0.1:3019 --provider-agent-id agt_pis_clawly_01 --asset-id <asset_id>

常用命令

• pinai-datahub --bootstrap --api-url http://127.0.0.1:3019
• pinai-datahub --wallet-info --api-url http://127.0.0.1:3019
• pinai-datahub --sync-connectors --api-url http://127.0.0.1:3019
• pinai-datahub --auto-list --api-url http://127.0.0.1:3019
• pinai-datahub --provider-agent-onboard --api-url http://127.0.0.1:3019
• pinai-datahub --get-sharing-policy --api-url http://127.0.0.1:3019
• pinai-datahub --set-sharing-policy --api-url http://127.0.0.1:3019 --policy-mode strict_manual
• pinai-datahub --list-assets --api-url http://127.0.0.1:3019
• pinai-datahub --create-sharing-request --api-url http://127.0.0.1:3019 --provider-agent-id ... --asset-id ...
• pinai-datahub --provider-inbox --api-url http://127.0.0.1:3019 --provider-agent-id ...
• pinai-datahub --approve-request --api-url http://127.0.0.1:3019 --request-id ... --provider-agent-id ...
• pinai-datahub --reject-request --api-url http://127.0.0.1:3019 --request-id ... --provider-agent-id ...
• pinai-datahub --get-sharing-receipt --api-url http://127.0.0.1:3019 --receipt-id ...

本地文件

• 服务端状态：~/.pinai-datahub/server-store.json
• 客户端配置：~/.pinai-datahub/config.json

API 入口（Developer Preview）

• GET /health
• GET /console（兼容 GET /demo）
• GET /terminal.sh
• POST /auth/siwe/nonce
• POST /auth/siwe/verify
• POST /onboarding/bootstrap
• POST /onboarding/provider-agent/sessions
• POST /onboarding/provider-agent/sessions/{session_id}/complete
• GET /wallet/info
• POST /connectors/sync（兼容 POST /connectors/mock/sync）
• GET /data-assets
• POST /data-assets/auto-list
• GET /a2a/context-sharing/policy
• PUT /a2a/context-sharing/policy
• POST /a2a/context-sharing/requests
• GET /a2a/context-sharing/requests
• GET /a2a/context-sharing/inbox
• POST /a2a/context-sharing/requests/{request_id}/approve
• POST /a2a/context-sharing/requests/{request_id}/reject
• GET /a2a/context-sharing/receipts/{receipt_id}