用途:这是 XL1 dApp 开发的设计模式层,说明如何在 XL1 上构建常见应用功能,与记录“XL1 是什么”的底层技能互补。版本在文件 frontmatter 的 metadata.version 中,引用格式为 <skill-name> v<version>(如 xl1-patterns v1.1.19)。
主要能力:浏览器 UX(钱包连接生命周期 ConnectAccountsStack、useConnectAccount 单例陷阱、地址提升到应用状态、能力感知组件、显示约定);钱包权限(四种已注册 RPC 权限,公开支持 xyoWallet_getAccounts 与 xyoSigner_address,禁止请求仅内部使用的 xyoDataLakes_,可用 RequestPermissionsButton、usePermissions、useAccountPermissions 下探);浏览器与服务的对接(默认 :3000 应用与 :3001 服务、/api/ 基路径、Vite 开发代理保持同源,默认无需 CORS);链上数据索引(协议、客户端、服务三种角色);提交-揭示原语;页内数据湖;提交-揭示预测市场;原子交换;铭文基底;XRC-20 同质化代币;无头 dApp 验证;以及 dApp 完成度定义清单。
使用方式:按需阅读对应模式文件,索引类先读协议文件再读角色文件;涉及 UI 的 dApp 必读浏览器 UX,含服务时必读浏览器与服务接线;报告工作完成前必须逐项走查完成度清单并注明通过或失败。无头验证通过 GatewayBuilder.build(signer) 接入助记词钱包,使 Node 脚本与浏览器用户在同一助记词下拥有相同身份。
限制:部分模式有明确边界,如链上数据索引客户端只适用于临时、单用户、简单场景,多用户、持久或受重组影响的需求应使用服务文件;原子交换中缺少揭示会阻止结算而非没收;完成度清单中标注“(if applicable)”的分节仅在确实超出范围时可跳过,并需说明原因。资料未提供价格、收费、平台支持范围与效果数据。