@atcute/did-plc 0.1.0

package/LICENSE

@@ -0,0 +1,17 @@
+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,15 @@
+# @atcute/did-plc
+
+validations, type definitions and schemas for did:plc operations
+
+```ts
+import { defs, validateIndexedOperationLog } from '@atcute/did-plc';
+
+const did = `did:plc:ragtjsm2j2vknwkz3zp4oxrd`;
+
+const response = await fetch(`https://plc.directory/${did}/log/audit`);
+const json = await response.json();
+
+const logs = defs.indexedOperationLog.parse(json);
+await validateIndexedOperationLog(did, logs);
+```

package/dist/constants.d.ts

@@ -0,0 +1 @@
+export declare const DISPUTE_WINDOW: number;

package/dist/constants.js

@@ -0,0 +1,5 @@
+const SECOND = 1e3;
+const MINUTE = 60 * SECOND;
+const HOUR = 60 * MINUTE;
+export const DISPUTE_WINDOW = 72 * HOUR;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../lib/constants.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,GAAG,CAAC;AACnB,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,CAAC;AAC3B,MAAM,IAAI,GAAG,EAAE,GAAG,MAAM,CAAC;AAEzB,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,GAAG,IAAI,CAAC"}

package/dist/data.d.ts

@@ -0,0 +1,32 @@
+import * as t from './types.js';
+/**
+ * Process an indexed entry by validating it and integrating it into the canonical log.
+ */
+export declare const processIndexedEntry: (did: t.DidPlcString, canonical: t.IndexedEntryWithSigner[], proposed: t.IndexedEntry) => Promise<{
+    prev: string | null;
+    ops: t.IndexedEntryWithSigner[];
+    nullified: t.IndexedEntryWithSigner[];
+}>;
+/**
+ * Process an indexed entry log by sequentially processing each operation.
+ */
+export declare const processIndexedEntryLog: (did: t.DidPlcString, ops: t.IndexedEntryLog) => Promise<{
+    canonical: t.IndexedEntryWithSigner[];
+    nullified: t.IndexedEntryWithSigner[];
+}>;
+/**
+ * Check whether an operation can still be disputed
+ */
+export declare const isDisputePeriodActive: (disputed: t.IndexedEntry, now?: number) => boolean;
+/**
+ * Check if a key is authorized to dispute an operation
+ */
+export declare const isAuthorizedForDispute: (base: t.IndexedEntryWithSigner<t.CompatibleOperation>, disputed: t.IndexedEntryWithSigner, key: t.DidKeyString) => boolean;
+export interface DisputeCandidate {
+    base: t.IndexedEntryWithSigner<t.CompatibleOperation>;
+    disputed: t.IndexedEntryWithSigner;
+}
+/**
+ * Finds operations that can be disputed by a given key
+ */
+export declare const getDisputeCandidates: (canonical: t.IndexedEntryWithSigner[], key: t.DidKeyString) => DisputeCandidate[];

package/dist/data.js

@@ -0,0 +1,183 @@
+import * as CBOR from '@atcute/cbor';
+import * as CID from '@atcute/cid';
+import { toBase32 } from '@atcute/multibase';
+import { toSha256 } from '@atcute/uint8array';
+import { DISPUTE_WINDOW } from './constants.js';
+import * as err from './errors.js';
+import * as t from './types.js';
+import { isSignedOperationValid, normalizeOp } from './utils.js';
+/**
+ * Process an indexed entry by validating it and integrating it into the canonical log.
+ */
+export const processIndexedEntry = async (did, canonical, proposed) => {
+    if (canonical.length === 0) {
+        if (proposed.operation.type === 'plc_tombstone') {
+            throw new err.ImproperOperationError(proposed, `expected genesis op to not be tombstone`);
+        }
+        if (proposed.operation.prev !== null) {
+            throw new err.ImproperOperationError(proposed, `expected null prev on genesis op`);
+        }
+        // Check if CID and DID matches
+        {
+            const opBytes = CBOR.encode(proposed.operation);
+            const expectedDid = `did:plc:${toBase32(await toSha256(opBytes)).slice(0, 24)}`;
+            if (expectedDid !== did) {
+                throw new err.GenesisHashError(proposed, did);
+            }
+            const expectedCid = CID.toString(await CID.create(CID.CODEC_DCBOR, opBytes));
+            if (expectedCid !== proposed.cid) {
+                throw new err.InvalidHashError(proposed, expectedCid);
+            }
+        }
+        // Check if signature is valid
+        let allowedSigners;
+        let signedBy;
+        {
+            const { rotationKeys } = normalizeOp(proposed.operation);
+            const ok = await isSignedOperationValid(rotationKeys, proposed.operation);
+            if (!ok) {
+                throw new err.InvalidSignatureError(proposed);
+            }
+            allowedSigners = rotationKeys;
+            signedBy = ok;
+        }
+        return {
+            prev: null,
+            nullified: [],
+            ops: [{ ...proposed, allowedSigners, signedBy }],
+        };
+    }
+    // Grab the previous reference
+    const proposedPrev = proposed.operation.prev;
+    if (!proposedPrev) {
+        throw new err.ImproperOperationError(proposed, `expected prev op`);
+    }
+    const indexOfPrev = canonical.findIndex((op) => op.cid === proposedPrev);
+    if (indexOfPrev === -1) {
+        throw new err.ImproperOperationError(proposed, `prev op not in history`);
+    }
+    // Check if the CID matches
+    {
+        const opBytes = CBOR.encode(proposed.operation);
+        const expectedCid = CID.toString(await CID.create(CID.CODEC_DCBOR, opBytes));
+        if (expectedCid !== proposed.cid) {
+            throw new err.InvalidHashError(proposed, expectedCid);
+        }
+    }
+    // Get the proposed canonical history
+    const alteredHistory = canonical.slice(0, indexOfPrev + 1);
+    const nullified = canonical.slice(indexOfPrev + 1);
+    const lastOp = alteredHistory.at(-1);
+    if (!lastOp) {
+        throw new err.ImproperOperationError(proposed, `missing last op`);
+    }
+    if (lastOp.operation.type === 'plc_tombstone') {
+        throw new err.ImproperOperationError(proposed, `did is tombstoned`);
+    }
+    const lastOpNormalized = normalizeOp(lastOp.operation);
+    const firstNullified = nullified[0];
+    // We're not nullifying, check if the signature is valid and move on
+    if (!firstNullified) {
+        const allowedSigners = lastOpNormalized.rotationKeys;
+        const signedBy = await isSignedOperationValid(allowedSigners, proposed.operation);
+        if (!signedBy) {
+            throw new err.InvalidSignatureError(proposed);
+        }
+        return {
+            prev: proposedPrev,
+            nullified: [],
+            ops: [...canonical, { ...proposed, allowedSigners, signedBy }],
+        };
+    }
+    // The indexed log should say that all of the nullified has `nullified: true`
+    // for (let idx = 0, len = nullified.length; idx < len; idx++) {
+    // 	const op = nullified[idx];
+    // 	if (!op.nullified) {
+    // 		throw new err.ImproperOperationError(op, `expected nullified prop to be true`);
+    // 	}
+    // }
+    // Check if operation within the recovery window
+    {
+        const lapsed = new Date(proposed.createdAt).getTime() - new Date(firstNullified.createdAt).getTime();
+        if (lapsed > DISPUTE_WINDOW) {
+            throw new err.LateDisputeError(proposed, lapsed);
+        }
+    }
+    // Check if the dispute is valid
+    {
+        let allowedSigners;
+        let signedBy;
+        {
+            const disputedSigner = firstNullified.signedBy;
+            const indexOfSigner = lastOpNormalized.rotationKeys.indexOf(disputedSigner);
+            const morePowerfulKeys = lastOpNormalized.rotationKeys.slice(0, indexOfSigner);
+            const ok = await isSignedOperationValid(morePowerfulKeys, proposed.operation);
+            if (!ok) {
+                throw new err.InvalidSignatureError(proposed);
+            }
+            allowedSigners = morePowerfulKeys;
+            signedBy = ok;
+        }
+        return {
+            prev: proposedPrev,
+            nullified: nullified,
+            ops: [...alteredHistory, { ...proposed, allowedSigners, signedBy }],
+        };
+    }
+};
+/**
+ * Process an indexed entry log by sequentially processing each operation.
+ */
+export const processIndexedEntryLog = async (did, ops) => {
+    let nullified = [];
+    let canonical = [];
+    for (const operation of ops) {
+        const result = await processIndexedEntry(did, canonical, operation);
+        canonical = result.ops;
+        if (result.nullified.length > 0) {
+            nullified = nullified.concat(result.nullified);
+        }
+    }
+    return { canonical, nullified };
+};
+/**
+ * Check whether an operation can still be disputed
+ */
+export const isDisputePeriodActive = (disputed, now = Date.now()) => {
+    const lapsed = now - new Date(disputed.createdAt).getTime();
+    return lapsed <= DISPUTE_WINDOW;
+};
+/**
+ * Check if a key is authorized to dispute an operation
+ */
+export const isAuthorizedForDispute = (base, disputed, key) => {
+    const { rotationKeys } = normalizeOp(base.operation);
+    const disputedSigner = disputed.signedBy;
+    const disputedIndex = rotationKeys.indexOf(disputedSigner);
+    if (disputedIndex === -1) {
+        return false;
+    }
+    const didKeyIndex = rotationKeys.indexOf(key);
+    return didKeyIndex !== -1 && didKeyIndex < disputedIndex;
+};
+/**
+ * Finds operations that can be disputed by a given key
+ */
+export const getDisputeCandidates = (canonical, key) => {
+    const candidates = [];
+    const now = Date.now();
+    for (let idx = 1, len = canonical.length; idx < len; idx++) {
+        const base = canonical[idx - 1];
+        const disputed = canonical[idx];
+        // Only consider if it's still within the recovery window.
+        if (!isDisputePeriodActive(disputed, now)) {
+            continue;
+        }
+        // Check if the provided key is allowed to dispute this operation.
+        if (isAuthorizedForDispute(base, disputed, key)) {
+            candidates.push({ base, disputed });
+        }
+    }
+    return candidates;
+};
+//# sourceMappingURL=data.js.map

package/dist/data.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,33 @@
+import * as t from './types.js';
+export declare class PlcError extends Error {
+    name: string;
+}
+export declare class ImproperOperationError extends PlcError {
+    operation: t.IndexedEntry;
+    reason: string;
+    name: string;
+    constructor(operation: t.IndexedEntry, reason: string);
+}
+export declare class InvalidSignatureError extends PlcError {
+    operation: t.IndexedEntry;
+    name: string;
+    constructor(operation: t.IndexedEntry);
+}
+export declare class InvalidHashError extends PlcError {
+    operation: t.IndexedEntry;
+    expected: string;
+    name: string;
+    constructor(operation: t.IndexedEntry, expected: string);
+}
+export declare class GenesisHashError extends PlcError {
+    operation: t.IndexedEntry;
+    did: t.DidPlcString;
+    name: string;
+    constructor(operation: t.IndexedEntry, did: t.DidPlcString);
+}
+export declare class LateDisputeError extends PlcError {
+    operation: t.IndexedEntry;
+    lapsed: number;
+    name: string;
+    constructor(operation: t.IndexedEntry, lapsed: number);
+}

package/dist/errors.js

@@ -0,0 +1,53 @@
+import * as t from './types.js';
+export class PlcError extends Error {
+    name = 'PlcError';
+}
+export class ImproperOperationError extends PlcError {
+    operation;
+    reason;
+    name = 'ImproperOperationError';
+    constructor(operation, reason) {
+        super(`improper operation; cid=${operation.cid}; reason=${reason}`);
+        this.operation = operation;
+        this.reason = reason;
+    }
+}
+export class InvalidSignatureError extends PlcError {
+    operation;
+    name = 'InvalidSignatureError';
+    constructor(operation) {
+        super(`invalid signature; cid=${operation.cid}`);
+        this.operation = operation;
+    }
+}
+export class InvalidHashError extends PlcError {
+    operation;
+    expected;
+    name = 'InvalidHashError';
+    constructor(operation, expected) {
+        super(`invalid hash; expected=${expected}; got=${operation.cid}`);
+        this.operation = operation;
+        this.expected = expected;
+    }
+}
+export class GenesisHashError extends PlcError {
+    operation;
+    did;
+    name = 'GenesisHashError';
+    constructor(operation, did) {
+        super(`mismatching genesis hash; did=${did}; cid=${operation.cid}`);
+        this.operation = operation;
+        this.did = did;
+    }
+}
+export class LateDisputeError extends PlcError {
+    operation;
+    lapsed;
+    name = 'LateDisputeError';
+    constructor(operation, lapsed) {
+        super(`dispute occured outside of permitted window; cid=${operation.cid}; lapsed=${lapsed}`);
+        this.operation = operation;
+        this.lapsed = lapsed;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../lib/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,YAAY,CAAC;AAEhC,MAAM,OAAO,QAAS,SAAQ,KAAK;IACzB,IAAI,GAAG,UAAU,CAAC;CAC3B;AAED,MAAM,OAAO,sBAAuB,SAAQ,QAAQ;IAI3C;IACA;IAJC,IAAI,GAAG,wBAAwB,CAAC;IAEzC,YACQ,SAAyB,EACzB,MAAc;QAErB,KAAK,CAAC,2BAA2B,SAAS,CAAC,GAAG,YAAY,MAAM,EAAE,CAAC,CAAC;QAH7D,cAAS,GAAT,SAAS,CAAgB;QACzB,WAAM,GAAN,MAAM,CAAQ;IAGtB,CAAC;CACD;AAED,MAAM,OAAO,qBAAsB,SAAQ,QAAQ;IAG/B;IAFV,IAAI,GAAG,uBAAuB,CAAC;IAExC,YAAmB,SAAyB;QAC3C,KAAK,CAAC,0BAA0B,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC;QAD/B,cAAS,GAAT,SAAS,CAAgB;IAE5C,CAAC;CACD;AAED,MAAM,OAAO,gBAAiB,SAAQ,QAAQ;IAIrC;IACA;IAJC,IAAI,GAAG,kBAAkB,CAAC;IAEnC,YACQ,SAAyB,EACzB,QAAgB;QAEvB,KAAK,CAAC,0BAA0B,QAAQ,SAAS,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC;QAH3D,cAAS,GAAT,SAAS,CAAgB;QACzB,aAAQ,GAAR,QAAQ,CAAQ;IAGxB,CAAC;CACD;AAED,MAAM,OAAO,gBAAiB,SAAQ,QAAQ;IAIrC;IACA;IAJC,IAAI,GAAG,kBAAkB,CAAC;IAEnC,YACQ,SAAyB,EACzB,GAAmB;QAE1B,KAAK,CAAC,iCAAiC,GAAG,SAAS,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC;QAH7D,cAAS,GAAT,SAAS,CAAgB;QACzB,QAAG,GAAH,GAAG,CAAgB;IAG3B,CAAC;CACD;AAED,MAAM,OAAO,gBAAiB,SAAQ,QAAQ;IAIrC;IACA;IAJC,IAAI,GAAG,kBAAkB,CAAC;IAEnC,YACQ,SAAyB,EACzB,MAAc;QAErB,KAAK,CAAC,oDAAoD,SAAS,CAAC,GAAG,YAAY,MAAM,EAAE,CAAC,CAAC;QAHtF,cAAS,GAAT,SAAS,CAAgB;QACzB,WAAM,GAAN,MAAM,CAAQ;IAGtB,CAAC;CACD"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * as defs from './typedefs.js';
+export * from './types.js';
+export * from './constants.js';
+export * from './data.js';
+export * from './errors.js';
+export * from './utils.js';

package/dist/index.js

@@ -0,0 +1,7 @@
+export * as defs from './typedefs.js';
+export * from './types.js';
+export * from './constants.js';
+export * from './data.js';
+export * from './errors.js';
+export * from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AACtC,cAAc,YAAY,CAAC;AAE3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/typedefs.d.ts

@@ -0,0 +1,17 @@
+import * as v from '@badrap/valita';
+import * as t from './types.js';
+export declare const didPlcString: v.Type<`did:plc:${string}`>;
+export declare const didKeyString: v.Type<`did:key:${string}`>;
+export declare const unsignedLegacyCreateOperation: v.Type<t.UnsignedLegacyCreateOperation>;
+export declare const legacyCreateOperation: v.Type<t.LegacyCreateOperation>;
+export declare const service: v.Type<t.Service>;
+export declare const unsignedOperation: v.Type<t.UnsignedOperation>;
+export declare const operation: v.Type<t.Operation>;
+export declare const unsignedTombstone: v.Type<t.UnsignedTombstone>;
+export declare const tombstone: v.Type<t.Tombstone>;
+export declare const compatibleOperation: v.Type<t.CompatibleOperation>;
+export declare const compatibleOperationOrTombstone: v.Type<t.CompatibleOperationOrTombstone>;
+export declare const operationOrTombstone: v.Type<t.OperationOrTombstone>;
+export declare const operationLog: v.Type<t.OperationLog>;
+export declare const indexedEntry: v.Type<t.IndexedEntry>;
+export declare const indexedEntryLog: v.Type<t.IndexedEntryLog>;

package/dist/typedefs.js

@@ -0,0 +1,162 @@
+import * as v from '@badrap/valita';
+import * as CID from '@atcute/cid';
+import { parseDidKey } from '@atcute/crypto';
+import * as t from './types.js';
+// #region Strings
+const DID_PLC_RE = /^did:plc:([a-z2-7]{24})$/;
+export const didPlcString = v
+    .string()
+    .assert((input) => DID_PLC_RE.test(input), `must be a did:plc`);
+export const didKeyString = v.string().chain((input) => {
+    try {
+        parseDidKey(input);
+    }
+    catch (err) {
+        if (err instanceof SyntaxError) {
+            return v.err(`did:key can't be parsed`);
+        }
+        return v.err(`invalid did:key`);
+    }
+    return v.ok(input);
+});
+const cidString = v.string().chain((input) => {
+    try {
+        CID.fromString(input);
+    }
+    catch {
+        return v.err(`invalid cid`);
+    }
+    return v.ok(input);
+});
+// #endregion
+// #region create
+const _unsignedLegacyCreateOperation = v.object({
+    type: v.literal('create'),
+    prev: v.null(),
+    signingKey: didKeyString,
+    recoveryKey: didKeyString,
+    handle: v.string().assert((input) => input.length <= 256, `handle too long (max 256 characters)`),
+    service: v
+        .string()
+        .assert((input) => input.length <= 512, `service endpoint too long (max 512 characters)`),
+});
+export const unsignedLegacyCreateOperation = _unsignedLegacyCreateOperation;
+export const legacyCreateOperation = _unsignedLegacyCreateOperation.extend({
+    sig: v.string(),
+});
+// #endregion
+// #region plc_operation
+export const service = v.object({
+    type: v.string().assert((input) => input.length <= 256, `service type too long (max 256 characters)`),
+    endpoint: v
+        .string()
+        .assert((input) => input.length <= 512, `service endpoint too long (max 512 characters)`),
+});
+const _unsignedOperation = v.object({
+    type: v.literal('plc_operation'),
+    prev: v.string().nullable(),
+    rotationKeys: v.array(didKeyString).chain((input) => {
+        const length = input.length;
+        if (length === 0) {
+            return v.err(`missing rotation keys`);
+        }
+        else if (length > 10) {
+            return v.err(`too many rotation keys (max 10 keys)`);
+        }
+        for (let i = 0; i < length; i++) {
+            const key = input[i];
+            for (let j = 0; j < i; j++) {
+                if (input[j] === key) {
+                    return v.err({
+                        message: `duplicate "${key}" rotation key`,
+                        path: [i],
+                    });
+                }
+            }
+        }
+        return v.ok(input);
+    }),
+    verificationMethods: v.record(didKeyString).chain((input) => {
+        for (const id in input) {
+            if (id.length > 32) {
+                return v.err({
+                    message: `verification method id too long (max 32 characters)`,
+                    path: [id],
+                });
+            }
+        }
+        return v.ok(input);
+    }),
+    alsoKnownAs: v
+        .array(v.string().assert((input) => input.length <= 256, `aka entry too long (max 256 characters)`))
+        .chain((input) => {
+        const length = input.length;
+        if (length > 10) {
+            return v.err(`too many aka entries (max 10)`);
+        }
+        for (let i = 0; i < length; i++) {
+            const aka = input[i];
+            for (let j = 0; j < i; j++) {
+                if (input[j] === aka) {
+                    return v.err({
+                        message: `duplicate "${aka}" aka entry`,
+                        path: [i],
+                    });
+                }
+            }
+        }
+        return v.ok(input);
+    }),
+    services: v.record(service).chain((input) => {
+        const length = Object.keys(input).length;
+        if (length > 10) {
+            return v.err(`too many service entries (max 10)`);
+        }
+        for (const id in input) {
+            if (id.length > 32) {
+                return v.err({
+                    message: `service id too long (max 32 characters)`,
+                    path: [id],
+                });
+            }
+        }
+        return v.ok(input);
+    }),
+});
+export const unsignedOperation = _unsignedOperation;
+export const operation = _unsignedOperation.extend({
+    sig: v.string(),
+});
+// #endregion
+// #region plc_tombstone
+const _unsignedTombstone = v.object({
+    type: v.literal('plc_tombstone'),
+    prev: v.string(),
+});
+export const unsignedTombstone = _unsignedTombstone;
+export const tombstone = _unsignedTombstone.extend({
+    sig: v.string(),
+});
+// #endregion
+// #region Entry
+export const compatibleOperation = v.union(operation, legacyCreateOperation);
+export const compatibleOperationOrTombstone = v.union(operation, legacyCreateOperation, tombstone);
+export const operationOrTombstone = v.union(operation, tombstone);
+export const operationLog = v
+    .tuple([compatibleOperation])
+    .concat(v.array(operationOrTombstone));
+// #endregion
+// #region Indexed entry
+const _indexedEntry = v.object({
+    did: didPlcString,
+    operation: compatibleOperationOrTombstone,
+    cid: cidString,
+    nullified: v.boolean(),
+    createdAt: v.string().assert((input) => !Number.isNaN(new Date(input).getTime()), `invalid timestamp`),
+});
+export const indexedEntry = _indexedEntry;
+export const indexedEntryLog = v
+    .tuple([_indexedEntry.extend({ operation: compatibleOperation })])
+    .concat(v.array(_indexedEntry.extend({ operation: operationOrTombstone })));
+// #endregion
+//# sourceMappingURL=typedefs.js.map

