SuperAPI AI 工具集

nostr-queries

编程与开发

查看项目

更新于 10-16 09:29

技能介绍

用途:本技能适用于编写获取 Nostr 事件的 hook,介绍 useNostr + useQuery 的标准写法、高效查询设计和事件校验。

标准用法:在自定义 hook 中组合 useNostr 与 TanStack Query,把 c.signal 传入 nostr.query,使取消的查询释放中继资源。可在 queryFn 内把事件转成领域模型;一个 queryFn 里多次调用 nostr.query 也可用于无法用单过滤器表达的复合查询。

主要能力与规则:尽量减少独立往返次数,每个查询都消耗中继容量、可能触发限流。应把 kinds 合并进一个过滤器(如 kinds: [1, 6, 16]),需要不同标签过滤时在单次 nostr.query 里传入多个过滤器对象;合并 kind 时要提高 limit 以保证各类型数量;在 JavaScript 中按 kind 拆分,而非发起多次请求。

事件校验:对带必填标签或严格模式的 kind(多数自定义 kind,kind 1 之外)应先经校验器过滤再返回;kind 1 文本笔记标签均可选、内容自由,通常无需校验。示例校验器检查 31922、31923 的 d、title、start 标签,并区分日期与时间格式。

限制:校验只是正确性层,不是安全层;涉及信任敏感的查询(管理操作、可寻址事件、审核批准)还需约束作者。

可复制示例:

import { useNostr } from '@nostrify/react'; import { useQuery } from '@tanstack/react-query';

function usePosts() { const { nostr } = useNostr(); return useQuery({ queryKey: ['posts'], queryFn: async (c) => { const events = await nostr.query( [{ kinds: [1], limit: 20 }], { signal: c.signal }, ); return events; }, }); }

其他细节(如具体依赖版本、安装方式、收费情况)资料暂未提供。