signet-protocol 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ForgeSworn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,112 @@
+# Signet
+
+**Decentralised identity verification for Nostr.**
+
+Signet is an open protocol that enables users to prove claims about their identity — age, parenthood, professional status — using zero-knowledge proofs, without revealing personal data or relying on a central authority.
+
+## What It Does
+
+- **4 verification tiers**: self-declared → web-of-trust → professional adult → professional adult+child
+- **Signet IQ** (0-200, where 100 = government standard): weighted by professional verification > in-person vouches > online vouches > account age
+- **Verifier anti-corruption**: 6 layers of accountability for professional verifiers
+- **ZKP age proofs**: prove "child aged 8-12" without revealing exact date of birth
+- **Blue checkmarks for Nostr**: decentralised, cryptographic social proof for everyone
+- **Community policies**: any relay, client, or community sets their own minimum verification requirements
+
+## Why
+
+Nostr has no identity layer. Anyone can claim to be anyone. This matters for child safety (a predator can create a fake child account), for trust (no way to prove "I met this person"), and for regulation (age verification laws are coming worldwide).
+
+Signet solves this without centralised data collection. A professional verifies your identity in person. A ZKP credential attests to the result. No personal data is stored. No database to breach.
+
+## Quick Start
+
+```bash
+npm install signet-protocol
+```
+
+Display a verification badge for any Nostr user (Level 1 — a weekend to integrate):
+
+```typescript
+import { computeBadge, buildBadgeFilters, meetsMinimumTier } from 'signet-protocol';
+
+const filters = buildBadgeFilters(['<hex-pubkey>']);
+const events = await fetchFromRelay(filters);
+const badge = computeBadge('<hex-pubkey>', events, { verifySignatures: true });
+
+// badge.tier => 3, badge.score => 106, badge.displayLabel => "Verified (Tier 3)"
+if (meetsMinimumTier(badge, 2)) {
+  // allow posting in verified-only community
+}
+```
+
+See [Signet in 5 Minutes](docs/signet-in-5-minutes.md) for a full developer overview, or the [full flow example](examples/full-flow.ts) for all 4 tiers, trust scoring, policies, and verifier lifecycle.
+
+## Protocol
+
+The full specification is at [`spec/protocol.md`](spec/protocol.md).
+
+### Event Kinds
+
+All identity attestations use a single NIP-VA kind (31000), differentiated by `type` tag:
+
+| Kind | Type Tag | Name | Purpose |
+|------|----------|------|---------|
+| 31000 | `credential` | Verification Credential | Attests to a subject's verification tier |
+| 31000 | `vouch` | Vouch Attestation | Peer vouch for another user |
+| 30078 | — | Community Verification Policy | Minimum verification requirements (NIP-78) |
+| 31000 | `verifier` | Verifier Credential | Professional declares verifier status |
+| 31000 | `challenge` | Verifier Challenge | Challenge a verifier's legitimacy |
+| 31000 | `revocation` | Verifier Revocation | Community confirms challenge, revokes verifier |
+| 31000 | `identity-bridge` | Identity Bridge | Link two keypairs via ring signature |
+| 31000 | `delegation` | Delegation | Guardian or agent delegation with scoped permission |
+| 30482 | — | Election | Voting extension: define an election |
+| 30483 | — | Ballot | Voting extension: cast an anonymous ballot |
+| 30484 | — | Election Result | Voting extension: publish tallied result |
+
+### Crypto Stack
+
+```
+Layer 1: Schnorr (secp256k1) — zero new dependencies
+         Credential signing, Merkle selective disclosure,
+         ring signatures for issuer privacy, MuSig2
+
+Layer 2: Bulletproofs (secp256k1) — age range proofs
+         ~700 byte proofs, no trusted setup
+
+Layer 3: General-purpose ZK (future, if needed)
+         Complex threshold proofs, recursive composition
+```
+
+## Status
+
+**v0.1.0** — spec complete, TypeScript library implemented, reference apps functional. Seeking community feedback.
+
+Kind numbers are placeholders pending NIP allocation.
+
+## Implementation
+
+This repo includes:
+- `src/` — TypeScript protocol library (`signet-protocol` on npm)
+
+Signet is a standalone protocol. Any Nostr client can implement it independently.
+
+## Regulatory Compatibility
+
+Signet is designed to satisfy identity verification requirements across jurisdictions:
+
+| Regulation | Position |
+|------------|----------|
+| **UK Online Safety Act** | Tier 4 exceeds Ofcom's "highly effective age assurance" standard |
+| **US COPPA** | No PII collected — exceeds FTC's March 2026 flexibility policy |
+| **EU eIDAS 2.0** | Compatible with selective disclosure direction |
+| **ISO/IEC 27566-1:2025** | Compatible with outcomes-based age assurance framework |
+| **Australia under-16 ban** | Proves age range without central verification |
+
+## Contributing
+
+Feedback, NIP discussion, and contributions are welcome. Open an issue or submit a PR.
+
+## Licence
+
+MIT

