refactor: rename Ground Truth → Anchr throughout protocol layer

- Protocol tag: ["t", "ground-truth"] → ["t", "anchr"]
- Constants: GT_* → ANCHR_* (ANCHR_QUERY_REQUEST, etc.)
- Query ID prefix: gt_ → anchr_
- Protocol version: ground-truth:v1 → anchr:v1
- All doc comments updated

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: motxx

src/cashu/wallet.ts

@@ -1,5 +1,5 @@
 /**
- * Cashu ecash wallet for Ground Truth Protocol.
+ * Cashu ecash wallet for Anchr.
  *
  * Provides anonymous payment capabilities:
  * - Mint tokens from a Cashu mint (backed by Lightning sats)

src/nostr/client.ts

@@ -1,5 +1,5 @@
 /**
- * Nostr relay client for Ground Truth Protocol (NIP-90 DVM).
+ * Nostr relay client for Anchr (NIP-90 DVM).
  *
  * Handles connection to multiple relays, event publishing,
  * and subscription management. Event kinds follow the NIP-90
@@ -9,8 +9,8 @@
 import { SimplePool, type SubCloser } from "nostr-tools/pool";
 import type { Filter } from "nostr-tools/filter";
 import type { Event, VerifiedEvent } from "nostr-tools/core";
-import { GT_QUERY_REQUEST, GT_QUERY_RESPONSE, GT_QUERY_SETTLEMENT } from "./events";
-import { GT_ORACLE_ATTESTATION } from "./oracle-attestation";
+import { ANCHR_QUERY_REQUEST, ANCHR_QUERY_RESPONSE, ANCHR_QUERY_SETTLEMENT } from "./events";
+import { ANCHR_ORACLE_ATTESTATION } from "./oracle-attestation";
 
 export interface NostrClientConfig {
   relayUrls: string[];
@@ -69,7 +69,7 @@ export async function publishEvent(
 }
 
 /**
- * Subscribe to Ground Truth query request events (DVM kind 5300).
+ * Subscribe to Anchr query request events (DVM kind 5300).
  */
 export function subscribeToQueries(
   onEvent: (event: Event) => void,
@@ -83,8 +83,8 @@ export function subscribeToQueries(
   const pool = getPool();
 
   const filter: Filter = {
-    kinds: [GT_QUERY_REQUEST],
-    "#t": ["ground-truth"],
+    kinds: [ANCHR_QUERY_REQUEST],
+    "#t": ["anchr"],
     since: Math.floor(Date.now() / 1000) - 3600, // last hour
   };
 
@@ -110,7 +110,7 @@ export function subscribeToResponses(
   const pool = getPool();
 
   return pool.subscribeMany(urls, {
-    kinds: [GT_QUERY_RESPONSE],
+    kinds: [ANCHR_QUERY_RESPONSE],
     "#e": [queryEventId],
   }, {
     onevent: onEvent,
@@ -130,7 +130,7 @@ export function subscribeToSettlements(
   const pool = getPool();
 
   return pool.subscribeMany(urls, {
-    kinds: [GT_QUERY_SETTLEMENT],
+    kinds: [ANCHR_QUERY_SETTLEMENT],
     "#e": [queryEventId],
   }, {
     onevent: onEvent,
@@ -150,7 +150,7 @@ export function subscribeToAttestations(
   const pool = getPool();
 
   return pool.subscribeMany(urls, {
-    kinds: [GT_ORACLE_ATTESTATION],
+    kinds: [ANCHR_ORACLE_ATTESTATION],
     "#e": [queryEventId],
   }, {
     onevent: onEvent,
@@ -172,8 +172,8 @@ export async function fetchRecentQueries(
   const pool = getPool();
 
   const filter: Filter = {
-    kinds: [GT_QUERY_REQUEST],
-    "#t": ["ground-truth"],
+    kinds: [ANCHR_QUERY_REQUEST],
+    "#t": ["anchr"],
     since: Math.floor(Date.now() / 1000) - 3600,
     limit: options?.limit ?? 50,
   };

src/nostr/encryption.ts

@@ -1,5 +1,5 @@
 /**
- * Encryption utilities for Ground Truth Protocol over Nostr.
+ * Encryption utilities for Anchr over Nostr.
  *
  * Two modes:
  * 1. Region-key encryption: Derive a shared key from region code.
@@ -13,7 +13,7 @@ import { sha256 } from "@noble/hashes/sha2.js";
 import { bytesToHex } from "@noble/hashes/utils.js";
 import { nip44 } from "nostr-tools";
 
-const PROTOCOL_VERSION = "ground-truth:v1";
+const PROTOCOL_VERSION = "anchr:v1";
 
 /**
  * Derive a region key from a region code (e.g., "IR", "CN", "JP").

src/nostr/events.test.ts

@@ -7,9 +7,9 @@ import {
   parseQueryRequestPayload,
   parseQueryResponsePayload,
   parseQuerySettlementPayload,
-  GT_QUERY_REQUEST,
-  GT_QUERY_RESPONSE,
-  GT_QUERY_SETTLEMENT,
+  ANCHR_QUERY_REQUEST,
+  ANCHR_QUERY_RESPONSE,
+  ANCHR_QUERY_SETTLEMENT,
   type QueryRequestPayload,
 } from "./events";
 
@@ -25,7 +25,7 @@ describe("Nostr events (NIP-90 DVM)", () => {
 
     const event = buildQueryRequestEvent(identity, "query_123", payload, "IR");
 
-    expect(event.kind).toBe(GT_QUERY_REQUEST);
+    expect(event.kind).toBe(ANCHR_QUERY_REQUEST);
     expect(event.kind).toBe(5300); // DVM Job Request
     expect(event.pubkey).toBe(identity.publicKey);
 
@@ -34,7 +34,7 @@ describe("Nostr events (NIP-90 DVM)", () => {
     expect(dTag?.[1]).toBe("query_123");
 
     const tTags = event.tags.filter((t) => t[0] === "t");
-    expect(tTags.some((t) => t[1] === "ground-truth")).toBe(true);
+    expect(tTags.some((t) => t[1] === "anchr")).toBe(true);
     expect(tTags.some((t) => t[1] === "photo_proof")).toBe(true);
 
     const regionTag = event.tags.find((t) => t[0] === "region");
@@ -101,7 +101,7 @@ describe("Nostr events (NIP-90 DVM)", () => {
       },
     );
 
-    expect(response.kind).toBe(GT_QUERY_RESPONSE);
+    expect(response.kind).toBe(ANCHR_QUERY_RESPONSE);
     expect(response.pubkey).toBe(worker.publicKey);
 
     // Requester can decrypt
@@ -131,7 +131,7 @@ describe("Nostr events (NIP-90 DVM)", () => {
       },
     );
 
-    expect(settlement.kind).toBe(GT_QUERY_SETTLEMENT);
+    expect(settlement.kind).toBe(ANCHR_QUERY_SETTLEMENT);
 
     // Check tags
     const eTags = settlement.tags.filter((t) => t[0] === "e");

src/nostr/events.ts

@@ -1,13 +1,13 @@
 /**
- * Ground Truth Protocol Nostr event builders and parsers.
+ * Anchr Nostr event builders and parsers.
  *
  * Uses NIP-90 Data Vending Machine (DVM) event kinds so that any
  * DVM-aware client can discover and interact with Anchr queries.
  *
  * Event kind mapping (GT constant → DVM kind):
- *   GT_QUERY_REQUEST   = 5300  (DVM Job Request)
- *   GT_QUERY_RESPONSE  = 6300  (DVM Job Result)
- *   GT_QUERY_SETTLEMENT = 7000 (DVM Job Feedback)
+ *   ANCHR_QUERY_REQUEST   = 5300  (DVM Job Request)
+ *   ANCHR_QUERY_RESPONSE  = 6300  (DVM Job Result)
+ *   ANCHR_QUERY_SETTLEMENT = 7000 (DVM Job Feedback)
  *
  * OracleAttestation (30103) remains a custom parametric-replaceable kind.
  */
@@ -16,11 +16,10 @@ import { finalizeEvent, type EventTemplate, type VerifiedEvent } from "nostr-too
 import type { NostrIdentity } from "./identity";
 import { deriveConversationKey, encryptNip44, decryptNip44 } from "./encryption";
 
-// NIP-90 DVM event kinds for Ground Truth Protocol.
-// Constant names kept as GT_* for backward compat; values are DVM kinds.
-export const GT_QUERY_REQUEST = 5300;   // was 30100 → DVM Job Request
-export const GT_QUERY_RESPONSE = 6300;  // was 30101 → DVM Job Result
-export const GT_QUERY_SETTLEMENT = 7000; // was 30102 → DVM Job Feedback
+// NIP-90 DVM event kinds for Anchr.
+export const ANCHR_QUERY_REQUEST = 5300;   // DVM Job Request
+export const ANCHR_QUERY_RESPONSE = 6300;  // DVM Job Result
+export const ANCHR_QUERY_SETTLEMENT = 7000; // DVM Job Feedback
 
 export interface QueryRequestPayload {
   type: string;
@@ -65,7 +64,7 @@ export interface QuerySettlementPayload {
  *   ["output", "application/json"] - expected result MIME type
  *   ["encrypted"]                 - signals that the result should be NIP-44 encrypted
  *   ["d", <queryId>]              - deduplication / replaceable-event tag
- *   ["t", "ground-truth"]         - protocol marker
+ *   ["t", "anchr"]                - protocol marker
  *   ["t", <query_type>]           - query type tag
  *   ["expiration", <unix>]        - NIP-40 expiration
  *   ["region", <code>]            - optional region filter
@@ -87,7 +86,7 @@ export function buildQueryRequestEvent(
     ["output", "application/json"],
     ["encrypted"],
     ["d", queryId],
-    ["t", "ground-truth"],
+    ["t", "anchr"],
     ["t", payload.type],
     ["expiration", String(Math.floor(payload.expires_at / 1000))],
   ];
@@ -102,7 +101,7 @@ export function buildQueryRequestEvent(
   }
 
   const template: EventTemplate = {
-    kind: GT_QUERY_REQUEST,
+    kind: ANCHR_QUERY_REQUEST,
     created_at: Math.floor(Date.now() / 1000),
     tags,
     content: JSON.stringify(payload),
@@ -136,7 +135,7 @@ export function buildQueryResponseEvent(
   const encrypted = encryptNip44(JSON.stringify(payload), conversationKey);
 
   const template: EventTemplate = {
-    kind: GT_QUERY_RESPONSE,
+    kind: ANCHR_QUERY_RESPONSE,
     created_at: Math.floor(Date.now() / 1000),
     tags: [
       ["e", queryEventId],
@@ -163,7 +162,7 @@ export function buildQuerySettlementEvent(
   const encrypted = encryptNip44(JSON.stringify(payload), conversationKey);
 
   const template: EventTemplate = {
-    kind: GT_QUERY_SETTLEMENT,
+    kind: ANCHR_QUERY_SETTLEMENT,
     created_at: Math.floor(Date.now() / 1000),
     tags: [
       ["e", queryEventId],

src/nostr/index.ts

@@ -15,9 +15,9 @@ export {
   regionKeyHex,
 } from "./encryption";
 export {
-  GT_QUERY_REQUEST,
-  GT_QUERY_RESPONSE,
-  GT_QUERY_SETTLEMENT,
+  ANCHR_QUERY_REQUEST,
+  ANCHR_QUERY_RESPONSE,
+  ANCHR_QUERY_SETTLEMENT,
   buildQueryRequestEvent,
   buildQueryResponseEvent,
   buildQuerySettlementEvent,
@@ -40,7 +40,7 @@ export {
   closePool,
 } from "./client";
 export {
-  GT_ORACLE_ATTESTATION,
+  ANCHR_ORACLE_ATTESTATION,
   buildOracleAttestationEvent,
   parseOracleAttestationPayload,
   toOracleAttestation,

src/nostr/nostr-query-service.ts

@@ -167,7 +167,7 @@ export async function createNostrQuery(
 ): Promise<Query | null> {
   const identity = generateEphemeralIdentity();
   const nonce = generateNonce();
-  const queryId = `gt_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+  const queryId = `anchr_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
   const ttlMs = options?.ttlMs ?? 600_000;
   const expiresAt = Date.now() + ttlMs;
 

src/nostr/oracle-attestation.test.ts

@@ -4,7 +4,7 @@ import {
   buildOracleAttestationEvent,
   parseOracleAttestationPayload,
   toOracleAttestation,
-  GT_ORACLE_ATTESTATION,
+  ANCHR_ORACLE_ATTESTATION,
 } from "./oracle-attestation";
 import type { OracleAttestation } from "../oracle/types";
 
@@ -27,7 +27,7 @@ test("buildOracleAttestationEvent creates valid event", () => {
     attestation,
   );
 
-  expect(event.kind).toBe(GT_ORACLE_ATTESTATION);
+  expect(event.kind).toBe(ANCHR_ORACLE_ATTESTATION);
   expect(event.pubkey).toBe(oracleIdentity.publicKey);
 
   // Tags

src/nostr/oracle-attestation.ts

@@ -1,5 +1,5 @@
 /**
- * Oracle attestation events for Ground Truth Protocol.
+ * Oracle attestation events for Anchr.
  *
  * Kind 30103 - OracleAttestation: published by oracle after verification.
  * Publicly verifiable — anyone can check the oracle's signature and
@@ -10,7 +10,7 @@ import { finalizeEvent, type EventTemplate, type VerifiedEvent } from "nostr-too
 import type { NostrIdentity } from "./identity";
 import type { OracleAttestation } from "../oracle/types";
 
-export const GT_ORACLE_ATTESTATION = 30103;
+export const ANCHR_ORACLE_ATTESTATION = 30103;
 
 export interface OracleAttestationPayload {
   oracle_id: string;
@@ -42,13 +42,13 @@ export function buildOracleAttestationEvent(
   };
 
   const template: EventTemplate = {
-    kind: GT_ORACLE_ATTESTATION,
+    kind: ANCHR_ORACLE_ATTESTATION,
     created_at: Math.floor(Date.now() / 1000),
     tags: [
       ["e", queryEventId],
       ["e", responseEventId],
       ["d", attestation.query_id],
-      ["t", "ground-truth"],
+      ["t", "anchr"],
       ["t", "attestation"],
       ["result", attestation.passed ? "pass" : "fail"],
     ],

src/nostr/query-bridge.ts

@@ -70,7 +70,7 @@ export async function publishQueryToNostr(
 
   const identity = generateEphemeralIdentity();
   const nonce = generateNonce();
-  const queryId = `gt_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+  const queryId = `anchr_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
 
   const payload: QueryRequestPayload = {
     type: input.type,