SuperAPI AI 工具集

starknet-react-rules

前端与建站

查看项目

更新于 10-16 07:25

技能介绍

用途:为 Starknet React 项目提供一套区块链集成开发规则,帮助开发者规范钱包连接、交易状态与错误处理,减少链上交互中的常见错误。

主要能力:集中管理区块链连接;实现自动重连与错误处理;使用 React hooks 管理交易状态;为区块链交互提供清晰的 UI 反馈;对链上操作实施完整错误处理。

铁律:未验证已连接钱包与 chain ID 前,绝不与 Starknet 合约交互;必须显式处理交易的 pending、confirmed、rejected 状态;绝不硬编码合约地址,始终使用环境变量或配置文件;合约交互始终使用由 ABI 生成的 TypeScript 类型;绝不跳过钱包连接失败与交易回滚的错误处理。

反模式与正确做法:跳过 chain ID 校验会导致钱包连错网络并静默破坏交易,应始终校验 chainId 与预期 Starknet 网络一致;硬编码合约地址在跨环境部署时会失效,应使用环境变量或配置文件;缺少交易状态处理会让用户在 pending/rejected 时看到空白 UI,应为所有交易实现 loading、confirmed、rejected 状态;直接调用 ABI 而不使用 TypeScript 类型会因参数类型错误引发运行时错误,应使用由 ABI 生成的类型;忽略钱包连接错误会造成静默失败与困惑体验,应处理 ConnectionError、UserRejectedRequestError 和 RejectedRequestError。

记忆协议(强制):开始前执行 cat .claude/context/memory/learnings.md;完成后记录新发现的模式或例外。假设中断:上下文可能重置,未写入记忆即视为未发生。

适用场景:使用 React 与 Starknet 进行 dApp 前端开发、需要统一钱包连接与交易状态管理的项目。限制:资料未提供具体安装命令、依赖版本、平台支持范围与收费信息。