package/dist/anomaly.d.ts

@@ -0,0 +1,42 @@
+import type { NostrEvent } from './types.js';
+/** Types of anomaly flags */
+export type AnomalyType = 'volume' | 'temporal' | 'geographic' | 'pattern';
+/** A detected anomaly */
+export interface AnomalyFlag {
+    type: AnomalyType;
+    verifierPubkey: string;
+    severity: 'low' | 'medium' | 'high';
+    description: string;
+    evidence: {
+        metric: string;
+        value: number;
+        threshold: number;
+    };
+}
+/** Anomaly detection configuration */
+export interface AnomalyConfig {
+    /** Max credentials per week before flagging (default: 20) */
+    maxWeeklyVolume: number;
+    /** Max credentials per hour before flagging (default: 5) */
+    maxHourlyVolume: number;
+    /** Max percentage of credentials in a single foreign jurisdiction (default: 30) */
+    maxForeignJurisdictionPercent: number;
+    /** Min time between consecutive credentials in seconds (default: 300 = 5 min) */
+    minTimeBetweenCredentials: number;
+    /** Volume multiplier vs network average to flag (default: 5) */
+    volumeMultiplierThreshold: number;
+}
+/**
+ * Analyze a verifier's issuance patterns for anomalies.
+ *
+ * @param verifierPubkey - The verifier to analyze
+ * @param allCredentials - All credential events (kind 31000, type: credential) in the store
+ * @param verifierCredential - The verifier's own credential (kind 31000, type: verifier)
+ * @param config - Detection thresholds
+ */
+export declare function detectAnomalies(verifierPubkey: string, allCredentials: NostrEvent[], verifierCredential?: NostrEvent, config?: Partial<AnomalyConfig>): AnomalyFlag[];
+/**
+ * Get a summary of all flagged verifiers from a set of credentials.
+ */
+export declare function scanForAnomalies(allCredentials: NostrEvent[], verifierCredentials: NostrEvent[], config?: Partial<AnomalyConfig>): Map<string, AnomalyFlag[]>;
+//# sourceMappingURL=anomaly.d.ts.map

package/dist/anomaly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anomaly.d.ts","sourceRoot":"","sources":["../src/anomaly.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,6BAA6B;AAC7B,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,SAAS,CAAC;AAE3E,yBAAyB;AACzB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,sCAAsC;AACtC,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,eAAe,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,eAAe,EAAE,MAAM,CAAC;IACxB,mFAAmF;IACnF,6BAA6B,EAAE,MAAM,CAAC;IACtC,iFAAiF;IACjF,yBAAyB,EAAE,MAAM,CAAC;IAClC,gEAAgE;IAChE,yBAAyB,EAAE,MAAM,CAAC;CACnC;AAUD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,UAAU,EAAE,EAC5B,kBAAkB,CAAC,EAAE,UAAU,EAC/B,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAClC,WAAW,EAAE,CA6Bf;AA+LD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,cAAc,EAAE,UAAU,EAAE,EAC5B,mBAAmB,EAAE,UAAU,EAAE,EACjC,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAC9B,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAoB5B"}

