nostr-attestations 1.0.1 → 2.0.0

package/README.md

@@ -1,6 +1,6 @@
 # nostr-attestations
 
-One Nostr event kind for all attestations — credentials, endorsements, vouches, provenance, licensing, and trust.
+One Nostr event kind for all attestations — credentials, endorsements, vouches, provenance, licensing, and trust. Supports both direct attestation and assertion-first patterns within a single kind.
 
 **Nostr:** [`npub1mgvlrnf5hm9yf0n5mf9nqmvarhvxkc6remu5ec3vf8r0txqkuk7su0e7q2`](https://njump.me/npub1mgvlrnf5hm9yf0n5mf9nqmvarhvxkc6remu5ec3vf8r0txqkuk7su0e7q2)
 
@@ -31,12 +31,34 @@ const event = createAttestation({
 
 No relay client, no signing library, no crypto. Bring your own. Works with nostr-tools, any Nostr SDK, or bare WebSocket code.
 
+### Assertion-First Pattern
+
+Attest to someone else's claim — the individual makes an assertion, you verify it:
+
+```typescript
+import { createAttestation } from 'nostr-attestations'
+
+// Attest to a first-person assertion event
+const event = createAttestation({
+  assertion: { id: '<assertion-event-id>', relay: 'wss://relay.example.com' },
+  subject: '<subject-pubkey>',
+  content: 'Identity verified in person',
+})
+// type is inferred from the referenced assertion — no type tag needed
+```
+
 ## Why This?
 
 Nostr has several ways to label or badge identities, but none designed for verifiable attestations. [NIP-58](https://github.com/nostr-protocol/nips/blob/master/58.md) badges are display-only — no expiry, no revocation, no structured claims. [NIP-85](https://github.com/nostr-protocol/nips/blob/master/85.md) covers social graph metrics, not arbitrary claims. [NIP-32](https://github.com/nostr-protocol/nips/blob/master/32.md) labels are lightweight but not individually replaceable per subject.
 
 nostr-attestations uses **one kind (31000) with a `type` tag** instead of inventing a new event kind for every attestation use case. Credentials, endorsements, vouches, licensing, provenance, and revocations all share the same event structure. New attestation types need zero protocol changes — just define a new `type` value.
 
+It supports two attestation patterns within the same kind:
+- **Direct attestation** — the attestor defines the type and makes a claim about a subject
+- **Assertion-first** — the subject makes their own claim, and the attestor references and verifies it
+
+The base layer is **semantically neutral** — it carries attestations but does not interpret them. Application profiles (identity verification, professional licensing, service reputation) are built downstream, not in the library.
+
 ## Revocation
 
 ```typescript
@@ -64,13 +86,20 @@ import { parseAttestation } from 'nostr-attestations'
 const attestation = parseAttestation(event)
 // {
 //   kind: 31000,
-//   type: 'credential',
+//   type: 'credential',          // "assertion" for assertion-only attestations
 //   pubkey: '<attestor-pubkey>',
 //   createdAt: 1700000000,
 //   identifier: '<subject-pubkey>',
 //   subject: '<subject-pubkey>',
+//   assertionId: null,            // event ID if assertion-first
+//   assertionAddress: null,       // addressable coord if assertion-first
+//   assertionRelay: null,         // relay hint for assertion
 //   summary: 'Professional credential verified',
 //   expiration: 1735689600,
+//   validFrom: null,
+//   validTo: null,                // validity window end
+//   request: null,                // what prompted this attestation
+//   schema: null,                 // machine-readable schema URI
 //   revoked: false,
 //   reason: null,
 //   tags: [...],
@@ -105,9 +134,10 @@ const attestation = parseAttestation(event)
 | Function | Signature | Returns |
 |----------|-----------|---------|
 | `attestationFilter` | `(params: FilterParams) => NostrFilter` | Relay query filter |
-| `revocationFilter` | `(type: string, identifier: string) => NostrFilter` | Revocation check filter |
+| `revocationFilter` | `(type, identifier)` or `({ assertionId \| assertionAddress })` | Revocation check filter |
 | `buildDTag` | `(type: string, identifier: string) => string` | `"type:identifier"` string |
-| `parseDTag` | `(dTag: string) => { type: string; identifier: string } \| null` | Parsed d-tag |
+| `buildAssertionDTag` | `(ref: string) => string` | `"assertion:ref"` string |
+| `parseDTag` | `(dTag: string) => { type: string; identifier: string } \| null` | Parsed d-tag (type is `"assertion"` for assertion-only) |
 
 ### Constants
 
@@ -118,11 +148,11 @@ const attestation = parseAttestation(event)
 
 ### Types
 
-`AttestationParams`, `RevocationParams`, `Attestation`, `ValidationResult`, `FilterParams`, `NostrFilter`, `NostrEvent`, `EventTemplate` — all exported from the package root.
+`AssertionRef`, `AttestationParams`, `RevocationParams`, `Attestation`, `ValidationResult`, `FilterParams`, `NostrFilter`, `NostrEvent`, `EventTemplate` — all exported from the package root and from `nostr-attestations/types` (zero-runtime import).
 
 ## Test Vectors
 
-`vectors/attestations.json` contains 10 frozen conformance test vectors covering the full range of attestation types (credential, endorsement, vouch, verifier, provenance) and states (active, revoked, self-attestation). Any conformant implementation must produce identical parse results from these inputs. The vectors are pinned — if tests against them fail, the implementation is broken, not the vector.
+`vectors/attestations.json` contains 16 frozen conformance test vectors covering the full range of attestation types (credential, endorsement, vouch, verifier, provenance) and states (active, revoked, self-attestation). Any conformant implementation must produce identical parse results from these inputs. The vectors are pinned — if tests against them fail, the implementation is broken, not the vector.
 
 ## Attested on Nostr
 

package/dist/builders.d.ts

@@ -2,11 +2,16 @@ import type { AttestationParams, RevocationParams, EventTemplate } from './types
 /**
  * Create an unsigned attestation event template.
  * The caller is responsible for signing (adding pubkey, id, sig, created_at).
+ *
+ * At least one of `type` or `assertion` must be provided.
  */
 export declare function createAttestation(params: AttestationParams): EventTemplate;
 /**
  * Create an unsigned revocation event template.
  * When published, this replaces the original attestation via addressable event semantics.
+ *
+ * For typed attestations: provide `type` + `identifier`.
+ * For assertion-only attestations: provide `assertionId` or `assertionAddress`.
  */
 export declare function createRevocation(params: RevocationParams): EventTemplate;
 //# sourceMappingURL=builders.d.ts.map

package/dist/builders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../src/builders.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAEpF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,aAAa,CA6C1E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,aAAa,CAyBxE"}
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../src/builders.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAEpF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,aAAa,CAyG1E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,aAAa,CA0CxE"}

package/dist/builders.js

@@ -1,27 +1,80 @@
 import { ATTESTATION_KIND } from './constants.js';
-import { buildDTag } from './filters.js';
+import { buildDTag, buildAssertionDTag } from './filters.js';
 /**
  * Create an unsigned attestation event template.
  * The caller is responsible for signing (adding pubkey, id, sig, created_at).
+ *
+ * At least one of `type` or `assertion` must be provided.
  */
 export function createAttestation(params) {
-    if (!params.type)
-        throw new Error('type must not be empty');
-    if (params.type.includes(':'))
-        throw new Error('type must not contain colons');
+    const hasType = !!params.type;
+    const hasAssertion = !!params.assertion;
+    if (!hasType && !hasAssertion) {
+        throw new Error('at least one of type or assertion must be provided');
+    }
+    if (hasType) {
+        if (params.type.includes(':'))
+            throw new Error('type must not contain colons');
+    }
+    if (hasAssertion) {
+        const a = params.assertion;
+        if (a.id && a.address)
+            throw new Error('assertion must have id or address, not both');
+        if (!a.id && !a.address)
+            throw new Error('assertion must have id or address');
+    }
+    if (params.validTo != null) {
+        if (!Number.isFinite(params.validTo))
+            throw new Error('validTo must be a finite number');
+        if (params.validFrom != null && params.validTo <= params.validFrom) {
+            throw new Error('validTo must be greater than validFrom');
+        }
+    }
+    if (params.schema != null && !params.schema.trim()) {
+        throw new Error('schema must not be empty');
+    }
     const tags = [];
-    // d-tag: type:identifier, or type:subject if no identifier, or just type
-    const identifier = params.identifier ?? params.subject;
-    if (identifier) {
-        tags.push(['d', buildDTag(params.type, identifier)]);
+    // d-tag construction
+    if (hasType) {
+        const identifier = params.identifier ?? params.subject;
+        if (identifier) {
+            tags.push(['d', buildDTag(params.type, identifier)]);
+        }
+        else {
+            tags.push(['d', params.type]);
+        }
+        tags.push(['type', params.type]);
     }
     else {
-        tags.push(['d', params.type]);
+        // assertion-only: d-tag uses assertion: prefix
+        const ref = params.assertion.id ?? params.assertion.address;
+        tags.push(['d', buildAssertionDTag(ref)]);
     }
-    tags.push(['type', params.type]);
     if (params.subject) {
         tags.push(['p', params.subject]);
     }
+    // Assertion reference tags
+    if (hasAssertion) {
+        const a = params.assertion;
+        if (a.id) {
+            const eTag = ['e', a.id];
+            if (a.relay)
+                eTag.push(a.relay);
+            else
+                eTag.push('');
+            eTag.push('assertion');
+            tags.push(eTag);
+        }
+        else if (a.address) {
+            const aTag = ['a', a.address];
+            if (a.relay)
+                aTag.push(a.relay);
+            else
+                aTag.push('');
+            aTag.push('assertion');
+            tags.push(aTag);
+        }
+    }
     if (params.summary) {
         tags.push(['summary', params.summary]);
     }
@@ -35,6 +88,15 @@ export function createAttestation(params) {
             throw new Error('validFrom must be a finite number');
         tags.push(['valid_from', String(params.validFrom)]);
     }
+    if (params.validTo != null) {
+        tags.push(['valid_to', String(params.validTo)]);
+    }
+    if (params.request) {
+        tags.push(['request', params.request]);
+    }
+    if (params.schema) {
+        tags.push(['schema', params.schema]);
+    }
     if (params.tags) {
         for (const tag of params.tags) {
             tags.push(tag);
@@ -49,13 +111,29 @@ export function createAttestation(params) {
 /**
  * Create an unsigned revocation event template.
  * When published, this replaces the original attestation via addressable event semantics.
+ *
+ * For typed attestations: provide `type` + `identifier`.
+ * For assertion-only attestations: provide `assertionId` or `assertionAddress`.
  */
 export function createRevocation(params) {
-    const tags = [
-        ['d', buildDTag(params.type, params.identifier)],
-        ['type', params.type],
-        ['status', 'revoked'],
-    ];
+    const hasTyped = !!params.type && params.identifier != null;
+    const hasAssertion = !!params.assertionId || !!params.assertionAddress;
+    if (!hasTyped && !hasAssertion) {
+        throw new Error('provide (type + identifier) or (assertionId | assertionAddress)');
+    }
+    if (params.assertionId && params.assertionAddress) {
+        throw new Error('provide assertionId or assertionAddress, not both');
+    }
+    const tags = [];
+    if (hasTyped) {
+        tags.push(['d', buildDTag(params.type, params.identifier)]);
+        tags.push(['type', params.type]);
+    }
+    else {
+        const ref = (params.assertionId ?? params.assertionAddress);
+        tags.push(['d', buildAssertionDTag(ref)]);
+    }
+    tags.push(['status', 'revoked']);
     if (params.subject) {
         tags.push(['p', params.subject]);
     }

package/dist/builders.js.map

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

package/dist/constants.d.ts

@@ -10,5 +10,7 @@ export declare const TYPES: {
     readonly VOUCH: "vouch";
     readonly VERIFIER: "verifier";
     readonly PROVENANCE: "provenance";
+    /** Synthetic type for assertion-only attestations (no explicit type tag). */
+    readonly ASSERTION: "assertion";
 };
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,eAAO,MAAM,gBAAgB,EAAG,KAAc,CAAA;AAE9C;;;GAGG;AACH,eAAO,MAAM,KAAK;;;;;;CAMR,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,eAAO,MAAM,gBAAgB,EAAG,KAAc,CAAA;AAE9C;;;GAGG;AACH,eAAO,MAAM,KAAK;;;;;;IAMhB,6EAA6E;;CAErE,CAAA"}

package/dist/constants.js

@@ -10,5 +10,7 @@ export const TYPES = {
     VOUCH: 'vouch',
     VERIFIER: 'verifier',
     PROVENANCE: 'provenance',
+    /** Synthetic type for assertion-only attestations (no explicit type tag). */
+    ASSERTION: 'assertion',
 };
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAc,CAAA;AAE9C;;;GAGG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,YAAY;CAChB,CAAA"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAc,CAAA;AAE9C;;;GAGG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,YAAY;IACxB,6EAA6E;IAC7E,SAAS,EAAE,WAAW;CACd,CAAA"}

package/dist/filters.d.ts

@@ -4,9 +4,15 @@ import type { FilterParams, NostrFilter } from './types.js';
  * Type values must not contain colons — the first colon is the delimiter.
  */
 export declare function buildDTag(type: string, identifier: string): string;
+/**
+ * Build a d-tag for an assertion-only attestation.
+ * Uses the `assertion:` prefix followed by the assertion reference.
+ */
+export declare function buildAssertionDTag(ref: string): string;
 /**
  * Parse a d-tag into type and identifier.
  * Returns null if the d-tag does not contain a colon.
+ * For assertion-only attestations (prefix `assertion:`), returns type as null.
  */
 export declare function parseDTag(dTag: string): {
     type: string;
@@ -16,4 +22,9 @@ export declare function parseDTag(dTag: string): {
 export declare function attestationFilter(params: FilterParams): NostrFilter;
 /** Build a Nostr relay filter for fetching the latest version of a specific attestation (for revocation checking). */
 export declare function revocationFilter(type: string, identifier: string): NostrFilter;
+/** Build a Nostr relay filter for an assertion-only attestation by its reference. */
+export declare function revocationFilter(options: {
+    assertionId?: string;
+    assertionAddress?: string;
+}): NostrFilter;
 //# sourceMappingURL=filters.d.ts.map

package/dist/filters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../src/filters.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE3D;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAIlE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAOnF;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW,CAMnE;AAED,sHAAsH;AACtH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAK9E"}
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../src/filters.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAK3D;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAIlE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAMnF;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW,CAOnE;AAED,sHAAsH;AACtH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAAA;AAC/E,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,CAAA"}

package/dist/filters.js

@@ -1,4 +1,6 @@
 import { ATTESTATION_KIND } from './constants.js';
+/** Assertion d-tag prefix for assertion-only attestations. */
+const ASSERTION_PREFIX = 'assertion';
 /**
  * Build a d-tag from type and identifier.
  * Type values must not contain colons — the first colon is the delimiter.
@@ -10,18 +12,27 @@ export function buildDTag(type, identifier) {
         throw new Error('type must not contain colons');
     return `${type}:${identifier}`;
 }
+/**
+ * Build a d-tag for an assertion-only attestation.
+ * Uses the `assertion:` prefix followed by the assertion reference.
+ */
+export function buildAssertionDTag(ref) {
+    if (!ref)
+        throw new Error('assertion reference must not be empty');
+    return `${ASSERTION_PREFIX}:${ref}`;
+}
 /**
  * Parse a d-tag into type and identifier.
  * Returns null if the d-tag does not contain a colon.
+ * For assertion-only attestations (prefix `assertion:`), returns type as null.
  */
 export function parseDTag(dTag) {
     const idx = dTag.indexOf(':');
     if (idx <= 0)
         return null;
-    return {
-        type: dTag.slice(0, idx),
-        identifier: dTag.slice(idx + 1),
-    };
+    const prefix = dTag.slice(0, idx);
+    const rest = dTag.slice(idx + 1);
+    return { type: prefix, identifier: rest };
 }
 /** Build a Nostr relay filter for querying attestation events. */
 export function attestationFilter(params) {
@@ -32,13 +43,23 @@ export function attestationFilter(params) {
         filter['#p'] = [params.subject];
     if (params.type)
         filter['#type'] = [params.type];
+    if (params.schema)
+        filter['#schema'] = [params.schema];
     return filter;
 }
-/** Build a Nostr relay filter for fetching the latest version of a specific attestation (for revocation checking). */
-export function revocationFilter(type, identifier) {
+export function revocationFilter(typeOrOptions, identifier) {
+    if (typeof typeOrOptions === 'string') {
+        return {
+            kinds: [ATTESTATION_KIND],
+            '#d': [buildDTag(typeOrOptions, identifier)],
+        };
+    }
+    const ref = typeOrOptions.assertionId ?? typeOrOptions.assertionAddress;
+    if (!ref)
+        throw new Error('assertionId or assertionAddress required');
     return {
         kinds: [ATTESTATION_KIND],
-        '#d': [buildDTag(type, identifier)],
+        '#d': [buildAssertionDTag(ref)],
     };
 }
 //# sourceMappingURL=filters.js.map

package/dist/filters.js.map

@@ -1 +1 @@
-{"version":3,"file":"filters.js","sourceRoot":"","sources":["../src/filters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAGjD;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,UAAkB;IACxD,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;IACpD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAA;IACvE,OAAO,GAAG,IAAI,IAAI,UAAU,EAAE,CAAA;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAC7B,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IACzB,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;QACxB,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;KAChC,CAAA;AACH,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,iBAAiB,CAAC,MAAoB;IACpD,MAAM,MAAM,GAAgB,EAAE,KAAK,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAA;IACzD,IAAI,MAAM,CAAC,OAAO,EAAE,MAAM;QAAE,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAA;IAC3D,IAAI,MAAM,CAAC,OAAO;QAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACnD,IAAI,MAAM,CAAC,IAAI;QAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAChD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,sHAAsH;AACtH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,UAAkB;IAC/D,OAAO;QACL,KAAK,EAAE,CAAC,gBAAgB,CAAC;QACzB,IAAI,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;KACpC,CAAA;AACH,CAAC"}
+{"version":3,"file":"filters.js","sourceRoot":"","sources":["../src/filters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAGjD,8DAA8D;AAC9D,MAAM,gBAAgB,GAAG,WAAW,CAAA;AAEpC;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,UAAkB;IACxD,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;IACpD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAA;IACvE,OAAO,GAAG,IAAI,IAAI,UAAU,EAAE,CAAA;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;IAClE,OAAO,GAAG,gBAAgB,IAAI,GAAG,EAAE,CAAA;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAC7B,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IACzB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAA;IAChC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAAA;AAC3C,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,iBAAiB,CAAC,MAAoB;IACpD,MAAM,MAAM,GAAgB,EAAE,KAAK,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAA;IACzD,IAAI,MAAM,CAAC,OAAO,EAAE,MAAM;QAAE,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAA;IAC3D,IAAI,MAAM,CAAC,OAAO;QAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACnD,IAAI,MAAM,CAAC,IAAI;QAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAChD,IAAI,MAAM,CAAC,MAAM;QAAE,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACtD,OAAO,MAAM,CAAA;AACf,CAAC;AAMD,MAAM,UAAU,gBAAgB,CAC9B,aAA2E,EAC3E,UAAmB;IAEnB,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO;YACL,KAAK,EAAE,CAAC,gBAAgB,CAAC;YACzB,IAAI,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,UAAW,CAAC,CAAC;SAC9C,CAAA;IACH,CAAC;IACD,MAAM,GAAG,GAAG,aAAa,CAAC,WAAW,IAAI,aAAa,CAAC,gBAAgB,CAAA;IACvE,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;IACrE,OAAO;QACL,KAAK,EAAE,CAAC,gBAAgB,CAAC;QACzB,IAAI,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;KAChC,CAAA;AACH,CAAC"}

package/dist/index.d.ts

@@ -2,6 +2,6 @@ export { ATTESTATION_KIND, TYPES } from './constants.js';
 export { createAttestation, createRevocation } from './builders.js';
 export { parseAttestation, isRevoked } from './parsers.js';
 export { validateAttestation } from './validators.js';
-export { buildDTag, parseDTag, attestationFilter, revocationFilter } from './filters.js';
-export type { AttestationParams, RevocationParams, Attestation, ValidationResult, FilterParams, NostrFilter, NostrEvent, EventTemplate, } from './types.js';
+export { buildDTag, buildAssertionDTag, parseDTag, attestationFilter, revocationFilter } from './filters.js';
+export type { AssertionRef, AttestationParams, RevocationParams, Attestation, ValidationResult, FilterParams, NostrFilter, NostrEvent, EventTemplate, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAExD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAEnE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAErD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAExF,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,UAAU,EACV,aAAa,GACd,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAExD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAEnE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAErD,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE5G,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,UAAU,EACV,aAAa,GACd,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -2,5 +2,5 @@ export { ATTESTATION_KIND, TYPES } from './constants.js';
 export { createAttestation, createRevocation } from './builders.js';
 export { parseAttestation, isRevoked } from './parsers.js';
 export { validateAttestation } from './validators.js';
-export { buildDTag, parseDTag, attestationFilter, revocationFilter } from './filters.js';
+export { buildDTag, buildAssertionDTag, parseDTag, attestationFilter, revocationFilter } from './filters.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAExD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAEnE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAErD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAExD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAEnE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAErD,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA"}

package/dist/parsers.d.ts

@@ -2,6 +2,8 @@ import type { NostrEvent, Attestation } from './types.js';
 /**
  * Parse a NostrEvent into a typed Attestation.
  * Returns null if the event is not a valid kind 31000 attestation.
+ *
+ * An attestation must have either a type tag or an assertion reference.
  */
 export declare function parseAttestation(event: NostrEvent): Attestation | null;
 /**

package/dist/parsers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parsers.d.ts","sourceRoot":"","sources":["../src/parsers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAEzD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI,CA2BtE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAGpD"}
+{"version":3,"file":"parsers.d.ts","sourceRoot":"","sources":["../src/parsers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAUzD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI,CAqCtE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAGpD"}

package/dist/parsers.js

@@ -1,30 +1,48 @@
-import { ATTESTATION_KIND } from './constants.js';
+import { ATTESTATION_KIND, TYPES } from './constants.js';
 import { findTag } from './helpers.js';
 import { parseDTag } from './filters.js';
+/**
+ * Find an e or a tag with the "assertion" marker (fourth element).
+ * Returns the tag array or null.
+ */
+function findAssertionTag(tags) {
+    return tags.find(t => (t[0] === 'e' || t[0] === 'a') && t[3] === 'assertion') ?? null;
+}
 /**
  * Parse a NostrEvent into a typed Attestation.
  * Returns null if the event is not a valid kind 31000 attestation.
+ *
+ * An attestation must have either a type tag or an assertion reference.
  */
 export function parseAttestation(event) {
     if (event.kind !== ATTESTATION_KIND)
         return null;
     const type = findTag(event.tags, 'type');
-    if (!type)
+    const assertionTag = findAssertionTag(event.tags);
+    // Must have type or assertion reference
+    if (!type && !assertionTag)
         return null;
     const dTag = findTag(event.tags, 'd');
     const parsed = dTag ? parseDTag(dTag) : null;
     const expirationStr = findTag(event.tags, 'expiration');
     const validFromStr = findTag(event.tags, 'valid_from');
+    const validToStr = findTag(event.tags, 'valid_to');
     return {
         kind: ATTESTATION_KIND,
-        type,
+        type: type ?? TYPES.ASSERTION,
         pubkey: event.pubkey,
         createdAt: event.created_at,
         identifier: parsed?.identifier ?? null,
         subject: findTag(event.tags, 'p'),
+        assertionId: assertionTag !== null && assertionTag[0] === 'e' ? (assertionTag[1] ?? null) : null,
+        assertionAddress: assertionTag !== null && assertionTag[0] === 'a' ? (assertionTag[1] ?? null) : null,
+        assertionRelay: (assertionTag !== null && assertionTag[2]) ? assertionTag[2] : null,
         summary: findTag(event.tags, 'summary'),
         expiration: expirationStr ? Number(expirationStr) : null,
         validFrom: validFromStr ? Number(validFromStr) : null,
+        validTo: validToStr ? Number(validToStr) : null,
+        request: findTag(event.tags, 'request'),
+        schema: findTag(event.tags, 'schema'),
         revoked: findTag(event.tags, 'status') === 'revoked',
         reason: findTag(event.tags, 'reason'),
         tags: event.tags,

package/dist/parsers.js.map

@@ -1 +1 @@
-{"version":3,"file":"parsers.js","sourceRoot":"","sources":["../src/parsers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAGxC;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAiB;IAChD,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB;QAAE,OAAO,IAAI,CAAA;IAEhD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACxC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IAEtB,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAE5C,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;IACvD,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;IAEtD,OAAO;QACL,IAAI,EAAE,gBAAyB;QAC/B,IAAI;QACJ,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,UAAU;QAC3B,UAAU,EAAE,MAAM,EAAE,UAAU,IAAI,IAAI;QACtC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC;QACjC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC;QACvC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI;QACxD,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI;QACrD,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,SAAS;QACpD,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC;QACrC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAiB;IACzC,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB;QAAE,OAAO,KAAK,CAAA;IACjD,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,SAAS,CAAA;AACpD,CAAC"}
+{"version":3,"file":"parsers.js","sourceRoot":"","sources":["../src/parsers.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -15,20 +15,37 @@ export interface NostrEvent {
     id: string;
     sig: string;
 }
+/** Reference to a first-person assertion event being attested. */
+export interface AssertionRef {
+    /** Event ID of the assertion (produces an e-tag with "assertion" marker). */
+    id?: string;
+    /** Addressable event coordinate kind:pubkey:d-tag (produces an a-tag). */
+    address?: string;
+    /** Relay hint for fetching the referenced event. */
+    relay?: string;
+}
 /** Parameters for creating an attestation event. */
 export interface AttestationParams {
-    /** Application-defined attestation type (must not contain colons). */
-    type: string;
+    /** Application-defined attestation type (must not contain colons). Optional when assertion is provided. */
+    type?: string;
     /** D-tag second segment: hex pubkey or context string. */
     identifier?: string;
     /** P-tag: hex pubkey of the subject (for third-party attestations). */
     subject?: string;
+    /** Reference to a first-person assertion event being confirmed. */
+    assertion?: AssertionRef;
     /** Human-readable fallback for clients that do not understand the type. */
     summary?: string;
     /** Unix timestamp for attestation expiry (NIP-40). */
     expiration?: number;
     /** Unix timestamp for deferred activation (valid_from). */
     validFrom?: number;
+    /** Unix timestamp for validity window end (valid_to). */
+    validTo?: number;
+    /** Reference to the event that prompted this attestation (opaque string, conventionally an addressable coordinate). */
+    request?: string;
+    /** Machine-readable schema URI for regulatory mapping or application-profile identification. */
+    schema?: string;
     /** Additional application-specific tags. */
     tags?: string[][];
     /** Event content: empty string, human-readable text, or JSON. */
@@ -36,12 +53,16 @@ export interface AttestationParams {
 }
 /** Parameters for creating a revocation event. */
 export interface RevocationParams {
-    /** Type of the attestation being revoked. */
-    type: string;
-    /** D-tag second segment — must match the original attestation. */
-    identifier: string;
+    /** Type of the attestation being revoked. Required for typed attestations. */
+    type?: string;
+    /** D-tag second segment — must match the original attestation. Required for typed attestations. */
+    identifier?: string;
     /** P-tag — include if the original attestation had one. */
     subject?: string;
+    /** Event ID of the referenced assertion (for revoking assertion-only attestations). */
+    assertionId?: string;
+    /** Addressable coordinate of the referenced assertion (for revoking assertion-only attestations). */
+    assertionAddress?: string;
     /** Human-readable revocation reason. */
     reason?: string;
     /** Unix timestamp for when the revocation takes effect. */
@@ -50,6 +71,7 @@ export interface RevocationParams {
 /** Parsed attestation data extracted from a NostrEvent. */
 export interface Attestation {
     kind: 31000;
+    /** Attestation type. Value is "assertion" when the type is defined by a referenced assertion event. */
     type: string;
     /** Attestor's pubkey (from outer event). */
     pubkey: string;
@@ -59,10 +81,22 @@ export interface Attestation {
     identifier: string | null;
     /** P-tag value (hex pubkey of subject, if present). */
     subject: string | null;
+    /** Referenced assertion event ID (from e-tag with "assertion" marker). */
+    assertionId: string | null;
+    /** Referenced assertion address (from a-tag with "assertion" marker). */
+    assertionAddress: string | null;
+    /** Relay hint from the assertion reference tag. */
+    assertionRelay: string | null;
     summary: string | null;
     expiration: number | null;
     /** Earliest time the attestation is valid (deferred activation). */
     validFrom: number | null;
+    /** Latest time the attestation is valid (validity window end). */
+    validTo: number | null;
+    /** Reference to the event that prompted this attestation. */
+    request: string | null;
+    /** Machine-readable schema URI. */
+    schema: string | null;
     revoked: boolean;
     reason: string | null;
     /** All tags from the original event (for application-specific access). */
@@ -82,6 +116,8 @@ export interface FilterParams {
     subject?: string;
     /** Filter by attestor pubkeys. */
     authors?: string[];
+    /** Filter by schema URI. */
+    schema?: string;
 }
 /** Nostr relay filter object. */
 export interface NostrFilter {
@@ -90,5 +126,6 @@ export interface NostrFilter {
     '#p'?: string[];
     '#d'?: string[];
     '#type'?: string[];
+    '#schema'?: string[];
 }
 //# sourceMappingURL=types.d.ts.map