开源推荐
morning
GitHub 热门项目:sphere-sdk-connect-example
2026-08-12
1 阅读
约5分钟阅读
GitHub Trending
字号:
GitHub 项目:sphere-sdk-connect-example
仓库地址:https://github.com/unicity-sphere/sphere-sdk-connect-example
星级:9660 | 作者:unicity-sphere
项目描述:暂无描述
===================================================
自述文件内容:
# 球体连接示例
四个可运行的示例展示了应用程序与 Sphere 配合使用的不同方式
钱包——作为浏览器 dApp、作为节点 dApp、作为运行其**自己的**的机器人
钱包,或作为仅验证用户身份的后端。
## 什么是 Sphere Connect?
Sphere Connect 是一种类型化 RPC 协议,可让 dApp 与用户的 Sphere 进行通信
钱包 — 读取余额、发送代币、签署消息 — **无需
查看私钥**。 dApp 运行“ConnectClient”;钱包运行一个
`连接主机`;传输在它们之间传送消息。
````
dApp (ConnectClient) ←→ 传输 ←→ 钱包 (ConnectHost)
````
> **所有五个软件包都需要 `@unicitylabs/sphere-sdk` ≥ 0.14.1。** 钱包主机
> 从 0.14.1 开始,在握手时强制执行 **SDK 版本下限**:客户端
> 基于旧版 SDK 构建的内容被“UNSUPPORTED_PROTOCOL_VERSION”拒绝 (4007)
> 在出现任何批准 UI 之前,因此未碰撞的 dApp 会直接停止
> 连接。 Connect 协议本身没有改变(仍然是 **2.1**)——这是
> 依赖冲突和重建,仅此而已。参见
> [浏览器/CONNECT.md](浏览器/CONNECT.md#-your-dapp-needs-unicitylabssphere-sdk--0141)。
并非每个示例都使用 Connect:**机器人** 直接运行自己的钱包,并且
backend-auth 中的 **backend** 仅验证签名。请参阅下面的指南。
## 我需要哪个示例?
这些示例在两个轴上有所不同:**您的应用程序使用谁的钱包**,以及**什么
它需要与它做**。
|示例|您的应用程序是... |钱包是…… |可以移动代币吗? |当……时伸手去拿它。
|---|---|---|---|---|
| **`浏览器/`** |网页/dApp | **用户的**,其他地方 | ✅ 获得每个操作的批准 |您的 dApp 在浏览器中运行,并且用户在场批准每次发送 - 例如玩家批准游戏内购买的**浏览器游戏** |
| **`nodejs/`** |节点 CLI/服务 | **用户的**,通过 WebSocket | ✅ 经批准 |您需要一个 **CLI/桌面/服务器** dApp,通过 WebSocket 驱动用户的钱包(请参阅其自述文件中的警告)|
| **`机器人/`** |自主代理人| **自己的**(自己的密钥,钱包-api 托管)| ✅ 没有批准 - 它拥有资金 |您正在构建一个**小费机器人、水龙头、支付奖励的游戏 NPC,或者一个代理**,它可以通过自己的浮动来行动,而循环中没有人类 |
| **`后端验证/`** |前端+后端| **用户的**(仅前端标志)| ❌ **仅限授权** |你需要知道玩家是谁——登录、排行榜、所有权、会话——但**不需要**需要移动他们的代币。 **推荐用于需要身份验证而不是托管或意图的游戏/应用程序** |
经验法则:
- **需要移动*用户的*令牌?** → `browser/` (web) 或 `nodejs/` (Node over WS)。用户批准每个操作。
- **自主移动*你自己的*代币?** → `bot/`。这是钱包;没有批准提示。
- **只需要知道用户是谁?** → `backend-auth/`。它会进行身份验证并停止 - 它永远不会触及资金。
## 快速入门
### `browser/` — 基于 C 的网络 dApp
这篇文章对您有帮助吗?
订阅66必读
每日精选科技资讯,直达你的邮箱