@claw-network/protocol 0.1.0

package/dist/dao/types.js

@@ -0,0 +1,95 @@
+/**
+ * DAO Governance Module — Domain Types
+ *
+ * Implements token-weighted voting with sqrt, reputation multiplier,
+ * lockup multiplier, and delegation as specified in docs/DAO.md.
+ */
+// ---------------------------------------------------------------------------
+// Proposal Types
+// ---------------------------------------------------------------------------
+export const PROPOSAL_TYPES = [
+    'parameter_change',
+    'treasury_spend',
+    'protocol_upgrade',
+    'emergency',
+    'signal',
+];
+export function isProposalType(value) {
+    return PROPOSAL_TYPES.includes(value);
+}
+// ---------------------------------------------------------------------------
+// Proposal Status
+// ---------------------------------------------------------------------------
+export const PROPOSAL_STATUSES = [
+    'draft',
+    'discussion',
+    'voting',
+    'passed',
+    'rejected',
+    'queued',
+    'executed',
+    'expired',
+    'vetoed',
+];
+export function isProposalStatus(value) {
+    return PROPOSAL_STATUSES.includes(value);
+}
+// ---------------------------------------------------------------------------
+// Vote
+// ---------------------------------------------------------------------------
+export const VOTE_OPTIONS = ['for', 'against', 'abstain'];
+export function isVoteOption(value) {
+    return VOTE_OPTIONS.includes(value);
+}
+const DAY_MS = 24 * 60 * 60 * 1000;
+export const PROPOSAL_THRESHOLDS = {
+    parameter_change: {
+        createThreshold: 0.001,
+        passThreshold: 0.5,
+        quorum: 0.04,
+        discussionPeriod: 2 * DAY_MS,
+        votingPeriod: 3 * DAY_MS,
+        timelockDelay: 1 * DAY_MS,
+    },
+    treasury_spend: {
+        createThreshold: 0.005,
+        passThreshold: 0.5,
+        quorum: 0.04,
+        discussionPeriod: 2 * DAY_MS,
+        votingPeriod: 3 * DAY_MS,
+        timelockDelay: 1 * DAY_MS,
+    },
+    protocol_upgrade: {
+        createThreshold: 0.02,
+        passThreshold: 0.66,
+        quorum: 0.15,
+        discussionPeriod: 7 * DAY_MS,
+        votingPeriod: 7 * DAY_MS,
+        timelockDelay: 14 * DAY_MS,
+    },
+    emergency: {
+        createThreshold: 0,
+        passThreshold: 0,
+        quorum: 0,
+        discussionPeriod: 0,
+        votingPeriod: 0,
+        timelockDelay: 0,
+    },
+    signal: {
+        createThreshold: 0.0001,
+        passThreshold: 0,
+        quorum: 0.01,
+        discussionPeriod: 1 * DAY_MS,
+        votingPeriod: 3 * DAY_MS,
+        timelockDelay: 0,
+    },
+};
+export const DEFAULT_GOVERNANCE_PARAMS = {
+    proposalThreshold: 0.001,
+    quorum: 0.04,
+    votingDelay: 2 * DAY_MS,
+    votingPeriod: 3 * DAY_MS,
+    timelockDelay: 1 * DAY_MS,
+    passThreshold: 0.5,
+};
+//# sourceMappingURL=types.js.map

