controller-presets

用途：该技能以交互问答方式引导团队为 Cartridge Controller 创建一个 preset。preset 是一份提交到 cartridge-gg/presets 仓库的 config.json，用于配置 origin 验证、会话策略、主题、paymaster 行为以及可选的 iOS passkey 支持。\n\n主要流程与能力：\n1. 基础信息：询问项目名称（须为小写 kebab-case，用作 configs/<name>/ 目录名）与目标网络（SN_MAIN、SN_SEPOLIA 或两者）。Sepolia 默认由 paymaster 赞助，主网需自建 Cartridge paymaster。\n2. Origin 配置：填写生产域名，规则为不带协议前缀（如 game.example.com）、子域用通配符 *.example.com，但通配符不匹配基础域；多 origin 用数组；localhost 无需列出。Capacitor 移动应用可用自定义 hostname。\n3. 会话策略：收集合约地址与入口点，构建 chains 段落。入口点须为 snake_case 且与 Cairo 函数名一致；链 ID 用 SN_MAIN / SN_SEPOLIA；不同网络合约地址不同；approve 入口会触发 CI 警告。支持 isPaymastered、isEnabled、isRequired、predicate 等选项，以及 EIP-712 消息签名策略。使用 Cartridge VRF 时需包含 VRF 提供者合约与 request_random 入口点。\n4. 主题：可自定义名称、图标（SVG/PNG，优化至 16–256px）、封面（PNG/JPG，768–1440px，可选 light/dark）与主色，资源文件与 config.json 同目录。\n5. AASA：若 iOS 应用使用 passkey，需填 Team ID（10 位大写字母数字）与 Bundle ID（反向 DNS），格式 TEAMID.BUNDLEID；所有 preset 的 AASA 聚合文件需小于 128 KB。\n6. 校验与集成：按清单检查 origin 无协议、链 ID 正确、地址分网络、入口点 snake_case、AASA 格式等；并在应用中使用 preset 名称初始化 Controller。\n7. 提交 PR：创建 configs/<name>/config.json 与资源文件，CI 运行 validate-configs.ts，合并后配置部署至 https://static.cartridge.gg/presets/<name>/config.json。\n\n限制：资料未提供具体收费或价格信息；主网赞助需另行创建并充值 Cartridge paymaster；CI 对 approve 入口点的警告为有意设计。