soldnacloud 0.7.5 → 0.7.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -11,6 +11,50 @@ description: >
|
|
|
11
11
|
|
|
12
12
|
# DNAcloud Skill
|
|
13
13
|
|
|
14
|
+
## 前置环境检查（触发后第一步，必须通过）
|
|
15
|
+
|
|
16
|
+
在执行任何买家/卖家流程之前，先检查以下两项：
|
|
17
|
+
|
|
18
|
+
### 1. DNAcloud CLI 是否已安装
|
|
19
|
+
|
|
20
|
+
运行 `which dnacloud-sol` 或 `dnacloud-sol --version`：
|
|
21
|
+
|
|
22
|
+
- **已安装** → 继续下一项检查
|
|
23
|
+
- **未安装** → 告知用户并引导安装：
|
|
24
|
+
|
|
25
|
+
```
|
|
26
|
+
DNAcloud CLI 尚未安装。请在终端运行：
|
|
27
|
+
|
|
28
|
+
npm install -g soldnacloud
|
|
29
|
+
|
|
30
|
+
安装完成后，在当前项目目录运行：
|
|
31
|
+
|
|
32
|
+
dnacloud-sol init
|
|
33
|
+
|
|
34
|
+
然后重启 Claude Code，再重试你的请求。
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
### 2. Marketplace MCP 是否已加载
|
|
38
|
+
|
|
39
|
+
检查当前会话中 `mcp__dnacloud-marketplace__search` 工具是否可用：
|
|
40
|
+
|
|
41
|
+
- **可用** → 继续执行买家/卖家流程
|
|
42
|
+
- **不可用** → 说明 `dnacloud-sol init` 尚未在本项目执行，引导用户：
|
|
43
|
+
|
|
44
|
+
```
|
|
45
|
+
DNAcloud Marketplace MCP 尚未配置。请在当前项目目录终端中运行：
|
|
46
|
+
|
|
47
|
+
dnacloud-sol init
|
|
48
|
+
|
|
49
|
+
这会自动将 dnacloud-marketplace MCP server 写入 .mcp.json。
|
|
50
|
+
完成后重启 Claude Code，再重试你的请求。
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
> 注意：CLI 包名为 `soldnacloud`（npm），安装后提供 `dnacloud-sol` 命令。
|
|
54
|
+
> 不要引导用户安装 `dnacloud`（那是另一个不相关的包）。
|
|
55
|
+
|
|
56
|
+
---
|
|
57
|
+
|
|
14
58
|
## 触发场景（买家）
|
|
15
59
|
|
|
16
60
|
- 用户说"我要一个交易大师"
|
|
@@ -39,53 +83,26 @@ description: >
|
|
|
39
83
|
2. 搜索市场 → 调用 dnacloud-marketplace MCP 搜索相关 DNA 包
|
|
40
84
|
3. 展示推荐 → 展示匹配的 DNA 包、价格、能力、权限影响
|
|
41
85
|
4. 用户确认 → 等待用户确认购买
|
|
42
|
-
5. Solana USDC 支付 → 向 marketplace 请求 artifact，服务端返回 402 + Solana 支付要求
|
|
43
|
-
调用 onchainos wallet send 向平台地址转 USDC，获取 txHash
|
|
44
|
-
6. 提交支付凭证 → 携带 txHash 重放请求，服务端链上验证
|
|
45
|
-
7. 下载 artifact → 服务端验证通过后返回签名包
|
|
46
|
-
8. 展示安装预览 → 列出将要安装的所有文件和修改
|
|
47
|
-
9. 用户确认安装 → 等待最终确认
|
|
48
|
-
10. 执行安装 → 调用 dnacloud-installer agent
|
|
49
|
-
11. 验证 → 运行 dnacloud-sol verify
|
|
50
|
-
12. 完成 → 告知用户新能力已可用
|
|
51
|
-
```
|
|
52
86
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
{
|
|
58
|
-
"error": "payment_required",
|
|
59
|
-
"payment": {
|
|
60
|
-
"network": "solana",
|
|
61
|
-
"payTo": "AY5669hoJZMxWnaUGtbefiRj4btzXX5iR8Kh9Mtnc4KV",
|
|
62
|
-
"asset": "USDC",
|
|
63
|
-
"mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
|
|
64
|
-
"amount_atomic": "1000",
|
|
65
|
-
"amount_display": "0.001 USDC",
|
|
66
|
-
"nonce": "<uuid>"
|
|
67
|
-
}
|
|
68
|
-
}
|
|
69
|
-
```
|
|
87
|
+
5. 第一次调用 CLI（触发支付）：
|
|
88
|
+
运行：dnacloud-sol install <package-id>
|
|
89
|
+
→ CLI 会打印出需要执行的 onchainos wallet send 命令，以及收款方地址、金额
|
|
90
|
+
→ 记录 CLI 输出的完整 onchainos 命令
|
|
70
91
|
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
92
|
+
6. 执行支付（使用 okx-agentic-wallet skill）：
|
|
93
|
+
→ 运行 CLI 打印出的 onchainos wallet send 命令
|
|
94
|
+
→ 从返回结果中取得 txHash（Solana tx signature，58 个 Base58 字符）
|
|
74
95
|
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
--chain solana \
|
|
79
|
-
--contract-token EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
|
|
96
|
+
7. 第二次调用 CLI（验证+安装）：
|
|
97
|
+
运行：dnacloud-sol install <package-id> --tx-hash <txHash>
|
|
98
|
+
→ CLI 自动完成：链上支付验证 → 下载 artifact → 签名校验 → 安装预览 → 写入文件 → verify
|
|
80
99
|
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
3. 构造 X-PAYMENT header：
|
|
84
|
-
base64({ provider: "solana-onchain", txHash: "<txHash>", nonce: "<nonce>", network: "solana" })
|
|
85
|
-
|
|
86
|
-
4. 携带 X-PAYMENT 重新请求下载接口
|
|
100
|
+
8. 完成 → 告知用户新能力已可用，列出可用命令
|
|
87
101
|
```
|
|
88
102
|
|
|
103
|
+
> **关键原则**：步骤 5-7 的所有 HTTP 请求、402 处理、X-PAYMENT 构造均由 `dnacloud-sol install` CLI 内部完成。
|
|
104
|
+
> Agent 不需要（也不应该）自行构造 HTTP 请求或 X-PAYMENT header。
|
|
105
|
+
|
|
89
106
|
## 支付环境配置引导
|
|
90
107
|
|
|
91
108
|
**触发条件**：用户尝试购买 DNA 包时，检测到未安装 OKX OnchainOS。
|