package/dist/dao/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/dao/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,kBAAkB;IAClB,gBAAgB;IAChB,kBAAkB;IAClB,WAAW;IACX,QAAQ;CACA,CAAC;AAIX,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAQ,cAAoC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO;IACP,YAAY;IACZ,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,UAAU;IACV,SAAS;IACT,QAAQ;CACA,CAAC;AAIX,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAQ,iBAAuC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AA8CD,8EAA8E;AAC9E,OAAO;AACP,8EAA8E;AAE9E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AAInE,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAQ,YAAkC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC;AAmID,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEnC,MAAM,CAAC,MAAM,mBAAmB,GAA4C;IAC1E,gBAAgB,EAAE;QAChB,eAAe,EAAE,KAAK;QACtB,aAAa,EAAE,GAAG;QAClB,MAAM,EAAE,IAAI;QACZ,gBAAgB,EAAE,CAAC,GAAG,MAAM;QAC5B,YAAY,EAAE,CAAC,GAAG,MAAM;QACxB,aAAa,EAAE,CAAC,GAAG,MAAM;KAC1B;IACD,cAAc,EAAE;QACd,eAAe,EAAE,KAAK;QACtB,aAAa,EAAE,GAAG;QAClB,MAAM,EAAE,IAAI;QACZ,gBAAgB,EAAE,CAAC,GAAG,MAAM;QAC5B,YAAY,EAAE,CAAC,GAAG,MAAM;QACxB,aAAa,EAAE,CAAC,GAAG,MAAM;KAC1B;IACD,gBAAgB,EAAE;QAChB,eAAe,EAAE,IAAI;QACrB,aAAa,EAAE,IAAI;QACnB,MAAM,EAAE,IAAI;QACZ,gBAAgB,EAAE,CAAC,GAAG,MAAM;QAC5B,YAAY,EAAE,CAAC,GAAG,MAAM;QACxB,aAAa,EAAE,EAAE,GAAG,MAAM;KAC3B;IACD,SAAS,EAAE;QACT,eAAe,EAAE,CAAC;QAClB,aAAa,EAAE,CAAC;QAChB,MAAM,EAAE,CAAC;QACT,gBAAgB,EAAE,CAAC;QACnB,YAAY,EAAE,CAAC;QACf,aAAa,EAAE,CAAC;KACjB;IACD,MAAM,EAAE;QACN,eAAe,EAAE,MAAM;QACvB,aAAa,EAAE,CAAC;QAChB,MAAM,EAAE,IAAI;QACZ,gBAAgB,EAAE,CAAC,GAAG,MAAM;QAC5B,YAAY,EAAE,CAAC,GAAG,MAAM;QACxB,aAAa,EAAE,CAAC;KACjB;CACF,CAAC;AAeF,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD,iBAAiB,EAAE,KAAK;IACxB,MAAM,EAAE,IAAI;IACZ,WAAW,EAAE,CAAC,GAAG,MAAM;IACvB,YAAY,EAAE,CAAC,GAAG,MAAM;IACxB,aAAa,EAAE,CAAC,GAAG,MAAM;IACzB,aAAa,EAAE,GAAG;CACnB,CAAC"}

package/dist/dao/voting.d.ts

@@ -0,0 +1,56 @@
+/**
+ * DAO Governance — Voting Power Calculation
+ *
+ * Formula: totalPower = (sqrt(tokens) + sqrt(lockedTokens) * (lockupMult-1)) * reputationMult + delegatedPower
+ *
+ * - Token power uses square root to reduce whale dominance
+ * - Reputation multiplier: 1.0 to 2.0 based on score (0..1000)
+ * - Lockup multiplier: 1.0 to 3.0 based on lock duration (0..4 years)
+ * - Delegation: delegated power is added directly
+ */
+import type { VotingPower, Delegation, ProposalType } from './types.js';
+/**
+ * Calculate the square-root-based token power.
+ * Uses integer tokens (bigint string) and returns a floating-point number.
+ */
+export declare function tokenVotingPower(tokenBalance: string): number;
+/**
+ * Reputation multiplier: linearly scales from 1.0 (score 0) to 2.0 (score 1000).
+ */
+export declare function reputationMultiplier(reputationScore: number): number;
+/**
+ * Lockup multiplier: linearly scales from 1.0 (no lockup) to 3.0 (4 years).
+ * @param lockupDurationMs lockup duration in milliseconds
+ */
+export declare function lockupMultiplier(lockupDurationMs: number): number;
+/**
+ * Calculate full voting power for an agent.
+ */
+export declare function calculateVotingPower(opts: {
+    tokenBalance: string;
+    lockedTokens: string;
+    lockupDurationMs: number;
+    reputationScore: number;
+    delegatedPower: number;
+}): VotingPower;
+/**
+ * Whether a delegation matches a given proposal type.
+ */
+export declare function delegationMatchesScope(delegation: Delegation, proposalType: ProposalType): boolean;
+/**
+ * Calculate effective voting power considering delegations.
+ */
+export declare function calculateEffectiveVotingPower(opts: {
+    ownPower: number;
+    outgoingDelegations: Delegation[];
+    incomingDelegations: Array<{
+        delegation: Delegation;
+        delegatorPower: number;
+    }>;
+    proposalType: ProposalType;
+}): number;
+/**
+ * Detect circular delegation: A→B→A.
+ */
+export declare function hasCircularDelegation(delegator: string, delegate: string, delegations: Delegation[]): boolean;
+//# sourceMappingURL=voting.d.ts.map

package/dist/dao/voting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voting.d.ts","sourceRoot":"","sources":["../../src/dao/voting.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAoBxE;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAI7D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAOpE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAOjE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,WAAW,CAiBd;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,YAAY,GACzB,OAAO,CAQT;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,UAAU,EAAE,CAAC;IAClC,mBAAmB,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,UAAU,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/E,YAAY,EAAE,YAAY,CAAC;CAC5B,GAAG,MAAM,CAgBT;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,UAAU,EAAE,GACxB,OAAO,CAcT"}

