WEB3 Integration — WEB3 集成

SKILL：web3-integration 目的：使用安全、可测试的模式，将前端/后端与区块链交互（钱包连接、提供者配置、合约调用）集成。 何时使用：

• dApp 需要读写合约状态。
• 后端服务必须索引或响应链上事件。
• 需要钱包连接 UX 和链网关。

输入：

• stack（必需，枚举：ethers|viem|web3js）：首选客户端库。
• chain（必需，字符串）：链名 + 链 ID。
• rpc（可选，字符串）：RPC URL 引用（env/config），不硬编码。
• contract_address（必需，字符串）。
• abi_source（必需，字符串）：ABI 路径/工件引用。
• wallet_flow（可选，枚举：injected|walletconnect|server_signer）。

步骤：

• 验证链/合约坐标（链 ID、地址格式、ABI 匹配）。
• 设置提供者/签名者流程：

- 前端：用户钱包签名者 - 后端：仅当明确需要并且密钥安全外部时，服务器签名者

• 实现合约客户端包装器：

- 可能时使用类型接口 - RPC 的显式超时/重试

• 添加链网关：

- 拒绝错误链 - 提示网络切换（前端）

• 为写操作添加日志/审计钩子。
• 添加测试：

- 包装器的单元测试 - 本地链模拟（当可用时） 验证：

• 存储库中不存储任何密钥（仅通过密钥管理器/env）。
• 错误链行为是安全的（无意外写入）。
• 错误以确定性方式处理（重试策略是显式的）。

输出：

• 包装器模块路径

环境变量：

• 合约（必须配置）

验证命令（测试/构建） 安全规则：

• 永远不要请求或粘贴私钥到聊天/输出中。
• 永远不要默认为主网。
• 除非明确需要和批准，否则避免“自动签名”服务器流程。

示例输入：

• stack：viem
• chain：base:8453
• contract_address：0x...
• abi_source：artifacts/MyContract.json

输出：

• src/web3/client.ts，带有链 ID 检查和类型化合约实例。