signet-protocol 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,358 @@
+/** Asymmetric cryptographic algorithm for event signing and key agreement.
+ * 'secp256k1' is the current Nostr standard. Additional algorithms
+ * (e.g. post-quantum lattice-based schemes) may be added in future versions. */
+export type CryptoAlgorithm = 'secp256k1' | (string & {});
+/** Verification tier levels */
+export type SignetTier = 1 | 2 | 3 | 4;
+/** How the verification was performed */
+export type VerificationType = 'self' | 'peer' | 'professional';
+/** Scope of verification */
+export type VerificationScope = 'adult' | 'adult+child';
+/** Method of verification */
+export type VerificationMethod = 'self-declaration' | 'in-person' | 'online' | 'in-person-id';
+/** Vouch method */
+export type VouchMethod = 'in-person' | 'online';
+/** Policy enforcement level */
+export type EnforcementLevel = 'client' | 'relay' | 'both';
+/** Challenge reasons */
+export type ChallengeReason = 'anomalous-volume' | 'registry-mismatch' | 'fraudulent-attestation' | 'licence-revoked' | 'other';
+/** Bond action on revocation */
+export type BondAction = 'slashed' | 'returned' | 'held';
+/** Revocation scope */
+export type RevocationScope = 'full' | 'partial';
+export interface UnsignedEvent {
+    kind: number;
+    pubkey: string;
+    created_at: number;
+    tags: string[][];
+    content: string;
+}
+export interface NostrEvent extends UnsignedEvent {
+    id: string;
+    sig: string;
+}
+export interface CredentialParams {
+    subjectPubkey: string;
+    tier: SignetTier;
+    type: VerificationType;
+    scope: VerificationScope;
+    method: VerificationMethod;
+    expiresAt: number;
+    profession?: string;
+    jurisdiction?: string;
+    ageRange?: string;
+    content?: string;
+    entityType?: EntityType;
+    nullifier?: string;
+    merkleRoot?: string;
+    guardianPubkeys?: string[];
+    supersedes?: string;
+    occurredAt?: number;
+    assertionEventId?: string;
+    assertionRelay?: string;
+}
+export interface VouchParams {
+    subjectPubkey: string;
+    method: VouchMethod;
+    context?: string;
+    voucherTier: SignetTier;
+    voucherScore: number;
+    occurredAt?: number;
+}
+export interface PolicyParams {
+    communityId: string;
+    adultMinTier: SignetTier;
+    childMinTier: SignetTier;
+    enforcement: EnforcementLevel;
+    minScore?: number;
+    modMinTier?: SignetTier;
+    verifierBond?: number;
+    revocationThreshold?: number;
+    description?: string;
+}
+export interface PolicyCheckResult {
+    allowed: boolean;
+    reason?: string;
+    requiredTier: SignetTier;
+    actualTier: SignetTier;
+    requiredScore?: number;
+    actualScore?: number;
+}
+/** Bitcoin address type for bond proofs */
+export type BitcoinAddressType = 'p2wpkh' | 'p2sh' | 'p2tr' | 'p2pkh';
+/** A proof-of-reserve bond attestation */
+export interface BondProof {
+    address: string;
+    addressType: BitcoinAddressType;
+    amountSats: number;
+    timestamp: number;
+    message: string;
+    signature: string;
+}
+export type BondStatus = 'valid' | 'stale' | 'invalid' | 'unverified';
+export interface BondVerificationResult {
+    status: BondStatus;
+    signatureValid: boolean | null;
+    fresh: boolean;
+    ageSecs: number;
+    meetsThreshold: boolean | null;
+    errors: string[];
+}
+export type BIP322Verifier = (address: string, message: string, signature: string) => boolean | Promise<boolean>;
+export interface VerifierParams {
+    profession: string;
+    jurisdiction: string;
+    licenceHash: string;
+    professionalBody: string;
+    statement?: string;
+    bondProof?: BondProof;
+}
+export interface ChallengeParams {
+    verifierPubkey: string;
+    reason: ChallengeReason;
+    evidenceType: string;
+    reporterTier: SignetTier;
+    evidence: string;
+    occurredAt?: number;
+}
+export interface RevocationParams {
+    verifierPubkey: string;
+    challengeEventId: string;
+    confirmations: number;
+    bondAction: BondAction;
+    scope: RevocationScope;
+    effectiveAt: number;
+    summary: string;
+}
+export interface TrustSignal {
+    type: 'professional-verification' | 'in-person-vouch' | 'online-vouch' | 'account-age' | 'identity-bridge';
+    weight: number;
+    source?: string;
+    score?: number;
+}
+export interface TrustScoreBreakdown {
+    score: number;
+    tier: SignetTier;
+    professionalVerifications: number;
+    inPersonVouches: number;
+    onlineVouches: number;
+    accountAgeDays: number;
+    signals: TrustSignal[];
+}
+export interface MerkleProof {
+    leaf: string;
+    index: number;
+    siblings: string[];
+    root: string;
+}
+export interface SelectiveDisclosure {
+    revealedAttributes: Record<string, string>;
+    proofs: MerkleProof[];
+    merkleRoot: string;
+}
+export interface ParsedCredential {
+    subjectPubkey: string;
+    tier: SignetTier;
+    type: VerificationType;
+    scope: VerificationScope;
+    method: VerificationMethod;
+    profession?: string;
+    jurisdiction?: string;
+    ageRange?: string;
+    expiresAt?: number;
+    entityType?: EntityType;
+    nullifier?: string;
+    merkleRoot?: string;
+    guardianPubkeys?: string[];
+    supersedes?: string;
+    supersededBy?: string;
+    occurredAt?: number;
+    algorithm: CryptoAlgorithm;
+}
+export interface ParsedVouch {
+    subjectPubkey: string;
+    method: VouchMethod;
+    context?: string;
+    voucherTier: SignetTier;
+    voucherScore: number;
+    algorithm: CryptoAlgorithm;
+}
+export interface ParsedPolicy {
+    communityId: string;
+    adultMinTier: SignetTier;
+    childMinTier: SignetTier;
+    enforcement: EnforcementLevel;
+    minScore?: number;
+    modMinTier?: SignetTier;
+    verifierBond?: number;
+    revocationThreshold?: number;
+    algorithm: CryptoAlgorithm;
+}
+export interface ParsedVerifier {
+    profession: string;
+    jurisdiction: string;
+    licenceHash: string;
+    professionalBody: string;
+    algorithm: CryptoAlgorithm;
+    bondProof?: BondProof;
+}
+export interface ParsedChallenge {
+    verifierPubkey: string;
+    reason: ChallengeReason;
+    evidenceType: string;
+    reporterTier: SignetTier;
+    algorithm: CryptoAlgorithm;
+}
+export interface ParsedRevocation {
+    verifierPubkey: string;
+    challengeEventId: string;
+    confirmations: number;
+    bondAction: BondAction;
+    scope: RevocationScope;
+    effectiveAt: number;
+    algorithm: CryptoAlgorithm;
+}
+/** Entity type classification (§17 of spec) */
+export type EntityType = 'natural_person' | 'persona' | 'personal_agent' | 'unlinked_personal_agent' | 'juridical_person' | 'juridical_persona' | 'organised_agent' | 'unlinked_organised_agent' | 'unlinked_agent';
+/** Developer-friendly entity type labels */
+export type SimpleEntityType = 'person' | 'persona' | 'organisation' | 'agent';
+/** Maps full entity types to simplified labels */
+export declare const ENTITY_DISPLAY_LABELS: Record<EntityType, SimpleEntityType>;
+/** Dynamic mode signaling for teleoperated/autonomous entities (§17.9) */
+export type EntityMode = 'teleoperated' | 'autonomous' | 'assisted';
+export interface ParsedDelegation {
+    agentPubkey: string;
+    entityType: 'personal_agent' | 'unlinked_personal_agent' | 'organised_agent' | 'unlinked_organised_agent';
+    ownerPubkey: string;
+    expiresAt?: number;
+    algorithm: CryptoAlgorithm;
+}
+/** Election scale */
+export type ElectionScale = 'organisational' | 'community' | 'national';
+/** Re-vote policy */
+export type ReVotePolicy = 'allowed' | 'denied';
+/** Kind 30482: Election Definition */
+export interface ElectionParams {
+    electionId: string;
+    title: string;
+    description?: string;
+    options: string[];
+    scale: ElectionScale;
+    eligibleEntityTypes: EntityType[];
+    eligibleMinTier: SignetTier;
+    eligibleCommunity?: string;
+    opens: number;
+    closes: number;
+    reVote: ReVotePolicy;
+    tallyPubkeys: string[];
+    tallyThreshold?: [m: number, n: number];
+    ringSize?: number;
+}
+export interface ParsedElection {
+    electionId: string;
+    title: string;
+    description?: string;
+    options: string[];
+    scale: ElectionScale;
+    eligibleEntityTypes: EntityType[];
+    eligibleMinTier: SignetTier;
+    eligibleCommunity?: string;
+    opens: number;
+    closes: number;
+    reVote: ReVotePolicy;
+    tallyPubkeys: string[];
+    tallyThreshold?: [m: number, n: number];
+    ringSize?: number;
+    authorityPubkey: string;
+    algorithm: CryptoAlgorithm;
+}
+/** Kind 30483: Ballot */
+export interface BallotParams {
+    electionId: string;
+    electionEventId: string;
+    keyImage: string;
+    ringSig: string;
+    encryptedVote: string;
+}
+export interface ParsedBallot {
+    electionId: string;
+    electionEventId: string;
+    keyImage: string;
+    ringSig: string;
+    encryptedVote: string;
+    ephemeralPubkey: string;
+    timestamp: number;
+    algorithm: CryptoAlgorithm;
+}
+/** Kind 30484: Election Result */
+export interface ElectionResultParams {
+    electionId: string;
+    electionEventId: string;
+    results: Array<{
+        option: string;
+        count: number;
+    }>;
+    totalBallots: number;
+    totalEligible: number;
+    totalInvalid?: number;
+    tallyProof?: string;
+}
+export interface ParsedElectionResult {
+    electionId: string;
+    electionEventId: string;
+    results: Array<{
+        option: string;
+        count: number;
+    }>;
+    totalBallots: number;
+    totalEligible: number;
+    totalInvalid: number;
+    tallyProof?: string;
+    tallierPubkey: string;
+    algorithm: CryptoAlgorithm;
+}
+export interface TwoCredentialResult {
+    naturalPerson: NostrEvent;
+    persona: NostrEvent;
+    merkleLeaves: Record<string, string>;
+    merkleProofs: MerkleProof[];
+}
+export interface CredentialChain {
+    current: NostrEvent;
+    history: NostrEvent[];
+}
+export interface GuardianDelegationParams {
+    childPubkey: string;
+    delegatePubkey: string;
+    scope: GuardianDelegationScope;
+    expiresAt?: number;
+    occurredAt?: number;
+}
+export type GuardianDelegationScope = 'full' | 'activity-approval' | 'content-management' | 'contact-approval';
+/** A single institutional verification pubkey */
+export interface InstitutionPubkey {
+    id: string;
+    pubkey: string;
+    label: string;
+    created: string;
+}
+/** .well-known/signet.json response */
+export interface InstitutionKeys {
+    version: number;
+    name: string;
+    pubkeys: InstitutionPubkey[];
+    relay?: string;
+    policy?: {
+        rotation?: string;
+        contact?: string;
+    };
+}
+export interface ParsedIdentityBridge {
+    anonPubkey: string;
+    ringMinTier: SignetTier;
+    ringSize: number;
+    ring: string[];
+    timestamp: number;
+    algorithm: CryptoAlgorithm;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA;;gFAEgF;AAChF,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE1D,+BAA+B;AAC/B,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEvC,yCAAyC;AACzC,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,cAAc,CAAC;AAEhE,4BAA4B;AAC5B,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,aAAa,CAAC;AAExD,6BAA6B;AAC7B,MAAM,MAAM,kBAAkB,GAC1B,kBAAkB,GAClB,WAAW,GACX,QAAQ,GACR,cAAc,CAAC;AAEnB,mBAAmB;AACnB,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEjD,+BAA+B;AAC/B,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3D,wBAAwB;AACxB,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAClB,mBAAmB,GACnB,wBAAwB,GACxB,iBAAiB,GACjB,OAAO,CAAC;AAEZ,gCAAgC;AAChC,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAEzD,uBAAuB;AACvB,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,CAAC;AAIjD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAW,SAAQ,aAAa;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;CACb;AAID,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAID,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,UAAU,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,UAAU,CAAC;IACzB,YAAY,EAAE,UAAU,CAAC;IACzB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,UAAU,CAAC;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID,2CAA2C;AAC3C,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtE,0CAA0C;AAC1C,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,kBAAkB,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,CAAC;AAEtE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,UAAU,CAAC;IACnB,cAAc,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,MAAM,cAAc,GAAG,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,KACd,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAIhC,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAID,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,UAAU,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,eAAe,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,2BAA2B,GAAG,iBAAiB,GAAG,cAAc,GAAG,aAAa,GAAG,iBAAiB,CAAC;IAC3G,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,yBAAyB,EAAE,MAAM,CAAC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAID,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,eAAe,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,UAAU,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,eAAe,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,UAAU,CAAC;IACzB,YAAY,EAAE,UAAU,CAAC;IACzB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,eAAe,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,eAAe,CAAC;IAC3B,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,UAAU,CAAC;IACzB,SAAS,EAAE,eAAe,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,eAAe,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,eAAe,CAAC;CAC5B;AAID,+CAA+C;AAC/C,MAAM,MAAM,UAAU,GAClB,gBAAgB,GAChB,SAAS,GACT,gBAAgB,GAChB,yBAAyB,GACzB,kBAAkB,GAClB,mBAAmB,GACnB,iBAAiB,GACjB,0BAA0B,GAC1B,gBAAgB,CAAC;AAErB,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,cAAc,GAAG,OAAO,CAAC;AAE/E,kDAAkD;AAClD,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,UAAU,EAAE,gBAAgB,CAUtE,CAAC;AAEF,0EAA0E;AAC1E,MAAM,MAAM,UAAU,GAClB,cAAc,GACd,YAAY,GACZ,UAAU,CAAC;AAIf,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,gBAAgB,GAAG,yBAAyB,GAAG,iBAAiB,GAAG,0BAA0B,CAAC;IAC1G,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,eAAe,CAAC;CAC5B;AAID,qBAAqB;AACrB,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,WAAW,GAAG,UAAU,CAAC;AAExE,qBAAqB;AACrB,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEhD,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,aAAa,CAAC;IACrB,mBAAmB,EAAE,UAAU,EAAE,CAAC;IAClC,eAAe,EAAE,UAAU,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,aAAa,CAAC;IACrB,mBAAmB,EAAE,UAAU,EAAE,CAAC;IAClC,eAAe,EAAE,UAAU,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,eAAe,CAAC;CAC5B;AAED,yBAAyB;AACzB,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,eAAe,CAAC;CAC5B;AAED,kCAAkC;AAClC,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,eAAe,CAAC;CAC5B;AAID,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,UAAU,CAAC;IAC1B,OAAO,EAAE,UAAU,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,UAAU,CAAC;IACpB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAID,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,uBAAuB,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,uBAAuB,GAC/B,MAAM,GACN,mBAAmB,GACnB,oBAAoB,GACpB,kBAAkB,CAAC;AAIvB,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,uCAAuC;AACvC,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAID,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,UAAU,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,eAAe,CAAC;CAC5B"}

package/dist/types.js

@@ -0,0 +1,15 @@
+// Signet Protocol Types
+// All TypeScript interfaces for the 11 Nostr event kinds (8 core + 3 voting extension) and supporting structures
+/** Maps full entity types to simplified labels */
+export const ENTITY_DISPLAY_LABELS = {
+    natural_person: 'person',
+    persona: 'persona',
+    juridical_person: 'organisation',
+    juridical_persona: 'organisation',
+    personal_agent: 'agent',
+    organised_agent: 'agent',
+    unlinked_agent: 'agent',
+    unlinked_personal_agent: 'agent',
+    unlinked_organised_agent: 'agent',
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,iHAAiH;AA8SjH,kDAAkD;AAClD,MAAM,CAAC,MAAM,qBAAqB,GAAyC;IACzE,cAAc,EAAE,QAAQ;IACxB,OAAO,EAAE,SAAS;IAClB,gBAAgB,EAAE,cAAc;IAChC,iBAAiB,EAAE,cAAc;IACjC,cAAc,EAAE,OAAO;IACvB,eAAe,EAAE,OAAO;IACxB,cAAc,EAAE,OAAO;IACvB,uBAAuB,EAAE,OAAO;IAChC,wBAAwB,EAAE,OAAO;CAClC,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,11 @@
+/** Zero out a Uint8Array buffer (best-effort secure wipe). */
+export declare function zeroBytes(buf: Uint8Array): void;
+/**
+ * Constant-time comparison of two equal-length Uint8Arrays.
+ * Always compares all bytes; does not short-circuit on content.
+ *
+ * NOTE: The length check IS an early return (not constant-time w.r.t. length),
+ * but all callers compare fixed-size buffers (32-byte scalars), so this is safe.
+ */
+export declare function constantTimeEqual(a: Uint8Array, b: Uint8Array): boolean;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,wBAAgB,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAE/C;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAOvE"}

package/dist/utils.js

@@ -0,0 +1,21 @@
+/** Zero out a Uint8Array buffer (best-effort secure wipe). */
+export function zeroBytes(buf) {
+    buf.fill(0);
+}
+/**
+ * Constant-time comparison of two equal-length Uint8Arrays.
+ * Always compares all bytes; does not short-circuit on content.
+ *
+ * NOTE: The length check IS an early return (not constant-time w.r.t. length),
+ * but all callers compare fixed-size buffers (32-byte scalars), so this is safe.
+ */
+export function constantTimeEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    let diff = 0;
+    for (let i = 0; i < a.length; i++) {
+        diff |= a[i] ^ b[i];
+    }
+    return diff === 0;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,UAAU,SAAS,CAAC,GAAe;IACvC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,CAAa,EAAE,CAAa;IAC5D,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,CAAC;AACpB,CAAC"}

package/dist/validation.d.ts

@@ -0,0 +1,33 @@
+import type { NostrEvent } from './types.js';
+export declare const MAX_CONTENT_LENGTH = 65536;
+export declare const MAX_TAG_VALUE_LENGTH = 1024;
+export declare const MAX_TAGS_COUNT = 100;
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+/** Get a tag value by name from a Nostr event */
+export declare function getTagValue(event: NostrEvent | {
+    tags: string[][];
+}, name: string): string | undefined;
+/** Get all tag values by name */
+export declare function getTagValues(event: NostrEvent | {
+    tags: string[][];
+}, name: string): string[];
+/** Validate field-size bounds on untrusted event data */
+export declare function validateFieldSizeBounds(event: NostrEvent, errors: string[]): void;
+/** Validate a Verification Credential attestation (kind 31000, type: credential) */
+export declare function validateCredential(event: NostrEvent): ValidationResult;
+/** Validate a Vouch Attestation (kind 31000, type: vouch) */
+export declare function validateVouch(event: NostrEvent): ValidationResult;
+/** Validate a Community Policy (kind 30078, NIP-78) */
+export declare function validatePolicy(event: NostrEvent): ValidationResult;
+/** Validate a Verifier Credential attestation (kind 31000, type: verifier) */
+export declare function validateVerifier(event: NostrEvent): ValidationResult;
+/** Validate a Verifier Challenge attestation (kind 31000, type: challenge) */
+export declare function validateChallenge(event: NostrEvent): ValidationResult;
+/** Validate a Verifier Revocation attestation (kind 31000, type: revocation) */
+export declare function validateRevocation(event: NostrEvent): ValidationResult;
+/** Validate any Signet event by kind + type tag */
+export declare function validateEvent(event: NostrEvent): ValidationResult;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AACxC,eAAO,MAAM,oBAAoB,OAAO,CAAC;AACzC,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,iDAAiD;AACjD,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAA;CAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGtG;AAED,iCAAiC;AACjC,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAA;CAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAE7F;AAED,yDAAyD;AACzD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAcjF;AAWD,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB,CAgFtE;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB,CAwCjE;AAED,uDAAuD;AACvD,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB,CA8BlE;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB,CAkEpE;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB,CAoCrE;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB,CA0CtE;AAED,mDAAmD;AACnD,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB,CAwBjE"}