package/dist/dao/voting.js

@@ -0,0 +1,129 @@
+/**
+ * DAO Governance — Voting Power Calculation
+ *
+ * Formula: totalPower = (sqrt(tokens) + sqrt(lockedTokens) * (lockupMult-1)) * reputationMult + delegatedPower
+ *
+ * - Token power uses square root to reduce whale dominance
+ * - Reputation multiplier: 1.0 to 2.0 based on score (0..1000)
+ * - Lockup multiplier: 1.0 to 3.0 based on lock duration (0..4 years)
+ * - Delegation: delegated power is added directly
+ */
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const MAX_REPUTATION_SCORE = 1000;
+const MAX_REPUTATION_MULTIPLIER = 2.0;
+const MIN_REPUTATION_MULTIPLIER = 1.0;
+const MAX_LOCKUP_YEARS = 4;
+const MAX_LOCKUP_MULTIPLIER = 3.0;
+const MIN_LOCKUP_MULTIPLIER = 1.0;
+const YEAR_MS = 365.25 * 24 * 60 * 60 * 1000;
+// ---------------------------------------------------------------------------
+// Voting Power Calculation
+// ---------------------------------------------------------------------------
+/**
+ * Calculate the square-root-based token power.
+ * Uses integer tokens (bigint string) and returns a floating-point number.
+ */
+export function tokenVotingPower(tokenBalance) {
+    const tokens = Number(BigInt(tokenBalance));
+    if (tokens <= 0)
+        return 0;
+    return Math.sqrt(tokens);
+}
+/**
+ * Reputation multiplier: linearly scales from 1.0 (score 0) to 2.0 (score 1000).
+ */
+export function reputationMultiplier(reputationScore) {
+    const clamped = Math.max(0, Math.min(MAX_REPUTATION_SCORE, reputationScore));
+    return (MIN_REPUTATION_MULTIPLIER +
+        (MAX_REPUTATION_MULTIPLIER - MIN_REPUTATION_MULTIPLIER) *
+            (clamped / MAX_REPUTATION_SCORE));
+}
+/**
+ * Lockup multiplier: linearly scales from 1.0 (no lockup) to 3.0 (4 years).
+ * @param lockupDurationMs lockup duration in milliseconds
+ */
+export function lockupMultiplier(lockupDurationMs) {
+    if (lockupDurationMs <= 0)
+        return MIN_LOCKUP_MULTIPLIER;
+    const years = Math.min(lockupDurationMs / YEAR_MS, MAX_LOCKUP_YEARS);
+    return (MIN_LOCKUP_MULTIPLIER +
+        (MAX_LOCKUP_MULTIPLIER - MIN_LOCKUP_MULTIPLIER) * (years / MAX_LOCKUP_YEARS));
+}
+/**
+ * Calculate full voting power for an agent.
+ */
+export function calculateVotingPower(opts) {
+    const tokenPwr = tokenVotingPower(opts.tokenBalance);
+    const lockedPwr = tokenVotingPower(opts.lockedTokens);
+    const lockMul = lockupMultiplier(opts.lockupDurationMs);
+    const repMul = reputationMultiplier(opts.reputationScore);
+    // (sqrt(tokens) + sqrt(lockedTokens) * (lockupMult - 1)) * reputationMult + delegated
+    const basePower = (tokenPwr + lockedPwr * (lockMul - 1)) * repMul;
+    const totalPower = basePower + opts.delegatedPower;
+    return {
+        tokenPower: tokenPwr,
+        lockupMultiplier: lockMul,
+        reputationMultiplier: repMul,
+        delegatedPower: opts.delegatedPower,
+        totalPower,
+    };
+}
+// ---------------------------------------------------------------------------
+// Delegation Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Whether a delegation matches a given proposal type.
+ */
+export function delegationMatchesScope(delegation, proposalType) {
+    if (delegation.revokedAt !== undefined)
+        return false;
+    if (delegation.expiresAt !== undefined && Date.now() > delegation.expiresAt)
+        return false;
+    const scope = delegation.scope;
+    if (scope.all)
+        return true;
+    if (scope.proposalTypes && scope.proposalTypes.includes(proposalType))
+        return true;
+    // topics are not matched against proposal type directly
+    return false;
+}
+/**
+ * Calculate effective voting power considering delegations.
+ */
+export function calculateEffectiveVotingPower(opts) {
+    let delegatedOut = 0;
+    for (const d of opts.outgoingDelegations) {
+        if (delegationMatchesScope(d, opts.proposalType)) {
+            delegatedOut += (opts.ownPower * d.percentage) / 100;
+        }
+    }
+    let delegatedIn = 0;
+    for (const { delegation, delegatorPower } of opts.incomingDelegations) {
+        if (delegationMatchesScope(delegation, opts.proposalType)) {
+            delegatedIn += (delegatorPower * delegation.percentage) / 100;
+        }
+    }
+    return opts.ownPower - delegatedOut + delegatedIn;
+}
+/**
+ * Detect circular delegation: A→B→A.
+ */
+export function hasCircularDelegation(delegator, delegate, delegations) {
+    const visited = new Set();
+    let current = delegate;
+    while (current) {
+        if (current === delegator)
+            return true;
+        if (visited.has(current))
+            return false;
+        visited.add(current);
+        const next = delegations.find((d) => d.delegator === current && !d.revokedAt);
+        if (!next)
+            return false;
+        current = next.delegate;
+    }
+    return false;
+}
+//# sourceMappingURL=voting.js.map

