SuperAPI AI 工具集

nip19-routing

编程与开发

查看项目

更新于 10-16 09:29

技能介绍

用途:在 Nostr 应用中实现或填充根级 NIP-19 路由 /:nip19(src/pages/NIP19Page.tsx),统一处理 npub1、nprofile1、note1、nevent1、naddr1 等 bech32 标识符,用于用户资料、事件与可寻址事件(如文章、商品)的跳转与渲染。

主要能力:使用 nostr-tools 的 nip19.decode 解码标识符后构建中继过滤器;按 decoded.type 分支渲染对应视图。npub/nprofile 对应资料页;note 对应 kind:1 文本事件及回复线程;nevent 为通用事件渲染;naddr 为可寻址事件视图。路由规则为所有标识符都位于 URL 根路径,不得嵌套在 /note/:id 或 /profile/:npub 下;无效、空缺或不支持的标识符(含 nsec1、nrelay1)渲染 404。

必要用法:中继过滤器只接受 hex 字符串,务必先解码。npub 用 authors:[pubkey]、kinds:[0];note 用 ids:[id]、kinds:[1];nevent 用 ids:[id];naddr 必须同时包含 kinds、authors:[pubkey]、'#d':[identifier],否则任何人都能用相同 d tag 伪造事件。构建链接时用最具体的编码:nprofile 优先于 npub,nevent 优先于 note,可寻址事件用 naddr。

限制:nsec1 私钥绝不显示、记录或路由,一律按 404 处理;不得将 bech32 直接传入 filter。将解码后的 payload 而非原始字符串传给子组件,避免重复解码不一致。非 kind:1 事件或需携带 relay hints 时优先 nevent1。该资料未提供具体的组件实现代码、样式与部署步骤。