;
+```
+
+### 4. Set the Default in `App.tsx`
+
+Pick a provider pubkey and add it to `defaultConfig`. The ditto.pub provider is a reasonable default:
+
+```typescript
+const defaultConfig: AppConfig = {
+ // ...existing fields...
+ nip85StatsPubkey: '5f68e85ee174102ca8978eef302129f081f03456c884185d5ec1c1224ab633ea',
+};
+```
+
+Set to `''` to ship with stats disabled.
+
+### 5. Update `TestApp.tsx`
+
+In `src/test/TestApp.tsx`, add the field to the test default config. Use an empty string so tests don't hit a live provider:
+
+```typescript
+const defaultConfig: AppConfig = {
+ // ...existing fields...
+ nip85StatsPubkey: '',
+};
+```
+
+## Usage
+
+### User stats (kind 30382)
+
+```tsx
+import { useNip85UserStats } from '@/hooks/useNip85Stats';
+
+function FollowerCount({ pubkey }: { pubkey: string }) {
+ const { data: stats } = useNip85UserStats(pubkey);
+ if (!stats) return null; // no provider configured or no assertion yet
+ return {stats.followers.toLocaleString()} followers;
+}
+```
+
+### Event stats (kind 30383)
+
+```tsx
+import { useNip85EventStats } from '@/hooks/useNip85Stats';
+
+function NoteStats({ eventId }: { eventId: string }) {
+ const { data: stats } = useNip85EventStats(eventId);
+ if (!stats) return null;
+ return (
+
+ {stats.reactionCount} reactions
+ {stats.repostCount} reposts
+ {stats.commentCount} comments
+ {stats.zapAmount} sats
+
+ );
+}
+```
+
+### Addressable event stats (kind 30384)
+
+The `addr` argument is the full NIP-01 event address `::`:
+
+```tsx
+import { useNip85AddrStats } from '@/hooks/useNip85Stats';
+
+function ArticleStats({ kind, pubkey, identifier }: { kind: number; pubkey: string; identifier: string }) {
+ const { data: stats } = useNip85AddrStats(`${kind}:${pubkey}:${identifier}`);
+ if (!stats) return null;
+ return {stats.reactionCount} reactions;
+}
+```
+
+## Behavior Notes
+
+- **Graceful degradation:** The hooks return `null` (not an error) when `nip85StatsPubkey` is empty or the provider has no assertion for the subject. Always render defensively — NIP-85 is an optimization, not a source of truth.
+- **Short timeouts:** Each query is wrapped in a 2-second `AbortSignal.timeout` so a slow stats relay never blocks the UI.
+- **Cached by TanStack Query:** `staleTime` is 30s for event/addr stats and 60s for user stats. Results are keyed on `[kind, subject, statsPubkey]`, so swapping providers invalidates the cache automatically.
+- **Missing tags = 0:** A tag absent from the assertion is reported as `0` rather than `undefined`, matching NIP-85's "no data" semantics.
+- **Not the source of truth:** For interactive features (did *this* user like *this* post?) you still need to query the underlying reaction/zap/repost events. NIP-85 only provides aggregate counts.
+
+## Extending the Stats
+
+The hooks expose a small subset of the tags defined in NIP-85. To surface more (e.g. `zap_amt_sent`, `rank`, `first_created_at`), extend the return types and pull additional tags via `getIntTag`:
+
+```typescript
+export interface Nip85UserStats {
+ followers: number;
+ postCount: number;
+ rank: number; // new
+ zapAmtReceived: number; // new
+}
+
+// inside useNip85UserStats queryFn
+return {
+ followers: getIntTag(tags, 'followers'),
+ postCount: getIntTag(tags, 'post_cnt'),
+ rank: getIntTag(tags, 'rank'),
+ zapAmtReceived: getIntTag(tags, 'zap_amt_recd'),
+};
+```
+
+See the full tag table in [NIP-85](https://github.com/nostr-protocol/nips/blob/master/85.md).
+
+## Exposing a Provider Picker (Optional)
+
+If you want the user to change providers at runtime, add an input bound to `config.nip85StatsPubkey` and call `updateConfig` with a validated 64-char hex value:
+
+```tsx
+import { useAppContext } from '@/hooks/useAppContext';
+
+function StatsProviderInput() {
+ const { config, updateConfig } = useAppContext();
+ return (
+ {
+ const v = e.target.value.trim().toLowerCase();
+ if (v === '' || /^[0-9a-f]{64}$/.test(v)) {
+ updateConfig(() => ({ nip85StatsPubkey: v }));
+ }
+ }}
+ placeholder="64-char hex pubkey (blank to disable)"
+ />
+ );
+}
+```
+
+## Related NIPs
+
+- [NIP-85](https://github.com/nostr-protocol/nips/blob/master/85.md) — Trusted Assertions (this skill)
+- [NIP-01](https://github.com/nostr-protocol/nips/blob/master/01.md) — Addressable event addressing (`::`)
+- [NIP-57](https://github.com/nostr-protocol/nips/blob/master/57.md) — Zaps (the underlying events `zap_amount` / `zap_cnt` aggregate)
diff --git a/.agents/skills/nip85-stats/files/hooks/useNip85Stats.ts b/.agents/skills/nip85-stats/files/hooks/useNip85Stats.ts
new file mode 100644
index 00000000..38f87993
--- /dev/null
+++ b/.agents/skills/nip85-stats/files/hooks/useNip85Stats.ts
@@ -0,0 +1,156 @@
+import { useNostr } from '@nostrify/react';
+import { useQuery } from '@tanstack/react-query';
+import { useAppContext } from '@/hooks/useAppContext';
+
+/** Engagement counts exposed by NIP-85 kind 30383 (events) and 30384 (addressable events). */
+export interface Nip85EventStats {
+ commentCount: number;
+ repostCount: number;
+ reactionCount: number;
+ zapCount: number;
+ /** Zap amount in sats. */
+ zapAmount: number;
+}
+
+/** A subset of NIP-85 kind 30382 (user) stats — extend as needed. */
+export interface Nip85UserStats {
+ followers: number;
+ postCount: number;
+}
+
+/**
+ * Read an integer tag value from a NIP-85 assertion event. Returns 0 when missing
+ * or unparseable, which mirrors the semantics of "no data" in NIP-85.
+ */
+function getIntTag(tags: string[][], tagName: string): number {
+ const tag = tags.find(([name]) => name === tagName);
+ if (!tag?.[1]) return 0;
+ const n = parseInt(tag[1], 10);
+ return Number.isFinite(n) ? n : 0;
+}
+
+/**
+ * Fetches NIP-85 event stats (kind 30383) from the configured stats pubkey.
+ * Returns `null` when no stats pubkey is configured or the provider has no
+ * assertion for this event.
+ */
+export function useNip85EventStats(eventId: string | undefined) {
+ const { nostr } = useNostr();
+ const { config } = useAppContext();
+ const statsPubkey = config.nip85StatsPubkey;
+
+ return useQuery({
+ queryKey: ['nip85-event-stats', eventId, statsPubkey],
+ queryFn: async ({ signal }) => {
+ if (!eventId || !statsPubkey) return null;
+
+ const combined = AbortSignal.any([signal, AbortSignal.timeout(2000)]);
+
+ try {
+ const events = await nostr.query(
+ [{ kinds: [30383], authors: [statsPubkey], '#d': [eventId], limit: 1 }],
+ { signal: combined },
+ );
+
+ if (events.length === 0) return null;
+
+ const { tags } = events[0];
+ return {
+ commentCount: getIntTag(tags, 'comment_cnt'),
+ repostCount: getIntTag(tags, 'repost_cnt'),
+ reactionCount: getIntTag(tags, 'reaction_cnt'),
+ zapCount: getIntTag(tags, 'zap_cnt'),
+ zapAmount: getIntTag(tags, 'zap_amount'),
+ };
+ } catch {
+ return null;
+ }
+ },
+ enabled: !!eventId && !!statsPubkey,
+ staleTime: 30 * 1000,
+ retry: false,
+ });
+}
+
+/**
+ * Fetches NIP-85 user stats (kind 30382) from the configured stats pubkey.
+ * Returns `null` when no stats pubkey is configured or the provider has no
+ * assertion for this pubkey.
+ */
+export function useNip85UserStats(pubkey: string | undefined) {
+ const { nostr } = useNostr();
+ const { config } = useAppContext();
+ const statsPubkey = config.nip85StatsPubkey;
+
+ return useQuery({
+ queryKey: ['nip85-user-stats', pubkey, statsPubkey],
+ queryFn: async ({ signal }) => {
+ if (!pubkey || !statsPubkey) return null;
+
+ const combined = AbortSignal.any([signal, AbortSignal.timeout(2000)]);
+
+ try {
+ const events = await nostr.query(
+ [{ kinds: [30382], authors: [statsPubkey], '#d': [pubkey], limit: 1 }],
+ { signal: combined },
+ );
+
+ if (events.length === 0) return null;
+
+ const { tags } = events[0];
+ return {
+ followers: getIntTag(tags, 'followers'),
+ postCount: getIntTag(tags, 'post_cnt'),
+ };
+ } catch {
+ return null;
+ }
+ },
+ enabled: !!pubkey && !!statsPubkey,
+ staleTime: 60 * 1000,
+ retry: false,
+ });
+}
+
+/**
+ * Fetches NIP-85 addressable event stats (kind 30384) from the configured
+ * stats pubkey. The `addr` argument is the full NIP-01 event address string,
+ * e.g. `30023::`.
+ */
+export function useNip85AddrStats(addr: string | undefined) {
+ const { nostr } = useNostr();
+ const { config } = useAppContext();
+ const statsPubkey = config.nip85StatsPubkey;
+
+ return useQuery({
+ queryKey: ['nip85-addr-stats', addr, statsPubkey],
+ queryFn: async ({ signal }) => {
+ if (!addr || !statsPubkey) return null;
+
+ const combined = AbortSignal.any([signal, AbortSignal.timeout(2000)]);
+
+ try {
+ const events = await nostr.query(
+ [{ kinds: [30384], authors: [statsPubkey], '#d': [addr], limit: 1 }],
+ { signal: combined },
+ );
+
+ if (events.length === 0) return null;
+
+ const { tags } = events[0];
+ return {
+ commentCount: getIntTag(tags, 'comment_cnt'),
+ repostCount: getIntTag(tags, 'repost_cnt'),
+ reactionCount: getIntTag(tags, 'reaction_cnt'),
+ zapCount: getIntTag(tags, 'zap_cnt'),
+ zapAmount: getIntTag(tags, 'zap_amount'),
+ };
+ } catch {
+ return null;
+ }
+ },
+ enabled: !!addr && !!statsPubkey,
+ staleTime: 30 * 1000,
+ retry: false,
+ });
+}
diff --git a/.agents/skills/nostr-direct-messages/SKILL.md b/.agents/skills/nostr-direct-messages/SKILL.md
deleted file mode 100644
index 26f3ef56..00000000
--- a/.agents/skills/nostr-direct-messages/SKILL.md
+++ /dev/null
@@ -1,478 +0,0 @@
----
-name: nostr-direct-messages
-description: Implement Nostr direct messaging features, build chat interfaces, or work with encrypted peer-to-peer communication (NIP-04 and NIP-17).
----
-
-# Direct Messaging on Nostr
-
-This project includes a complete direct messaging system supporting both NIP-04 (legacy) and NIP-17 (modern, more private) encrypted messages with real-time subscriptions, optimistic updates, and a persistent cache-first local storage.
-
-**The DM system is not enabled by default** - follow the setup instructions below to add messaging functionality to your application.
-
-## Setup Instructions
-
-### 1. Add DMProvider to Your App
-
-First, add the `DMProvider` to your app's provider tree in `src/App.tsx`:
-
-```tsx
-// Add these imports at the top of src/App.tsx
-import { DMProvider, type DMConfig } from '@/components/DMProvider';
-import { PROTOCOL_MODE } from '@/lib/dmConstants';
-
-// Add this configuration before your App component
-const dmConfig: DMConfig = {
- // Enable or disable DMs entirely
- enabled: true, // Set to true to enable messaging functionality
-
- // Choose one protocol mode:
- // PROTOCOL_MODE.NIP04_ONLY - Force NIP-04 (legacy) only
- // PROTOCOL_MODE.NIP17_ONLY - Force NIP-17 (private) only
- // PROTOCOL_MODE.NIP04_OR_NIP17 - Allow users to choose between NIP-04 and NIP-17 (defaults to NIP-17)
- protocolMode: PROTOCOL_MODE.NIP17_ONLY, // Recommended for new apps
-};
-
-// Then wrap your app components with DMProvider:
-export function App() {
- return (
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- );
-}
-```
-
-### 2. Configure DM Settings
-
-The `DMConfig` object supports the following options:
-
-- `enabled` (boolean, default: `false`) - Enable/disable entire DM system. When false, no messages are loaded, stored, or processed.
-- `protocolMode` (ProtocolMode, default: `PROTOCOL_MODE.NIP17_ONLY`) - Which protocols to support:
- - `PROTOCOL_MODE.NIP04_ONLY` - Legacy encryption only
- - `PROTOCOL_MODE.NIP17_ONLY` - Modern private messages (recommended)
- - `PROTOCOL_MODE.NIP04_OR_NIP17` - Support both protocols (for backwards compatibility)
-
-**Note**: The DM system uses domain-based IndexedDB naming (`nostr-dm-store-${hostname}`) to prevent conflicts between multiple apps on the same domain.
-
-## Quick Start
-
-### 1. Send Messages
-
-```tsx
-import { useDMContext } from '@/hooks/useDMContext';
-import { MESSAGE_PROTOCOL } from '@/lib/dmConstants';
-
-function ComposeMessage({ recipientPubkey }: { recipientPubkey: string }) {
- const { sendMessage } = useDMContext();
- const [content, setContent] = useState('');
-
- const handleSend = async () => {
- await sendMessage({
- recipientPubkey,
- content,
- protocol: MESSAGE_PROTOCOL.NIP17, // Uses NIP-44 encryption + gift wrapping
- });
- setContent('');
- };
-
- return (
-