Build Starknet Apps with starknet.js — Starknet 应用开发技能

技能简介

internet-court/starknet-js 是为 Claude、Codex、Claude Code 等 AI 编程代理量身打造的 Starknet 区块链集成技能。它专注于 starknet.js v9.x 版本，针对 TypeScript 应用开发中最棘手的 Provider 配置、合约状态读取、账户管理、交易提交、费用估算与 Paymaster 赞助执行等场景，提供经过实战验证的可复用代码模式。无论是接入 Starknet 主网、Sepolia 测试网，还是构建钱包连接、Multicall、合约部署等复杂流程，该技能都能让 AI 助手生成生产级的 TypeScript 代码，避免常见 API 用法错误与安全陷阱。

核心能力

• 配置 RpcProvider 实例，区分主网（mainnet）与 Sepolia 测试网，支持节点切换与超时控制。
• 读取合约状态，调用类型化合约接口，提供 ABI 期望、地址校验、可读错误处理模板。
• 创建账户、派生地址、签名消息并提交交易，覆盖账户抽象（Account Abstraction）核心流程。
• 构建 Multicall、ERC-20 转账、合约部署与钱包连接等典型集成模式。
• 估算交易费用（estimateFee）、模拟调用（simulate）、配置 Paymaster 赞助交易与替代 Gas 代币流程。
• 使用 BigInt 处理代币金额，强制显式费用边界，杜绝 JavaScript Number 精度损失。

安装配置

1. 通过 npx 命令一键安装：npx skillstore add internet-court/starknet-js。
2. 启用后，在 Claude / Codex / Claude Code 中按需引用该技能即可。
3. 项目需准备 starknet.js v9.x、TypeScript ≥5.x、Node.js ≥18，并配置好 RPC 节点 URL（mainnet / Sepolia 二选一）。
4. 准备好测试网水龙头获取的测试账户私钥，仅用于本地开发，严禁上传到版本控制。

使用步骤

1. 初始化 Provider：调用 new RpcProvider({ nodeUrl: 'https://starknet-sepolia.example' }) 创建连接，区分主网与 Sepolia。
2. 读取类型化合约：使用 Contract 类加载 ABI，校验地址格式，捕获 RPC 异常并转为可读错误信息。
3. 构建交易流程：在 execute 调用前先 simulate，确认 calldata 与 nonce 正确，再估算 maxFee 或使用 Paymaster 赞助。
4. Multicall 批量提交：将多个调用打包到 aggregate 或 multiAccountCall，减少用户签名次数与失败重试成本。
5. 钱包与 Paymaster 集成：按官方钱包 SDK 流程接入 connect / sign / dispatch，Paymaster 场景需明确网络、签名者、回放保护、失败兜底。
6. 提交与确认：监听 transactionHash，轮询 waitForTransaction，记录 receipt 与事件日志便于后续排查。

适用场景

• 在 TypeScript 应用中集成 Starknet 钱包、签名与转账。
• 快速搭建 Starknet DApp 原型，覆盖合约读取与最小可行交易提交。
• 为企业级应用设计生产可用的 Paymaster 赞助执行与多签工作流。
• 评审现有 starknet.js 集成的安全性、版本兼容性与错误处理完整性。
• 在 CI/CD 流水线中校验 Starknet 合约调用的类型签名与 ABI 一致性。

适用人群

• 正在构建 Starknet DApp、DeFi 协议或 NFT 平台的前端 / 全栈工程师。
• 需要为 Web3 产品集成钱包连接与代币转账体验的产品团队。
• Starknet 智能合约开发者，需要为前端提供可靠的 TypeScript 集成示例。
• Web3 安全审计师，评估 starknet.js 集成的安全性与版本一致性。
• 学习区块链应用开发、希望系统掌握 starknet.js v9.x 实战模式的工程师。

工作原理

该技能通过预置的 Starknet API 知识图谱与典型代码模板，引导 AI 助手在生成 TypeScript 代码时优先采用模块化 Provider、显式类型签名、模拟先行的安全写法。技能本身不发起任何实际网络请求，所有 starknet.js 调用都在用户本地项目中执行，配置由用户维护。技能的训练覆盖了 v9.x 主要 API 演进路径，能够识别过时用法并推荐新版替代方案，从而显著降低 Web3 应用集成过程中的试错成本。

官方链接

• Skillstore 主页：https://skillstore.io/skills/internet-court-starknet-js
• 仓库地址：https://github.com/internet-court/internet-court-skill/tree/main/vendored/starknet/starknet-js
• Manifest 接口：https://skillstore.io/api/skills/internet-court-starknet-js/manifest