package/dist/typedefs.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,54 @@
+export type DidPlcString = `did:plc:${string}`;
+export type DidKeyString = `did:key:${string}`;
+export interface UnsignedLegacyCreateOperation {
+    type: 'create';
+    prev: null;
+    signingKey: DidKeyString;
+    recoveryKey: DidKeyString;
+    handle: string;
+    service: string;
+}
+export interface LegacyCreateOperation extends UnsignedLegacyCreateOperation {
+    sig: string;
+}
+export interface Service {
+    type: string;
+    endpoint: string;
+}
+export interface UnsignedOperation {
+    type: 'plc_operation';
+    prev: string | null;
+    alsoKnownAs: string[];
+    rotationKeys: DidKeyString[];
+    verificationMethods: Record<string, DidKeyString>;
+    services: Record<string, Service>;
+}
+export interface Operation extends UnsignedOperation {
+    sig: string;
+}
+export interface UnsignedTombstone {
+    type: 'plc_tombstone';
+    prev: string;
+}
+export interface Tombstone extends UnsignedTombstone {
+    sig: string;
+}
+export type CompatibleOperation = Operation | LegacyCreateOperation;
+export type CompatibleOperationOrTombstone = CompatibleOperation | Tombstone;
+export type OperationOrTombstone = Operation | Tombstone;
+export type OperationLog = [genesis: CompatibleOperation, ...OperationOrTombstone[]];
+export interface IndexedEntry<T extends CompatibleOperationOrTombstone = CompatibleOperationOrTombstone> {
+    did: DidPlcString;
+    operation: T;
+    cid: string;
+    nullified: boolean;
+    createdAt: string;
+}
+export interface IndexedEntryWithSigner<T extends CompatibleOperationOrTombstone = CompatibleOperationOrTombstone> extends IndexedEntry<T> {
+    allowedSigners: DidKeyString[];
+    signedBy: DidKeyString;
+}
+export type IndexedEntryLog = [
+    genesis: IndexedEntry<CompatibleOperation>,
+    ...IndexedEntry<OperationOrTombstone>[]
+];

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../lib/types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,5 @@
+import * as t from './types.js';
+export declare const wrapHttpPrefix: (str: string) => string;
+export declare const wrapAtprotoPrefix: (str: string) => string;
+export declare const normalizeOp: (op: t.CompatibleOperation) => t.Operation;
+export declare const isSignedOperationValid: (allowedKeys: t.DidKeyString[], op: t.CompatibleOperationOrTombstone) => Promise<t.DidKeyString | null>;