package/dist/dao/voting.js.map

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

package/dist/identity/document.d.ts

@@ -0,0 +1,35 @@
+export interface VerificationMethod {
+    id: string;
+    type: 'Ed25519VerificationKey2020';
+    controller: string;
+    publicKeyMultibase: string;
+}
+export interface ServiceEndpoint {
+    id: string;
+    type: string;
+    serviceEndpoint: string;
+}
+export interface ClawDIDDocument {
+    id: string;
+    verificationMethod: VerificationMethod[];
+    authentication: string[];
+    assertionMethod: string[];
+    keyAgreement: string[];
+    service: ServiceEndpoint[];
+    alsoKnownAs: string[];
+}
+export interface CreateDIDDocumentOptions {
+    id?: string;
+    publicKey: Uint8Array;
+    alsoKnownAs?: string[];
+    service?: ServiceEndpoint[];
+}
+export declare function createDIDDocument(options: CreateDIDDocumentOptions): ClawDIDDocument;
+export declare function getPrimaryPublicKey(document: ClawDIDDocument): Uint8Array | null;
+export declare function validateDIDDocument(document: ClawDIDDocument): {
+    valid: boolean;
+    errors: string[];
+};
+export declare function didFromDocument(document: ClawDIDDocument): string;
+export declare function publicKeyFromDocument(document: ClawDIDDocument): Uint8Array;
+//# sourceMappingURL=document.d.ts.map

package/dist/identity/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/identity/document.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,4BAA4B,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB,EAAE,kBAAkB,EAAE,CAAC;IACzC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,UAAU,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,eAAe,CAmBpF;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,GAAG,IAAI,CAchF;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,eAAe,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAmCnG;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAEjE;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,CAK3E"}

package/dist/identity/document.js

