@fedify/fedify 2.4.0-dev.1570 → 2.4.0-dev.1571

package/README.md

@@ -9,9 +9,6 @@
 [![Matrix][Matrix badge]][Matrix]
 [![@fedify@hackers.pub][@fedify@hackers.pub badge]][@fedify@hackers.pub]
 
-> [!NOTE]
-> Looking for a quick demo?  Here it is: [Fedify Demo] on Deno Playground.
-
 Fedify is a TypeScript library for building federated server apps
 powered by [ActivityPub] and other standards, so-called [fediverse].[^1]
 It aims to eliminate the complexity and boilerplate code when
@@ -63,7 +60,6 @@ in the fediverse!
 [Matrix]: https://matrix.to/#/#fedify:matrix.org
 [@fedify@hackers.pub badge]: https://fedi-badge.minhee.org/@fedify@hackers.pub/followers.svg
 [@fedify@hackers.pub]: https://hackers.pub/@fedify
-[Fedify Demo]: https://dash.deno.com/playground/fedify-demo
 [ActivityPub]: https://www.w3.org/TR/activitypub/
 [fediverse]: https://en.wikipedia.org/wiki/Fediverse
 [Activity Vocabulary]: https://www.w3.org/TR/activitystreams-vocabulary/

package/dist/{builder-CJnWbgbj.mjs → builder-CBgmNPaS.mjs}

@@ -1,7 +1,7 @@
 import "@js-temporal/polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
-import { n as version, t as name } from "./deno-klNxGW7W.mjs";
+import { n as version, t as name } from "./deno-ColSXZB4.mjs";
 import { t as ActivityListenerSet } from "./activity-listener-BeTGV3wc.mjs";
 import { getLogger } from "@logtape/logtape";
 import { Router, RouterError, assertPath } from "@fedify/uri-template";