package/dist/anomaly.js

@@ -0,0 +1,209 @@
+// Verifier Anomaly Detection
+// Statistical analysis of verifier issuance patterns
+// Layer 3 of the anti-corruption framework
+import { ATTESTATION_KIND, ATTESTATION_TYPES } from './constants.js';
+import { getTagValue } from './validation.js';
+const DEFAULT_CONFIG = {
+    maxWeeklyVolume: 20,
+    maxHourlyVolume: 5,
+    maxForeignJurisdictionPercent: 30,
+    minTimeBetweenCredentials: 300,
+    volumeMultiplierThreshold: 5,
+};
+/**
+ * Analyze a verifier's issuance patterns for anomalies.
+ *
+ * @param verifierPubkey - The verifier to analyze
+ * @param allCredentials - All credential events (kind 31000, type: credential) in the store
+ * @param verifierCredential - The verifier's own credential (kind 31000, type: verifier)
+ * @param config - Detection thresholds
+ */
+export function detectAnomalies(verifierPubkey, allCredentials, verifierCredential, config = {}) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    const flags = [];
+    // Get this verifier's issued credentials
+    const issued = allCredentials.filter((e) => e.kind === ATTESTATION_KIND && getTagValue(e, 'type') === ATTESTATION_TYPES.CREDENTIAL && e.pubkey === verifierPubkey);
+    if (issued.length === 0)
+        return flags;
+    // Sort by time
+    const sorted = [...issued].sort((a, b) => a.created_at - b.created_at);
+    // --- Volume Analysis ---
+    flags.push(...analyzeVolume(verifierPubkey, sorted, allCredentials, cfg));
+    // --- Temporal Analysis ---
+    flags.push(...analyzeTemporal(verifierPubkey, sorted, cfg));
+    // --- Geographic Analysis ---
+    if (verifierCredential) {
+        flags.push(...analyzeGeographic(verifierPubkey, sorted, verifierCredential, cfg));
+    }
+    // --- Pattern Analysis ---
+    flags.push(...analyzePatterns(verifierPubkey, sorted));
+    return flags;
+}
+/** Volume anomaly detection */
+function analyzeVolume(verifierPubkey, issued, allCredentials, cfg) {
+    const flags = [];
+    const now = Math.floor(Date.now() / 1000);
+    const oneWeek = 7 * 24 * 60 * 60;
+    const oneHour = 60 * 60;
+    // Weekly volume
+    const weeklyCount = issued.filter((e) => e.created_at > now - oneWeek).length;
+    if (weeklyCount > cfg.maxWeeklyVolume) {
+        flags.push({
+            type: 'volume',
+            verifierPubkey,
+            severity: weeklyCount > cfg.maxWeeklyVolume * 3 ? 'high' : 'medium',
+            description: `Issued ${weeklyCount} credentials this week (threshold: ${cfg.maxWeeklyVolume})`,
+            evidence: { metric: 'weekly_volume', value: weeklyCount, threshold: cfg.maxWeeklyVolume },
+        });
+    }
+    // Hourly volume (burst detection)
+    const hourlyCount = issued.filter((e) => e.created_at > now - oneHour).length;
+    if (hourlyCount > cfg.maxHourlyVolume) {
+        flags.push({
+            type: 'volume',
+            verifierPubkey,
+            severity: 'high',
+            description: `Issued ${hourlyCount} credentials in the last hour (threshold: ${cfg.maxHourlyVolume})`,
+            evidence: { metric: 'hourly_volume', value: hourlyCount, threshold: cfg.maxHourlyVolume },
+        });
+    }
+    // Compare to network average
+    const allVerifiers = new Set(allCredentials.filter((e) => e.kind === ATTESTATION_KIND && getTagValue(e, 'type') === ATTESTATION_TYPES.CREDENTIAL).map((e) => e.pubkey));
+    if (allVerifiers.size > 1) {
+        const totalCredentials = allCredentials.filter((e) => e.kind === ATTESTATION_KIND && getTagValue(e, 'type') === ATTESTATION_TYPES.CREDENTIAL && e.created_at > now - oneWeek).length;
+        const networkAvg = totalCredentials / allVerifiers.size;
+        if (networkAvg > 0 && weeklyCount > networkAvg * cfg.volumeMultiplierThreshold) {
+            flags.push({
+                type: 'volume',
+                verifierPubkey,
+                severity: 'high',
+                description: `Weekly volume ${weeklyCount} is ${(weeklyCount / networkAvg).toFixed(1)}x the network average of ${networkAvg.toFixed(1)}`,
+                evidence: {
+                    metric: 'volume_vs_average',
+                    value: weeklyCount / networkAvg,
+                    threshold: cfg.volumeMultiplierThreshold,
+                },
+            });
+        }
+    }
+    return flags;
+}
+/** Temporal anomaly detection */
+function analyzeTemporal(verifierPubkey, sorted, cfg) {
+    const flags = [];
+    if (sorted.length < 2)
+        return flags;
+    // Check minimum time between consecutive credentials
+    let rapidCount = 0;
+    let minGap = Infinity;
+    for (let i = 1; i < sorted.length; i++) {
+        const gap = sorted[i].created_at - sorted[i - 1].created_at;
+        if (gap < cfg.minTimeBetweenCredentials) {
+            rapidCount++;
+        }
+        if (gap < minGap)
+            minGap = gap;
+    }
+    if (rapidCount > 0) {
+        flags.push({
+            type: 'temporal',
+            verifierPubkey,
+            severity: rapidCount > 5 ? 'high' : 'medium',
+            description: `${rapidCount} credential pairs issued less than ${cfg.minTimeBetweenCredentials}s apart (min gap: ${minGap}s). Suggests rubber-stamping, not in-person verification.`,
+            evidence: { metric: 'rapid_issuance_count', value: rapidCount, threshold: 0 },
+        });
+    }
+    return flags;
+}
+/** Geographic anomaly detection */
+function analyzeGeographic(verifierPubkey, issued, verifierCredential, cfg) {
+    const flags = [];
+    const verifierJurisdiction = getTagValue(verifierCredential, 'jurisdiction');
+    if (!verifierJurisdiction)
+        return flags;
+    // Count jurisdictions in issued credentials
+    const jurisdictionCounts = new Map();
+    for (const cred of issued) {
+        const j = getTagValue(cred, 'jurisdiction') || 'unknown';
+        jurisdictionCounts.set(j, (jurisdictionCounts.get(j) || 0) + 1);
+    }
+    // Check for high foreign jurisdiction percentage
+    for (const [jurisdiction, count] of jurisdictionCounts) {
+        if (jurisdiction === verifierJurisdiction)
+            continue;
+        const percent = (count / issued.length) * 100;
+        if (percent > cfg.maxForeignJurisdictionPercent) {
+            flags.push({
+                type: 'geographic',
+                verifierPubkey,
+                severity: percent > 60 ? 'high' : 'medium',
+                description: `${percent.toFixed(0)}% of credentials (${count}/${issued.length}) issued in ${jurisdiction}, but verifier is registered in ${verifierJurisdiction}`,
+                evidence: {
+                    metric: 'foreign_jurisdiction_percent',
+                    value: percent,
+                    threshold: cfg.maxForeignJurisdictionPercent,
+                },
+            });
+        }
+    }
+    return flags;
+}
+/** Pattern anomaly detection */
+function analyzePatterns(verifierPubkey, sorted) {
+    const flags = [];
+    if (sorted.length < 5)
+        return flags;
+    // Check for repeated subjects (same person verified multiple times)
+    const subjectCounts = new Map();
+    for (const cred of sorted) {
+        const subject = getTagValue(cred, 'd') || '';
+        subjectCounts.set(subject, (subjectCounts.get(subject) || 0) + 1);
+    }
+    const duplicates = Array.from(subjectCounts.entries()).filter(([, count]) => count > 1);
+    if (duplicates.length > 0) {
+        const totalDupes = duplicates.reduce((sum, [, count]) => sum + count - 1, 0);
+        flags.push({
+            type: 'pattern',
+            verifierPubkey,
+            severity: 'low',
+            description: `${duplicates.length} subjects verified multiple times (${totalDupes} extra verifications)`,
+            evidence: { metric: 'duplicate_subjects', value: duplicates.length, threshold: 0 },
+        });
+    }
+    // Check for disproportionate tier 4 issuance
+    let tier4Count = 0;
+    for (const cred of sorted) {
+        if (getTagValue(cred, 'tier') === '4')
+            tier4Count++;
+    }
+    const tier4Percent = (tier4Count / sorted.length) * 100;
+    if (tier4Count > 3 && tier4Percent > 80) {
+        flags.push({
+            type: 'pattern',
+            verifierPubkey,
+            severity: 'medium',
+            description: `${tier4Percent.toFixed(0)}% of credentials are Tier 4 (${tier4Count}/${sorted.length}). Unusually high child verification rate.`,
+            evidence: { metric: 'tier4_percent', value: tier4Percent, threshold: 80 },
+        });
+    }
+    return flags;
+}
+/**
+ * Get a summary of all flagged verifiers from a set of credentials.
+ */
+export function scanForAnomalies(allCredentials, verifierCredentials, config) {
+    const results = new Map();
+    // Get unique verifier pubkeys from credentials
+    const verifiers = new Set(allCredentials
+        .filter((e) => e.kind === ATTESTATION_KIND && getTagValue(e, 'type') === ATTESTATION_TYPES.CREDENTIAL)
+        .map((e) => e.pubkey));
+    for (const pubkey of verifiers) {
+        const verifierCred = verifierCredentials.find((c) => c.pubkey === pubkey);
+        const flags = detectAnomalies(pubkey, allCredentials, verifierCred, config);
+        if (flags.length > 0) {
+            results.set(pubkey, flags);
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=anomaly.js.map

package/dist/anomaly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anomaly.js","sourceRoot":"","sources":["../src/anomaly.ts"],"names":[],"mappings":"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"}

package/dist/badge.d.ts

@@ -0,0 +1,56 @@
+import type { NostrEvent, SignetTier } from './types.js';
+export interface BadgeInfo {
+    /** The pubkey this badge describes */
+    pubkey: string;
+    /** Highest verification tier (1-4) */
+    tier: SignetTier;
+    /** Human-readable tier label */
+    tierLabel: string;
+    /** Signet Score (0-200) */
+    score: number;
+    /** Whether the user has any valid credentials */
+    isVerified: boolean;
+    /** Short display string, e.g. "Verified (Tier 3)" */
+    displayLabel: string;
+    /** Number of valid credentials */
+    credentialCount: number;
+    /** Number of valid vouches */
+    vouchCount: number;
+}
+export type TrustLevel = 'unverified' | 'self-declared' | 'vouched' | 'professional' | 'professional-child';
+/**
+ * Compute badge info for a pubkey from their credentials and vouches.
+ * This is the main entry point for Level 1 integration.
+ *
+ * @param pubkey - The Nostr pubkey to compute a badge for
+ * @param events - All relevant kind 31000 (`type: credential` and `type: vouch`) events
+ * @param options - Optional configuration
+ * @returns Badge info for display
+ */
+export declare function computeBadge(pubkey: string, events: NostrEvent[], options?: {
+    verifySignatures?: boolean;
+    now?: number;
+}): Promise<BadgeInfo>;
+/**
+ * Get the trust level classification for a badge.
+ */
+export declare function getTrustLevel(badge: BadgeInfo): TrustLevel;
+/**
+ * Check if a pubkey has at least the required tier.
+ * Useful for gating access to features or communities.
+ */
+export declare function meetsMinimumTier(badge: BadgeInfo, minTier: SignetTier): boolean;
+/**
+ * Filter a set of events to only those relevant for a given pubkey.
+ * Useful when you have a mixed bag of events from a relay query.
+ */
+export declare function filterEventsForPubkey(pubkey: string, events: NostrEvent[]): NostrEvent[];
+/**
+ * Build a Nostr filter for fetching badge-relevant events for one or more pubkeys.
+ * Returns filters suitable for use with REQ messages.
+ */
+export declare function buildBadgeFilters(pubkeys: string[]): Array<{
+    kinds: number[];
+    '#d': string[];
+}>;
+//# sourceMappingURL=badge.d.ts.map

package/dist/badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"badge.d.ts","sourceRoot":"","sources":["../src/badge.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAIzD,MAAM,WAAW,SAAS;IACxB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,IAAI,EAAE,UAAU,CAAC;IACjB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,UAAU,EAAE,OAAO,CAAC;IACpB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,eAAe,GAAG,SAAS,GAAG,cAAc,GAAG,oBAAoB,CAAC;AAkB5G;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD,OAAO,CAAC,SAAS,CAAC,CAiGpB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,CAG1D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAE/E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAYxF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAS/F"}

package/dist/badge.js

@@ -0,0 +1,171 @@
+// Level 1 Badge Display Library
+// Minimal drop-in module for Nostr clients to display Signet trust badges.
+// Requires only kind 31000 (type: credential and type: vouch) and Schnorr verification.
+import { ATTESTATION_KIND, ATTESTATION_TYPES, TRUST_WEIGHTS, MAX_TRUST_SCORE } from './constants.js';
+import { verifyEvent } from './crypto.js';
+import { getTagValue } from './validation.js';
+const TIER_LABELS = {
+    1: 'Self-declared',
+    2: 'Web-of-trust',
+    3: 'Verified',
+    4: 'Verified (Child Safety)',
+};
+const TIER_TO_TRUST_LEVEL = {
+    1: 'self-declared',
+    2: 'vouched',
+    3: 'professional',
+    4: 'professional-child',
+};
+// --- Core Functions ---
+/**
+ * Compute badge info for a pubkey from their credentials and vouches.
+ * This is the main entry point for Level 1 integration.
+ *
+ * @param pubkey - The Nostr pubkey to compute a badge for
+ * @param events - All relevant kind 31000 (`type: credential` and `type: vouch`) events
+ * @param options - Optional configuration
+ * @returns Badge info for display
+ */
+export async function computeBadge(pubkey, events, options) {
+    const now = options?.now ?? Math.floor(Date.now() / 1000);
+    const verify = options?.verifySignatures ?? false;
+    let highestTier = 1;
+    let rawScore = 0;
+    let credentialCount = 0;
+    let hasAnyCredential = false;
+    // Process credentials
+    for (const event of events) {
+        if (event.kind !== ATTESTATION_KIND)
+            continue;
+        if (getTagValue(event, 'type') !== ATTESTATION_TYPES.CREDENTIAL)
+            continue;
+        const dTag = getTagValue(event, 'd') || '';
+        const pTag = getTagValue(event, 'p');
+        let subject;
+        if (dTag.startsWith('assertion:') && pTag) {
+            subject = pTag;
+        }
+        else {
+            subject = dTag.startsWith('credential:') ? dTag.slice('credential:'.length) : dTag;
+        }
+        if (subject !== pubkey)
+            continue;
+        // Check expiry — NaN must be treated as expired (not perpetually valid)
+        const expires = getTagValue(event, 'expiration');
+        if (expires) {
+            const exp = parseInt(expires, 10);
+            if (isNaN(exp) || exp < now)
+                continue;
+        }
+        // Optional signature verification
+        if (verify && !await verifyEvent(event))
+            continue;
+        hasAnyCredential = true;
+        credentialCount++;
+        const rawTier = parseInt(getTagValue(event, 'tier') || '1', 10);
+        const tier = (rawTier >= 1 && rawTier <= 4 ? rawTier : 1);
+        if (tier > highestTier)
+            highestTier = tier;
+        const verificationType = getTagValue(event, 'verification-type');
+        if (verificationType === 'professional') {
+            rawScore += TRUST_WEIGHTS.PROFESSIONAL_VERIFICATION;
+        }
+    }
+    // Process vouches
+    const vouchersSeen = new Set();
+    let vouchCount = 0;
+    for (const event of events) {
+        if (event.kind !== ATTESTATION_KIND)
+            continue;
+        if (getTagValue(event, 'type') !== ATTESTATION_TYPES.VOUCH)
+            continue;
+        const dTag = getTagValue(event, 'd') || '';
+        const subject = dTag.startsWith('vouch:') ? dTag.slice('vouch:'.length) : dTag;
+        if (subject !== pubkey)
+            continue;
+        // One vouch per voucher
+        if (vouchersSeen.has(event.pubkey))
+            continue;
+        vouchersSeen.add(event.pubkey);
+        if (verify && !await verifyEvent(event))
+            continue;
+        vouchCount++;
+        const method = getTagValue(event, 'method');
+        const rawVoucherScore = parseInt(getTagValue(event, 'voucher-score') || '50', 10);
+        const voucherScore = isNaN(rawVoucherScore) ? 50 : Math.max(0, Math.min(rawVoucherScore, MAX_TRUST_SCORE));
+        const multiplier = voucherScore / MAX_TRUST_SCORE;
+        if (method === 'in-person') {
+            rawScore += TRUST_WEIGHTS.IN_PERSON_VOUCH * multiplier;
+        }
+        else {
+            rawScore += TRUST_WEIGHTS.ONLINE_VOUCH * multiplier;
+        }
+    }
+    const score = Math.min(Math.round(rawScore), MAX_TRUST_SCORE);
+    const tierLabel = TIER_LABELS[highestTier];
+    let displayLabel;
+    if (!hasAnyCredential && vouchCount === 0) {
+        displayLabel = 'Unverified';
+    }
+    else {
+        displayLabel = `${tierLabel} (Tier ${highestTier})`;
+    }
+    return {
+        pubkey,
+        tier: highestTier,
+        tierLabel,
+        score,
+        isVerified: hasAnyCredential,
+        displayLabel,
+        credentialCount,
+        vouchCount,
+    };
+}
+/**
+ * Get the trust level classification for a badge.
+ */
+export function getTrustLevel(badge) {
+    if (!badge.isVerified && badge.vouchCount === 0)
+        return 'unverified';
+    return TIER_TO_TRUST_LEVEL[badge.tier];
+}
+/**
+ * Check if a pubkey has at least the required tier.
+ * Useful for gating access to features or communities.
+ */
+export function meetsMinimumTier(badge, minTier) {
+    return badge.isVerified && badge.tier >= minTier;
+}
+/**
+ * Filter a set of events to only those relevant for a given pubkey.
+ * Useful when you have a mixed bag of events from a relay query.
+ */
+export function filterEventsForPubkey(pubkey, events) {
+    return events.filter(event => {
+        if (event.kind !== ATTESTATION_KIND)
+            return false;
+        const eventType = getTagValue(event, 'type');
+        if (eventType !== ATTESTATION_TYPES.CREDENTIAL && eventType !== ATTESTATION_TYPES.VOUCH) {
+            return false;
+        }
+        const dTag = getTagValue(event, 'd') || '';
+        // Strip type prefix from d-tag to get subject
+        const subject = dTag.includes(':') ? dTag.slice(dTag.indexOf(':') + 1) : dTag;
+        return subject === pubkey;
+    });
+}
+/**
+ * Build a Nostr filter for fetching badge-relevant events for one or more pubkeys.
+ * Returns filters suitable for use with REQ messages.
+ */
+export function buildBadgeFilters(pubkeys) {
+    // With the generic attestation kind, d-tags are now prefixed with the type
+    const dTags = pubkeys.flatMap(pk => [`credential:${pk}`, `vouch:${pk}`]);
+    return [
+        {
+            kinds: [ATTESTATION_KIND],
+            '#d': dTags,
+        },
+    ];
+}
+//# sourceMappingURL=badge.js.map

package/dist/badge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"badge.js","sourceRoot":"","sources":["../src/badge.ts"],"names":[],"mappings":"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"}