@@ -0,0 +1,84 @@
+import { didFromPublicKey, publicKeyFromDid } from '@claw-network/core/identity';
+import { multibaseDecode, multibaseEncode } from '@claw-network/core/encoding';
+export function createDIDDocument(options) {
+    const did = options.id ?? didFromPublicKey(options.publicKey);
+    const keyId = `${did}#key-1`;
+    const verificationMethod = {
+        id: keyId,
+        type: 'Ed25519VerificationKey2020',
+        controller: did,
+        publicKeyMultibase: multibaseEncode(options.publicKey),
+    };
+    return {
+        id: did,
+        verificationMethod: [verificationMethod],
+        authentication: [keyId],
+        assertionMethod: [keyId],
+        keyAgreement: [],
+        service: options.service ?? [],
+        alsoKnownAs: options.alsoKnownAs ?? [],
+    };
+}
+export function getPrimaryPublicKey(document) {
+    const methodId = document.authentication[0] ?? document.verificationMethod[0]?.id;
+    if (!methodId) {
+        return null;
+    }
+    const method = document.verificationMethod.find((entry) => entry.id === methodId);
+    if (!method) {
+        return null;
+    }
+    try {
+        return multibaseDecode(method.publicKeyMultibase);
+    }
+    catch {
+        return null;
+    }
+}
+export function validateDIDDocument(document) {
+    const errors = [];
+    if (!document.id || !document.id.startsWith('did:claw:')) {
+        errors.push('invalid did');
+    }
+    if (!document.verificationMethod?.length) {
+        errors.push('missing verificationMethod');
+    }
+    for (const method of document.verificationMethod ?? []) {
+        if (!method.id || !method.id.startsWith(`${document.id}#`)) {
+            errors.push('invalid verificationMethod id');
+        }
+        if (method.type !== 'Ed25519VerificationKey2020') {
+            errors.push('unsupported verificationMethod type');
+        }
+        if (method.controller !== document.id) {
+            errors.push('invalid verificationMethod controller');
+        }
+        try {
+            multibaseDecode(method.publicKeyMultibase);
+        }
+        catch {
+            errors.push('invalid verificationMethod publicKeyMultibase');
+        }
+    }
+    for (const ref of document.authentication ?? []) {
+        if (!document.verificationMethod.some((entry) => entry.id === ref)) {
+            errors.push('authentication reference not found');
+        }
+    }
+    for (const ref of document.assertionMethod ?? []) {
+        if (!document.verificationMethod.some((entry) => entry.id === ref)) {
+            errors.push('assertionMethod reference not found');
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+export function didFromDocument(document) {
+    return document.id;
+}
+export function publicKeyFromDocument(document) {
+    if (!document.id) {
+        throw new Error('missing did');
+    }
+    return publicKeyFromDid(document.id);
+}
+//# sourceMappingURL=document.js.map

package/dist/identity/document.js.map

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

package/dist/identity/events.d.ts

@@ -0,0 +1,96 @@
+import { EventEnvelope } from '@claw-network/core/protocol';
+import { ClawDIDDocument } from './document.js';
+export interface IdentityCreatePayload {
+    did: string;
+    publicKey: string;
+    document: ClawDIDDocument;
+}
+export interface IdentityUpdatePayload {
+    did: string;
+    document: ClawDIDDocument;
+    prevDocHash: string;
+}
+export interface VerifiableCredentialProof {
+    type: 'Ed25519Signature2020';
+    created: string;
+    verificationMethod: string;
+    proofPurpose: 'assertionMethod';
+    proofValue: string;
+}
+export interface VerifiableCredential<TSubject> {
+    '@context': string[];
+    type: string[];
+    issuer: string;
+    issuanceDate: string;
+    credentialSubject: TSubject;
+    proof: VerifiableCredentialProof;
+}
+export interface PlatformLinkCredentialSubject {
+    id: string;
+    platformId: string;
+    platformUsername: string;
+    linkedAt: string;
+}
+export type PlatformLinkCredential = VerifiableCredential<PlatformLinkCredentialSubject>;
+export interface IdentityPlatformLinkPayload {
+    did: string;
+    platformId: string;
+    platformUsername: string;
+    credential: PlatformLinkCredential;
+}
+export interface CapabilityCredentialSubject {
+    id: string;
+    name: string;
+    pricing: Record<string, unknown>;
+    description?: string;
+}
+export type CapabilityCredential = VerifiableCredential<CapabilityCredentialSubject>;
+export interface IdentityCapabilityRegisterPayload {
+    did: string;
+    name: string;
+    pricing: Record<string, unknown>;
+    description?: string;
+    credential: CapabilityCredential;
+}
+export interface IdentityCreateEventParams {
+    publicKey: Uint8Array;
+    privateKey: Uint8Array;
+    document?: ClawDIDDocument;
+    ts: number;
+    nonce: number;
+    prev?: string;
+}
+export interface IdentityUpdateEventParams {
+    did: string;
+    privateKey: Uint8Array;
+    document: ClawDIDDocument;
+    prevDocHash: string;
+    ts: number;
+    nonce: number;
+    prev?: string;
+}
+export interface IdentityPlatformLinkEventParams {
+    did: string;
+    privateKey: Uint8Array;
+    credential: PlatformLinkCredential;
+    ts: number;
+    nonce: number;
+    prev?: string;
+}
+export interface IdentityCapabilityRegisterEventParams {
+    did: string;
+    privateKey: Uint8Array;
+    name: string;
+    pricing: Record<string, unknown>;
+    description?: string;
+    credential: CapabilityCredential;
+    ts: number;
+    nonce: number;
+    prev?: string;
+}
+export declare function identityDocumentHash(document: ClawDIDDocument): string;
+export declare function createIdentityCreateEnvelope(params: IdentityCreateEventParams): Promise<EventEnvelope>;
+export declare function createIdentityUpdateEnvelope(params: IdentityUpdateEventParams): Promise<EventEnvelope>;
+export declare function createIdentityPlatformLinkEnvelope(params: IdentityPlatformLinkEventParams): Promise<EventEnvelope>;
+export declare function createIdentityCapabilityRegisterEnvelope(params: IdentityCapabilityRegisterEventParams): Promise<EventEnvelope>;
+//# sourceMappingURL=events.d.ts.map

package/dist/identity/events.d.ts.map

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