Integration

前端与 SDK 接入

对接 Moss 时,真正重要的是连接器、部署信息、权限检查和智能钱包上下文。

3 个章节frontend-and-sdk
01

前端接入点

  • 钱包连接层负责连接器集成。
  • `src/moss/lib/config.ts` 汇总环境变量和部署信息。
  • `ConnectWallet` 与相关 wallet 组件负责智能钱包检测与创建。
  • `MossWalletGate` 用于把部分页面限制在 Moss Wallet 环境内。
02

可复用包

@mossdapp/sdk

外链

面向 dApp 的 TS SDK,可复用 smart wallet 地址计算和签名能力。

@mossdapp/abi

对外暴露 ABI JSON,可被前端和脚本复用。

@mossdapp/deployments

按网络组织部署信息,用于环境配置和集成。

03

接入新应用的推荐路径

步骤 1

准备链上地址

先确认逻辑合约、App NFT、Registry 和系统模块地址。

步骤 2

接入连接器

让前端能识别并连接 Moss 智能钱包上下文。

步骤 3

读取安装与权限状态

在进入应用前先检查 App NFT 和授权状态。

步骤 4

根据系统模块设计交互

尽量复用 TokenManage / NFTManage,而不是重复设计资产控制层。

SDK integration diagram
集成重点是让 dApp 前端、SDK 和 SCW 上下文之间的边界保持稳定。