@@ -82,7 +82,7 @@ var FederationBuilderImpl = class {
 	* specified.
 	*/
 	async build(options) {
-		const { FederationImpl } = await import("./middleware-CdMiavoh.mjs");
+		const { FederationImpl } = await import("./middleware-B9bNYUM5.mjs");
 		const f = new FederationImpl(options);
 		const trailingSlashInsensitiveValue = f.router.trailingSlashInsensitive;
 		f.router = this.router.clone();

package/dist/compat/transformers.test.mjs

@@ -5,7 +5,7 @@ import { t as MemoryKvStore } from "../kv-CIvR3Non.mjs";
 import { t as assertEquals } from "../assert_equals-PBVKNMJd.mjs";
 import { t as assertInstanceOf } from "../assert_instance_of-CxoC8bVq.mjs";
 import { t as assert } from "../assert-DvVHoIZ0.mjs";
-import { b as autoIdAssigner, n as FederationImpl, y as actorDehydrator } from "../middleware-CjHqy-1i.mjs";
+import { b as autoIdAssigner, n as FederationImpl, y as actorDehydrator } from "../middleware-DkRMEKQc.mjs";
 import { Follow, Person } from "@fedify/vocab";
 import { test } from "@fedify/fixture";
 //#region src/compat/transformers.test.ts

package/dist/{deno-klNxGW7W.mjs → deno-ColSXZB4.mjs}

@@ -3,6 +3,6 @@ import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
 //#region deno.json
 var name = "@fedify/fedify";
-var version = "2.4.0-dev.1570+f1b6aaa3";
+var version = "2.4.0-dev.1571+31e2786b";
 //#endregion
 export { version as n, name as t };

package/dist/{docloader-CuFH35j1.mjs → docloader-BQGU0tG-.mjs}

@@ -1,8 +1,8 @@
 import "@js-temporal/polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
-import { o as validateCryptoKey } from "./key-o0_ipvUR.mjs";
-import { n as doubleKnock } from "./http-JdRPUYku.mjs";
+import { o as validateCryptoKey } from "./key-C5fRM_21.mjs";
+import { n as doubleKnock } from "./http-CuG4iKEH.mjs";
 import { getLogger } from "@logtape/logtape";
 import { curry } from "es-toolkit";
 import { UrlError, createActivityPubRequest, getRemoteDocument, logRequest, validatePublicUrl } from "@fedify/vocab-runtime";

package/dist/federation/builder.test.mjs

@@ -5,7 +5,7 @@ import { t as MemoryKvStore } from "../kv-CIvR3Non.mjs";
 import { t as assertEquals } from "../assert_equals-PBVKNMJd.mjs";
 import { r as assertExists } from "../std__assert-Dh6uLf_q.mjs";
 import { t as assertThrows } from "../assert_throws-zN79lgIC.mjs";
-import { r as createFederationBuilder } from "../builder-CJnWbgbj.mjs";
+import { r as createFederationBuilder } from "../builder-CBgmNPaS.mjs";
 import { DisallowedOperatorError, DisallowedVarSpecModifierError, DuplicateRouteVariableError, RouteTemplateOptionsNotMatchedError, RouterError } from "@fedify/uri-template";
 import { Activity, Note, Person } from "@fedify/vocab";
 import { test } from "@fedify/fixture";

package/dist/federation/handler.test.mjs

@@ -9,10 +9,10 @@ import { n as assertGreaterOrEqual, t as assertRejects } from "../assert_rejects
 import { t as assertInstanceOf } from "../assert_instance_of-CxoC8bVq.mjs";
 import { t as assert } from "../assert-DvVHoIZ0.mjs";
 import { r as parseAcceptSignature } from "../accept-CgDcxvjV.mjs";
-import { s as signRequest } from "../http-JdRPUYku.mjs";
+import { s as signRequest } from "../http-CuG4iKEH.mjs";
 import { a as rsaPrivateKey3, c as rsaPublicKey3, s as rsaPublicKey2 } from "../keys-CSYsOMFG.mjs";
-import { a as compactJsonLd, p as signJsonLd } from "../ld-C__CEgQH.mjs";
-import { c as handleActor, d as handleInbox, f as handleObject, h as respondWithObjectIfAcceptable, l as handleCollection, m as respondWithObject, o as createFederation, p as handleOutbox, u as handleCustomCollection } from "../middleware-CjHqy-1i.mjs";
+import { a as compactJsonLd, p as signJsonLd } from "../ld-DxtnUVwj.mjs";
+import { c as handleActor, d as handleInbox, f as handleObject, h as respondWithObjectIfAcceptable, l as handleCollection, m as respondWithObject, o as createFederation, p as handleOutbox, u as handleCustomCollection } from "../middleware-DkRMEKQc.mjs";
 import { t as ActivityListenerSet } from "../activity-listener-BeTGV3wc.mjs";
 import { Activity, Create, Note, Person, Tombstone } from "@fedify/vocab";
 import { createTestMeterProvider, createTestTracerProvider, mockDocumentLoader, test } from "@fedify/fixture";
@@ -111,11 +111,16 @@ test("handleActor()", async () => {
 			"https://www.w3.org/ns/did/v1",
 			"https://w3id.org/security/multikey/v1",
 			"https://gotosocial.org/ns",
+			"https://w3id.org/fep/7aa9",
 			{
 				alsoKnownAs: {
 					"@id": "as:alsoKnownAs",
 					"@type": "@id"
 				},
+				featuredCollections: {
+					"@id": "https://w3id.org/fep/7aa9#featuredCollections",
+					"@type": "@id"
+				},
 				manuallyApprovesFollowers: "as:manuallyApprovesFollowers",
 				movedTo: {
 					"@id": "as:movedTo",
@@ -195,11 +200,16 @@ test("handleActor()", async () => {
 			"https://www.w3.org/ns/did/v1",
 			"https://w3id.org/security/multikey/v1",
 			"https://gotosocial.org/ns",
+			"https://w3id.org/fep/7aa9",
 			{
 				alsoKnownAs: {
 					"@id": "as:alsoKnownAs",
 					"@type": "@id"
 				},
+				featuredCollections: {
+					"@id": "https://w3id.org/fep/7aa9#featuredCollections",
+					"@type": "@id"
+				},
 				manuallyApprovesFollowers: "as:manuallyApprovesFollowers",
 				movedTo: {
 					"@id": "as:movedTo",

package/dist/federation/idempotency.test.mjs

@@ -5,8 +5,8 @@ import { t as MemoryKvStore } from "../kv-CIvR3Non.mjs";
 import { t as assertEquals } from "../assert_equals-PBVKNMJd.mjs";
 import "../std__assert-Dh6uLf_q.mjs";
 import { n as ed25519PrivateKey, r as ed25519PublicKey, t as ed25519Multikey } from "../keys-CSYsOMFG.mjs";
-import { r as signObject } from "../proof-CuQpZ_AT.mjs";
-import { o as createFederation } from "../middleware-CjHqy-1i.mjs";
+import { r as signObject } from "../proof-BpDfPXQU.mjs";
+import { o as createFederation } from "../middleware-DkRMEKQc.mjs";
 import { Create, Follow, Person } from "@fedify/vocab";
 import { mockDocumentLoader, test } from "@fedify/fixture";
 //#region src/federation/idempotency.test.ts

package/dist/federation/metrics.test.mjs

@@ -4,7 +4,7 @@ globalThis.addEventListener = () => {};
 import { t as assertEquals } from "../assert_equals-PBVKNMJd.mjs";
 import "../std__assert-Dh6uLf_q.mjs";
 import { t as assertRejects } from "../assert_rejects-DAdaaIWM.mjs";
-import { _ as recordKeyLookup, a as instrumentDocumentLoader, b as recordWebFingerHandle, c as recordCircuitBreakerStateChange, d as recordCollectionRequest, f as recordCollectionTotalItems, g as recordInboxActivity, h as recordFanoutRecipients, i as getRemoteHost, l as recordCollectionDispatchDuration, m as recordDocumentFetch, p as recordDocumentCache, r as getFederationMetrics, t as classifyFetchError, u as recordCollectionPageItems, v as recordOutboxActivity, x as registerQueueDepthGauge, y as recordOutboxEnqueue } from "../metrics-CLSPm4dZ.mjs";
+import { _ as recordKeyLookup, a as instrumentDocumentLoader, b as recordWebFingerHandle, c as recordCircuitBreakerStateChange, d as recordCollectionRequest, f as recordCollectionTotalItems, g as recordInboxActivity, h as recordFanoutRecipients, i as getRemoteHost, l as recordCollectionDispatchDuration, m as recordDocumentFetch, p as recordDocumentCache, r as getFederationMetrics, t as classifyFetchError, u as recordCollectionPageItems, v as recordOutboxActivity, x as registerQueueDepthGauge, y as recordOutboxEnqueue } from "../metrics-C60MEuIn.mjs";
 import { createTestMeterProvider, test } from "@fedify/fixture";
 import { FetchError } from "@fedify/vocab-runtime";
 import { DataPointType, MeterProvider, MetricReader } from "@opentelemetry/sdk-metrics";

package/dist/federation/middleware.test.mjs

@@ -12,14 +12,14 @@ import { t as assertThrows } from "../assert_throws-zN79lgIC.mjs";
 import { t as assertNotEquals } from "../assert_not_equals-C8vcTTA3.mjs";
 import { t as assertStrictEquals } from "../assert_strict_equals-BzqyKuYL.mjs";
 import { t as assert } from "../assert-DvVHoIZ0.mjs";
-import { g as recordInboxActivity } from "../metrics-CLSPm4dZ.mjs";
-import { l as verifyRequest, s as signRequest } from "../http-JdRPUYku.mjs";
+import { g as recordInboxActivity } from "../metrics-C60MEuIn.mjs";
+import { l as verifyRequest, s as signRequest } from "../http-CuG4iKEH.mjs";
 import { a as rsaPrivateKey3, c as rsaPublicKey3, i as rsaPrivateKey2, n as ed25519PrivateKey, r as ed25519PublicKey, s as rsaPublicKey2, t as ed25519Multikey } from "../keys-CSYsOMFG.mjs";
-import { t as getAuthenticatedDocumentLoader } from "../docloader-CuFH35j1.mjs";
-import { a as compactJsonLd, h as verifyJsonLd, p as signJsonLd, s as detachSignature } from "../ld-C__CEgQH.mjs";
-import { t as doesActorOwnKey } from "../owner-gz4TUfKG.mjs";
-import { i as verifyObject, r as signObject } from "../proof-CuQpZ_AT.mjs";
-import { g as handleBenchmarkTrigger, i as KvSpecDeterminer, n as FederationImpl, o as createFederation, r as InboxContextImpl, t as ContextImpl } from "../middleware-CjHqy-1i.mjs";
+import { t as getAuthenticatedDocumentLoader } from "../docloader-BQGU0tG-.mjs";
+import { a as compactJsonLd, h as verifyJsonLd, p as signJsonLd, s as detachSignature } from "../ld-DxtnUVwj.mjs";
+import { t as doesActorOwnKey } from "../owner-DA4lyeXg.mjs";
+import { i as verifyObject, r as signObject } from "../proof-BpDfPXQU.mjs";
+import { g as handleBenchmarkTrigger, i as KvSpecDeterminer, n as FederationImpl, o as createFederation, r as InboxContextImpl, t as ContextImpl } from "../middleware-DkRMEKQc.mjs";
 import { t as CircuitBreaker } from "../circuit-breaker-hJBB6jwA.mjs";
 import { t as TaskCodec } from "../codec-nfBU4Up4.mjs";
 import { configure, reset } from "@logtape/logtape";

package/dist/federation/mod.cjs

@@ -2,7 +2,7 @@ const { Temporal } = require("@js-temporal/polyfill");
 const { URLPattern } = require("urlpattern-polyfill");
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../chunk-DDcVe30Y.cjs");
-const require_middleware = require("../middleware-B502nwxx.cjs");
+const require_middleware = require("../middleware-Cp410Lku.cjs");
 let _logtape_logtape = require("@logtape/logtape");
 let _fedify_uri_template = require("@fedify/uri-template");
 let es_toolkit = require("es-toolkit");

package/dist/federation/mod.js

@@ -1,6 +1,6 @@
 import { Temporal } from "@js-temporal/polyfill";
 import { URLPattern } from "urlpattern-polyfill";
-import { a as ParallelMessageQueue, c as respondWithObject, d as digest, f as CircuitBreaker, h as createFederationBuilder, i as InProcessMessageQueue, l as respondWithObjectIfAcceptable, m as parseCircuitBreakerKvState, o as createExponentialBackoffPolicy, p as normalizeCircuitBreakerOptions, r as handleWebFinger, s as SendActivityError, t as createFederation, u as buildCollectionSynchronizationHeader } from "../middleware-zuLSkPIk.js";
+import { a as ParallelMessageQueue, c as respondWithObject, d as digest, f as CircuitBreaker, h as createFederationBuilder, i as InProcessMessageQueue, l as respondWithObjectIfAcceptable, m as parseCircuitBreakerKvState, o as createExponentialBackoffPolicy, p as normalizeCircuitBreakerOptions, r as handleWebFinger, s as SendActivityError, t as createFederation, u as buildCollectionSynchronizationHeader } from "../middleware-DY9SToNd.js";
 import { getLogger } from "@logtape/logtape";
 import { Router as Router$1, RouterError as RouterError$1, assertPath, isPath } from "@fedify/uri-template";
 import { isEqual } from "es-toolkit";

package/dist/federation/send.test.mjs

@@ -8,10 +8,10 @@ import { n as assertGreaterOrEqual, r as assertFalse, t as assertRejects } from
 import { t as assertInstanceOf } from "../assert_instance_of-CxoC8bVq.mjs";
 import { t as assertNotEquals } from "../assert_not_equals-C8vcTTA3.mjs";
 import { t as assert } from "../assert-DvVHoIZ0.mjs";
-import { l as verifyRequest } from "../http-JdRPUYku.mjs";
+import { l as verifyRequest } from "../http-CuG4iKEH.mjs";
 import { i as rsaPrivateKey2, n as ed25519PrivateKey, s as rsaPublicKey2, t as ed25519Multikey } from "../keys-CSYsOMFG.mjs";
-import { t as doesActorOwnKey } from "../owner-gz4TUfKG.mjs";
-import { n as extractInboxes, r as sendActivity, t as SendActivityError } from "../send-B60teucv.mjs";
+import { t as doesActorOwnKey } from "../owner-DA4lyeXg.mjs";
+import { n as extractInboxes, r as sendActivity, t as SendActivityError } from "../send-DfeB83F0.mjs";
 import { Activity, Application, Endpoints, Group, Person, Service } from "@fedify/vocab";
 import { createTestMeterProvider, createTestTracerProvider, mockDocumentLoader, test } from "@fedify/fixture";
 import { FetchError } from "@fedify/vocab-runtime";

package/dist/federation/tasks/enqueue.test.mjs

@@ -3,7 +3,7 @@ import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
 import { t as MemoryKvStore } from "../../kv-CIvR3Non.mjs";
 import { a as numberSchema, i as makeSchema, n as baseOptions, o as stringSchema, t as MockQueue } from "../../testing-Dy-WhqpN.mjs";
-import { o as createFederation } from "../../middleware-CjHqy-1i.mjs";
+import { o as createFederation } from "../../middleware-DkRMEKQc.mjs";
 import { n as ParallelMessageQueue } from "../../mq-03vS-C9P.mjs";
 import { configure, reset } from "@logtape/logtape";
 import { delay } from "es-toolkit";

package/dist/federation/tasks/tasks.test.mjs

@@ -3,8 +3,8 @@ import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
 import { t as MemoryKvStore } from "../../kv-CIvR3Non.mjs";
 import { a as numberSchema, i as makeSchema, n as baseOptions, o as stringSchema, t as MockQueue } from "../../testing-Dy-WhqpN.mjs";
-import { o as createFederation } from "../../middleware-CjHqy-1i.mjs";
-import { r as createFederationBuilder } from "../../builder-CJnWbgbj.mjs";
+import { o as createFederation } from "../../middleware-DkRMEKQc.mjs";
+import { r as createFederationBuilder } from "../../builder-CBgmNPaS.mjs";
 import { t as TaskCodec } from "../../codec-nfBU4Up4.mjs";
 import { t as InProcessMessageQueue } from "../../mq-03vS-C9P.mjs";
 import { W3CTraceContextPropagator } from "@opentelemetry/core";

package/dist/federation/temporal.test.mjs

@@ -4,7 +4,7 @@ globalThis.addEventListener = () => {};
 import "../std__assert-Dh6uLf_q.mjs";
 import { r as assertFalse } from "../assert_rejects-DAdaaIWM.mjs";
 import { t as assert } from "../assert-DvVHoIZ0.mjs";
-import { t as hasMalformedKnownTemporalLiteral } from "../temporal-CvVMrvJJ.mjs";
+import { t as hasMalformedKnownTemporalLiteral } from "../temporal-CIHMi9QT.mjs";
 import { test } from "@fedify/fixture";
 //#region src/federation/temporal.test.ts
 test("hasMalformedKnownTemporalLiteral() detects expanded proof timestamps", async () => {

package/dist/federation/webfinger.test.mjs

@@ -6,7 +6,7 @@ import { t as MemoryKvStore } from "../kv-CIvR3Non.mjs";
 import { t as assertEquals } from "../assert_equals-PBVKNMJd.mjs";
 import "../std__assert-Dh6uLf_q.mjs";
 import { t as assertNotEquals } from "../assert_not_equals-C8vcTTA3.mjs";
-import { o as createFederation, s as handleWebFinger } from "../middleware-CjHqy-1i.mjs";
+import { o as createFederation, s as handleWebFinger } from "../middleware-DkRMEKQc.mjs";
 import { Image, Link, Person, Tombstone } from "@fedify/vocab";
 import { createTestMeterProvider, test } from "@fedify/fixture";
 //#region src/federation/webfinger.test.ts

package/dist/{http-D0jH0kco.js → http-BciNZ5qO.js}

@@ -1,16 +1,16 @@
 import { Temporal } from "@js-temporal/polyfill";
 import { URLPattern } from "urlpattern-polyfill";
 import { getLogger } from "@logtape/logtape";
-import { CryptographicKey, Object as Object$1, isActor } from "@fedify/vocab";
+import { CryptographicKey, Multikey, Object as Object$1, isActor } from "@fedify/vocab";
 import { SpanKind, SpanStatusCode, metrics, trace } from "@opentelemetry/api";
 import { encodeHex } from "byte-encodings/hex";
 import { Item, decodeDict, encodeDict, encodeItem } from "structured-field-values";
-import { FetchError, getDocumentLoader } from "@fedify/vocab-runtime";
+import { FetchError, getDocumentLoader, parseDidKeyVerificationMethod } from "@fedify/vocab-runtime";
 import { ATTR_HTTP_REQUEST_HEADER, ATTR_HTTP_REQUEST_METHOD, ATTR_URL_FULL } from "@opentelemetry/semantic-conventions";
 import { decodeBase64, encodeBase64 } from "byte-encodings/base64";
 //#region deno.json
 var name = "@fedify/fedify";
-var version = "2.4.0-dev.1570+f1b6aaa3";
+var version = "2.4.0-dev.1571+31e2786b";
 //#endregion
 //#region src/sig/accept.ts
 /**
@@ -314,11 +314,11 @@ var FederationMetrics = class {
 			unit: "{change}"
 		});
 		this.keyLookup = meter.createCounter("activitypub.key.lookup", {
-			description: "Public-key lookup attempts performed by Fedify, including both cache hits and remote fetches.",
+			description: "Public-key lookup attempts performed by Fedify, including cache hits, local resolutions, and remote fetches.",
 			unit: "{lookup}"
 		});
 		this.keyLookupDuration = meter.createHistogram("activitypub.key.lookup.duration", {
-			description: "Duration of public-key lookups performed by Fedify, including any remote fetch.",
+			description: "Duration of public-key lookups performed by Fedify, including cache hits, local resolutions, and any remote fetch.",
 			unit: "ms",
 			advice: { explicitBucketBoundaries: [
 				5,
@@ -1149,16 +1149,22 @@ async function fetchKeyDetailed(keyId, cls, options = {}) {
 async function getCachedFetchKey(cacheKey, keyId, cls, keyCache, logger) {
 	if (keyCache == null) return null;
 	const cachedKey = await keyCache.get(cacheKey);
-	if (cachedKey instanceof cls && cachedKey.publicKey != null) {
-		logger.debug("Key {keyId} found in cache.", { keyId });
+	const hit = checkCachedKeyHit(cachedKey, keyId, cls, logger);
+	if (hit != null) return hit;
+	if (cachedKey === null) {
+		logger.debug("Entry {keyId} found in cache, but it is unavailable.", { keyId });
 		return {
-			key: cachedKey,
+			key: null,
 			cached: true
 		};
-	} else if (cachedKey === null) {
-		logger.debug("Entry {keyId} found in cache, but it is unavailable.", { keyId });
+	}
+	return null;
+}
+function checkCachedKeyHit(cachedKey, keyId, cls, logger) {
+	if (cachedKey instanceof cls && cachedKey.publicKey != null) {
+		logger.debug("Key {keyId} found in cache.", { keyId });
 		return {
-			key: null,
+			key: cachedKey,
 			cached: true
 		};
 	}
@@ -1167,6 +1173,61 @@ async function getCachedFetchKey(cacheKey, keyId, cls, keyCache, logger) {
 async function clearFetchErrorMetadata(keyId, keyCache) {
 	await keyCache?.setFetchError?.(keyId, null);
 }
+function isDidKeyUrl(keyId) {
+	return keyId.protocol === "did:" && keyId.pathname.startsWith("key:");
+}
+async function doRawKeysMatch(left, right) {
+	const [leftRaw, rightRaw] = await Promise.all([crypto.subtle.exportKey("raw", left), crypto.subtle.exportKey("raw", right)]);
+	if (leftRaw.byteLength !== rightRaw.byteLength) return false;
+	const leftBytes = new Uint8Array(leftRaw);
+	const rightBytes = new Uint8Array(rightRaw);
+	return leftBytes.every((byte, index) => byte === rightBytes[index]);
+}
+async function isCachedDidKeyValid(key, verificationMethod) {
+	try {
+		return key.id?.href === verificationMethod.id.href && key.controllerId?.href === verificationMethod.controller.href && await doRawKeysMatch(key.publicKey, verificationMethod.publicKey);
+	} catch {
+		return false;
+	}
+}
+async function resolveDidKey(cacheKey, cls, keyCache, logger) {
+	if (!isDidKeyUrl(cacheKey)) return null;
+	const keyId = cacheKey.href;
+	if (!(cls === Multikey)) {
+		logger.debug("Failed to resolve did:key {keyId}; did:key verification methods are only supported as Multikey values.", { keyId });
+		return {
+			key: null,
+			cached: false
+		};
+	}
+	let verificationMethod;
+	try {
+		verificationMethod = await parseDidKeyVerificationMethod(cacheKey);
+	} catch (error) {
+		logger.debug("Failed to resolve did:key verification method {keyId}: {error}", {
+			keyId,
+			error
+		});
+		return {
+			key: null,
+			cached: false
+		};
+	}
+	const hit = checkCachedKeyHit(await keyCache?.get(cacheKey), keyId, cls, logger);
+	if (hit?.key instanceof Multikey && await isCachedDidKeyValid(hit.key, verificationMethod)) return hit;
+	const key = new Multikey({
+		id: verificationMethod.id,
+		controller: verificationMethod.controller,
+		publicKey: verificationMethod.publicKey
+	});
+	await keyCache?.set(cacheKey, key);
+	await clearFetchErrorMetadata(cacheKey, keyCache);
+	logger.debug("Resolved did:key verification method {keyId}.", { keyId });
+	return {
+		key,
+		cached: false
+	};
+}
 async function resolveFetchedKey(document, cacheKey, keyId, cls, { documentLoader, contextLoader, keyCache, tracerProvider }, logger) {
 	let object;
 	try {
@@ -1281,6 +1342,11 @@ async function fetchKeyWithResult(cacheKey, cls, options, onCachedUnavailable, o
 		]);
 		const keyId = cacheKey.href;
 		const keyCache = options.keyCache;
+		const didKey = await resolveDidKey(cacheKey, cls, keyCache, logger);
+		if (didKey != null) {
+			outcome = { result: didKey.key == null ? "invalid" : didKey.cached ? "hit" : "fetched" };
+			return didKey;
+		}
 		const cached = await getCachedFetchKey(cacheKey, keyId, cls, keyCache, logger);
 		if (cached?.key === null && cached.cached) {
 			const cachedUnavailable = await onCachedUnavailable(cacheKey, keyId, keyCache, logger);

package/dist/{http-DeuPW1Oh.cjs → http-Be6MS-3k.cjs}

@@ -11,7 +11,7 @@ let _opentelemetry_semantic_conventions = require("@opentelemetry/semantic-conve
 let byte_encodings_base64 = require("byte-encodings/base64");
 //#region deno.json
 var name = "@fedify/fedify";
-var version = "2.4.0-dev.1570+f1b6aaa3";
+var version = "2.4.0-dev.1571+31e2786b";
 //#endregion
 //#region src/sig/accept.ts
 /**
@@ -315,11 +315,11 @@ var FederationMetrics = class {
 			unit: "{change}"
 		});
 		this.keyLookup = meter.createCounter("activitypub.key.lookup", {
-			description: "Public-key lookup attempts performed by Fedify, including both cache hits and remote fetches.",
+			description: "Public-key lookup attempts performed by Fedify, including cache hits, local resolutions, and remote fetches.",
 			unit: "{lookup}"
 		});
 		this.keyLookupDuration = meter.createHistogram("activitypub.key.lookup.duration", {
-			description: "Duration of public-key lookups performed by Fedify, including any remote fetch.",
+			description: "Duration of public-key lookups performed by Fedify, including cache hits, local resolutions, and any remote fetch.",
 			unit: "ms",
 			advice: { explicitBucketBoundaries: [
 				5,
@@ -1150,16 +1150,22 @@ async function fetchKeyDetailed(keyId, cls, options = {}) {
 async function getCachedFetchKey(cacheKey, keyId, cls, keyCache, logger) {
 	if (keyCache == null) return null;
 	const cachedKey = await keyCache.get(cacheKey);
-	if (cachedKey instanceof cls && cachedKey.publicKey != null) {
-		logger.debug("Key {keyId} found in cache.", { keyId });
+	const hit = checkCachedKeyHit(cachedKey, keyId, cls, logger);
+	if (hit != null) return hit;
+	if (cachedKey === null) {
+		logger.debug("Entry {keyId} found in cache, but it is unavailable.", { keyId });
 		return {
-			key: cachedKey,
+			key: null,
 			cached: true
 		};
-	} else if (cachedKey === null) {
-		logger.debug("Entry {keyId} found in cache, but it is unavailable.", { keyId });
+	}
+	return null;
+}
+function checkCachedKeyHit(cachedKey, keyId, cls, logger) {
+	if (cachedKey instanceof cls && cachedKey.publicKey != null) {
+		logger.debug("Key {keyId} found in cache.", { keyId });
 		return {
-			key: null,
+			key: cachedKey,
 			cached: true
 		};
 	}
@@ -1168,6 +1174,61 @@ async function getCachedFetchKey(cacheKey, keyId, cls, keyCache, logger) {
 async function clearFetchErrorMetadata(keyId, keyCache) {
 	await keyCache?.setFetchError?.(keyId, null);
 }
+function isDidKeyUrl(keyId) {
+	return keyId.protocol === "did:" && keyId.pathname.startsWith("key:");
+}
+async function doRawKeysMatch(left, right) {
+	const [leftRaw, rightRaw] = await Promise.all([crypto.subtle.exportKey("raw", left), crypto.subtle.exportKey("raw", right)]);
+	if (leftRaw.byteLength !== rightRaw.byteLength) return false;
+	const leftBytes = new Uint8Array(leftRaw);
+	const rightBytes = new Uint8Array(rightRaw);
+	return leftBytes.every((byte, index) => byte === rightBytes[index]);
+}
+async function isCachedDidKeyValid(key, verificationMethod) {
+	try {
+		return key.id?.href === verificationMethod.id.href && key.controllerId?.href === verificationMethod.controller.href && await doRawKeysMatch(key.publicKey, verificationMethod.publicKey);
+	} catch {
+		return false;
+	}
+}
+async function resolveDidKey(cacheKey, cls, keyCache, logger) {
+	if (!isDidKeyUrl(cacheKey)) return null;
+	const keyId = cacheKey.href;
+	if (!(cls === _fedify_vocab.Multikey)) {
+		logger.debug("Failed to resolve did:key {keyId}; did:key verification methods are only supported as Multikey values.", { keyId });
+		return {
+			key: null,
+			cached: false
+		};
+	}
+	let verificationMethod;
+	try {
+		verificationMethod = await (0, _fedify_vocab_runtime.parseDidKeyVerificationMethod)(cacheKey);
+	} catch (error) {
+		logger.debug("Failed to resolve did:key verification method {keyId}: {error}", {
+			keyId,
+			error
+		});
+		return {
+			key: null,
+			cached: false
+		};
+	}
+	const hit = checkCachedKeyHit(await keyCache?.get(cacheKey), keyId, cls, logger);
+	if (hit?.key instanceof _fedify_vocab.Multikey && await isCachedDidKeyValid(hit.key, verificationMethod)) return hit;
+	const key = new _fedify_vocab.Multikey({
+		id: verificationMethod.id,
+		controller: verificationMethod.controller,
+		publicKey: verificationMethod.publicKey
+	});
+	await keyCache?.set(cacheKey, key);
+	await clearFetchErrorMetadata(cacheKey, keyCache);
+	logger.debug("Resolved did:key verification method {keyId}.", { keyId });
+	return {
+		key,
+		cached: false
+	};
+}
 async function resolveFetchedKey(document, cacheKey, keyId, cls, { documentLoader, contextLoader, keyCache, tracerProvider }, logger) {
 	let object;
 	try {
@@ -1282,6 +1343,11 @@ async function fetchKeyWithResult(cacheKey, cls, options, onCachedUnavailable, o
 		]);
 		const keyId = cacheKey.href;
 		const keyCache = options.keyCache;
+		const didKey = await resolveDidKey(cacheKey, cls, keyCache, logger);
+		if (didKey != null) {
+			outcome = { result: didKey.key == null ? "invalid" : didKey.cached ? "hit" : "fetched" };
+			return didKey;
+		}
 		const cached = await getCachedFetchKey(cacheKey, keyId, cls, keyCache, logger);
 		if (cached?.key === null && cached.cached) {
 			const cachedUnavailable = await onCachedUnavailable(cacheKey, keyId, keyCache, logger);

package/dist/{http-JdRPUYku.mjs → http-CuG4iKEH.mjs}

@@ -1,10 +1,10 @@
 import { Temporal } from "@js-temporal/polyfill";
 import "urlpattern-polyfill";
 globalThis.addEventListener = () => {};
-import { n as version, t as name } from "./deno-klNxGW7W.mjs";
-import { n as getDurationMs, r as getFederationMetrics, s as measureSignatureKeyFetch } from "./metrics-CLSPm4dZ.mjs";
+import { n as version, t as name } from "./deno-ColSXZB4.mjs";
+import { n as getDurationMs, r as getFederationMetrics, s as measureSignatureKeyFetch } from "./metrics-C60MEuIn.mjs";
 import { i as validateAcceptSignature, n as fulfillAcceptSignature, r as parseAcceptSignature } from "./accept-CgDcxvjV.mjs";
-import { o as validateCryptoKey, r as fetchKeyDetailed } from "./key-o0_ipvUR.mjs";
+import { o as validateCryptoKey, r as fetchKeyDetailed } from "./key-C5fRM_21.mjs";
 import { getLogger } from "@logtape/logtape";
 import { CryptographicKey } from "@fedify/vocab";
 import { SpanStatusCode, trace } from "@opentelemetry/api";