soldnacloud 0.7.6 → 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.
|
@@ -83,53 +83,26 @@ DNAcloud Marketplace MCP 尚未配置。请在当前项目目录终端中运行
|
|
|
83
83
|
2. 搜索市场 → 调用 dnacloud-marketplace MCP 搜索相关 DNA 包
|
|
84
84
|
3. 展示推荐 → 展示匹配的 DNA 包、价格、能力、权限影响
|
|
85
85
|
4. 用户确认 → 等待用户确认购买
|
|
86
|
-
5. Solana USDC 支付 → 向 marketplace 请求 artifact，服务端返回 402 + Solana 支付要求
|
|
87
|
-
调用 onchainos wallet send 向平台地址转 USDC，获取 txHash
|
|
88
|
-
6. 提交支付凭证 → 携带 txHash 重放请求，服务端链上验证
|
|
89
|
-
7. 下载 artifact → 服务端验证通过后返回签名包
|
|
90
|
-
8. 展示安装预览 → 列出将要安装的所有文件和修改
|
|
91
|
-
9. 用户确认安装 → 等待最终确认
|
|
92
|
-
10. 执行安装 → 调用 dnacloud-installer agent
|
|
93
|
-
11. 验证 → 运行 dnacloud-sol verify
|
|
94
|
-
12. 完成 → 告知用户新能力已可用
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
## 支付流程详细说明（步骤 5-6）
|
|
98
|
-
|
|
99
|
-
服务端 402 响应包含：
|
|
100
|
-
```json
|
|
101
|
-
{
|
|
102
|
-
"error": "payment_required",
|
|
103
|
-
"payment": {
|
|
104
|
-
"network": "solana",
|
|
105
|
-
"payTo": "AY5669hoJZMxWnaUGtbefiRj4btzXX5iR8Kh9Mtnc4KV",
|
|
106
|
-
"asset": "USDC",
|
|
107
|
-
"mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
|
|
108
|
-
"amount_atomic": "1000",
|
|
109
|
-
"amount_display": "0.001 USDC",
|
|
110
|
-
"nonce": "<uuid>"
|
|
111
|
-
}
|
|
112
|
-
}
|
|
113
|
-
```
|
|
114
86
|
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
onchainos wallet send \
|
|
120
|
-
--readable-amount 0.001 \
|
|
121
|
-
--recipient AY5669hoJZMxWnaUGtbefiRj4btzXX5iR8Kh9Mtnc4KV \
|
|
122
|
-
--chain solana \
|
|
123
|
-
--contract-token EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
|
|
87
|
+
5. 第一次调用 CLI（触发支付）：
|
|
88
|
+
运行：dnacloud-sol install <package-id>
|
|
89
|
+
→ CLI 会打印出需要执行的 onchainos wallet send 命令，以及收款方地址、金额
|
|
90
|
+
→ 记录 CLI 输出的完整 onchainos 命令
|
|
124
91
|
|
|
125
|
-
|
|
92
|
+
6. 执行支付（使用 okx-agentic-wallet skill）：
|
|
93
|
+
→ 运行 CLI 打印出的 onchainos wallet send 命令
|
|
94
|
+
→ 从返回结果中取得 txHash（Solana tx signature，58 个 Base58 字符）
|
|
126
95
|
|
|
127
|
-
|
|
128
|
-
|
|
96
|
+
7. 第二次调用 CLI（验证+安装）：
|
|
97
|
+
运行：dnacloud-sol install <package-id> --tx-hash <txHash>
|
|
98
|
+
→ CLI 自动完成：链上支付验证 → 下载 artifact → 签名校验 → 安装预览 → 写入文件 → verify
|
|
129
99
|
|
|
130
|
-
|
|
100
|
+
8. 完成 → 告知用户新能力已可用，列出可用命令
|
|
131
101
|
```
|
|
132
102
|
|
|
103
|
+
> **关键原则**：步骤 5-7 的所有 HTTP 请求、402 处理、X-PAYMENT 构造均由 `dnacloud-sol install` CLI 内部完成。
|
|
104
|
+
> Agent 不需要（也不应该）自行构造 HTTP 请求或 X-PAYMENT header。
|
|
105
|
+
|
|
133
106
|
## 支付环境配置引导
|
|
134
107
|
|
|
135
108
|
**触发条件**：用户尝试购买 DNA 包时，检测到未安装 OKX OnchainOS。
|