@fedify/fedify 2.4.0-pr.936.41 → 2.5.0-dev.2271

package/dist/federation/portable-gateway-keys.test.d.mts

@@ -0,0 +1,2 @@
+import { Temporal } from "temporal-polyfill";
+import { URLPattern } from "urlpattern-polyfill";

package/dist/federation/portable-gateway-keys.test.mjs

@@ -0,0 +1,686 @@
+import { Temporal } from "temporal-polyfill";
+import "urlpattern-polyfill";
+globalThis.addEventListener = () => {};
+import { t as esm_default } from "../esm-BHXXx4Wx.mjs";
+import { r as createRequestContext, t as createInboxContext } from "../context-8Tu9kea0.mjs";
+import { t as MemoryKvStore } from "../kv-DCHkaJ9-.mjs";
+import { t as assertEquals } from "../assert_equals-Z6IcEbWU.mjs";
+import "../std__assert-DvMDRPes.mjs";
+import { t as assertRejects } from "../assert_rejects-CTptdYck.mjs";
+import { r as getVerifiedKeyOwnerEvidence } from "../key-owner-evidence-APB6NpSk.mjs";
+import { p as signJsonLd } from "../ld-CzaP-hJl.mjs";
+import { f as verifyRequest, l as signRequest, p as verifyRequestDetailed } from "../http-siciWkmx.mjs";
+import { a as rsaPrivateKey3, i as rsaPrivateKey2, n as ed25519PrivateKey, r as ed25519PublicKey, s as rsaPublicKey2 } from "../keys-DIJNHW-Y.mjs";
+import { f as handleInbox, n as FederationImpl, o as createFederation } from "../middleware-D7_LO-Vs.mjs";
+import { n as getKeyOwner, t as doesActorOwnKey } from "../owner-DYgfTFHy.mjs";
+import { t as ActivityListenerSet } from "../activity-listener-C-BSbKI7.mjs";
+import { t as KvKeyCache } from "../keycache-Da8A8mZa.mjs";
+import { Create, CryptographicKey, Person } from "@fedify/vocab";
+import { FetchError, encodeMultibase, exportDidKey, parseIri } from "@fedify/vocab-runtime";
+import { mockDocumentLoader, test } from "@fedify/fixture";
+import serialize from "json-canon";
+//#region src/federation/portable-gateway-keys.test.ts
+const did = await exportDidKey(ed25519PublicKey.publicKey);
+const didKeyId = new URL(`${did}#${did.slice(8)}`);
+const actorId = parseIri(`ap+ef61://${did}/actors/alice`);
+const gateway = "https://example.com";
+const otherGateway = "https://other.example";
+const compatibleActorId = (origin) => `${origin}/.well-known/apgateway/${did}/actors/alice`;
+const gatewayKeyId = new URL(`${compatibleActorId(gateway)}#main-key`);
+const ed25519GatewayKeyPair = await crypto.subtle.generateKey("Ed25519", true, ["sign", "verify"]);
+const rsaGatewayKeyPair = {
+	privateKey: rsaPrivateKey2,
+	publicKey: rsaPublicKey2.publicKey
+};
+const portableContext = [
+	"https://www.w3.org/ns/activitystreams",
+	"https://w3id.org/security/data-integrity/v1",
+	"https://w3id.org/fep/ef61"
+];
+const recipient = {
+	id: new URL("https://example.com/users/bob"),
+	inboxId: new URL("https://example.com/inbox")
+};
+async function sign(document) {
+	const proofConfig = {
+		"@context": document["@context"],
+		type: "DataIntegrityProof",
+		cryptosuite: "eddsa-jcs-2022",
+		verificationMethod: didKeyId.href,
+		proofPurpose: "assertionMethod",
+		created: "2023-02-24T23:36:38Z"
+	};
+	const encoder = new TextEncoder();
+	const digest = /* @__PURE__ */ new Uint8Array(64);
+	digest.set(new Uint8Array(await crypto.subtle.digest("SHA-256", encoder.encode(serialize(proofConfig)))), 0);
+	digest.set(new Uint8Array(await crypto.subtle.digest("SHA-256", encoder.encode(serialize(document)))), 32);
+	const signature = await crypto.subtle.sign("Ed25519", ed25519PrivateKey, digest);
+	return {
+		...document,
+		proof: {
+			...proofConfig,
+			proofValue: new TextDecoder().decode(encodeMultibase("base58btc", new Uint8Array(signature)))
+		}
+	};
+}
+function createTestFederation(mapper) {
+	const federation = new FederationImpl({
+		kv: new MemoryKvStore(),
+		manuallyStartQueue: true,
+		contextLoaderFactory: () => mockDocumentLoader,
+		documentLoaderFactory: () => mockDocumentLoader
+	});
+	const setters = federation.setActorDispatcher("/users/{identifier}", () => null).setKeyPairsDispatcher(() => [rsaGatewayKeyPair, ed25519GatewayKeyPair]);
+	if (mapper != null) setters.mapPortableActorId((_ctx, id) => mapper(id));
+	return federation;
+}
+function portableCreate(id = "1") {
+	return new Create({
+		id: parseIri(`ap+ef61://${did}/activities/${id}`),
+		actor: actorId,
+		object: new URL("https://example.com/notes/1")
+	});
+}
+async function signedPortableCreate(id = "1") {
+	const json = await portableCreate(id).toJsonLd({
+		format: "compact",
+		context: portableContext,
+		contextLoader: mockDocumentLoader
+	});
+	return await Create.fromJsonLd(await sign(json), {
+		contextLoader: mockDocumentLoader,
+		documentLoader: mockDocumentLoader
+	});
+}
+async function capture(run) {
+	const bodies = [];
+	const requests = [];
+	esm_default.spyGlobal();
+	try {
+		esm_default.post(recipient.inboxId.href, async (cl) => {
+			const body = await cl.request.text();
+			requests.push(new Request(cl.request.url, {
+				method: cl.request.method,
+				headers: cl.request.headers,
+				body
+			}));
+			bodies.push(JSON.parse(body));
+			return new Response(null, { status: 202 });
+		});
+		await run();
+	} finally {
+		esm_default.hardReset();
+	}
+	return {
+		bodies,
+		requests
+	};
+}
+function signatureKeyId(request) {
+	return request.headers.get("Signature-Input")?.match(/keyid="([^"]+)"/)?.[1] ?? request.headers.get("Signature")?.match(/keyId="([^"]+)"/)?.[1];
+}
+test("Context.getActorKeyPairs() derives gateway keys for portable actors", async () => {
+	const ctx = createTestFederation((id) => id === "alice" ? actorId : null).createContext(new URL(gateway));
+	const keys = await ctx.getActorKeyPairs("alice");
+	assertEquals(keys.map((k) => k.keyId.href), [gatewayKeyId.href, `${compatibleActorId(gateway)}#key-2`]);
+	for (const key of keys) {
+		assertEquals(key.cryptographicKey.id?.href, key.keyId.href);
+		assertEquals(key.cryptographicKey.ownerId?.href, actorId.href);
+		assertEquals(key.multikey.id?.href, key.keyId.href);
+		assertEquals(key.multikey.controllerId?.href, actorId.href);
+	}
+	assertEquals((await ctx.getActorKeyPairs("bob")).map((k) => [k.keyId.href, k.multikey.id?.href]), [["https://example.com/users/bob#main-key", "https://example.com/users/bob#multikey-1"], ["https://example.com/users/bob#key-2", "https://example.com/users/bob#multikey-2"]]);
+	const json = await new Person({
+		id: actorId,
+		gateways: [new URL(gateway)],
+		publicKey: keys[0].cryptographicKey,
+		assertionMethods: keys.map((k) => k.multikey)
+	}).toJsonLd({
+		format: "compact",
+		contextLoader: mockDocumentLoader
+	});
+	const assertionMethod = json.assertionMethod;
+	assertEquals(assertionMethod.map((k) => [k.id, k.controller]), [[gatewayKeyId.href, `ap+ef61://${did}/actors/alice`], [`${compatibleActorId(gateway)}#key-2`, `ap+ef61://${did}/actors/alice`]]);
+	assertEquals(json.publicKey.id, gatewayKeyId.href);
+});
+test("Context.getActorKeyPairs() accepts compatible IDs as portable actor IDs", async () => {
+	const published = new URL(compatibleActorId(otherGateway));
+	const [key] = await createTestFederation(() => published).createContext(new URL(gateway)).getActorKeyPairs("alice");
+	assertEquals(key.keyId.href, gatewayKeyId.href);
+	assertEquals(key.cryptographicKey.ownerId?.href, published.href);
+});
+test("Context.getActorKeyPairs() propagates portable actor ID mapper errors", async () => {
+	for (const id of [new URL(`${actorId.href}#me`), new URL("https://example.com/users/alice")]) {
+		const ctx = createTestFederation(() => id).createContext(new URL(gateway));
+		await assertRejects(() => ctx.getActorKeyPairs("alice"), TypeError);
+	}
+	const ctx = createTestFederation(() => {
+		throw new RangeError("mapper failed");
+	}).createContext(new URL(gateway));
+	await assertRejects(() => ctx.getActorKeyPairs("alice"), RangeError);
+	const federation = new FederationImpl({ kv: new MemoryKvStore() });
+	federation.setActorDispatcher("/users/{identifier}", () => null).setKeyPairsDispatcher(() => {
+		throw new Error("dispatcher failed");
+	}).mapPortableActorId(() => actorId);
+	assertEquals(await federation.createContext(new URL(gateway)).getActorKeyPairs("alice"), []);
+});
+test("Context.sendActivity() signs requests with gateway keys for portable actors", async () => {
+	const ctx = createTestFederation(() => actorId).createContext(new URL(gateway));
+	const activity = await signedPortableCreate();
+	const { bodies, requests } = await capture(() => ctx.sendActivity({ identifier: "alice" }, recipient, activity));
+	assertEquals(bodies.length, 1);
+	assertEquals(signatureKeyId(requests[0]), gatewayKeyId.href);
+	const proof = bodies[0].proof;
+	assertEquals(Array.isArray(proof), false);
+	assertEquals(proof.verificationMethod, didKeyId.href);
+	assertEquals(bodies[0].signature, void 0);
+});
+test("Context.sendActivity() refuses portable activities gateway keys would sign", async () => {
+	const ctx = createTestFederation(() => actorId).createContext(new URL(gateway));
+	await assertRejects(() => ctx.sendActivity({ identifier: "alice" }, recipient, portableCreate()), TypeError);
+	const httpActivity = new Create({
+		id: new URL("https://example.com/activities/1"),
+		actor: actorId,
+		object: new URL("https://example.com/notes/1")
+	});
+	await assertRejects(() => ctx.sendActivity({ identifier: "alice" }, recipient, httpActivity), TypeError);
+	await assertRejects(() => ctx.sendActivity({
+		keyId: new URL("https://example.com/key"),
+		privateKey: ed25519PrivateKey
+	}, recipient, portableCreate()), TypeError);
+	const { bodies } = await capture(() => ctx.sendActivity([{
+		keyId: gatewayKeyId,
+		privateKey: rsaPrivateKey2
+	}, {
+		keyId: didKeyId,
+		privateKey: ed25519PrivateKey
+	}], recipient, portableCreate()));
+	assertEquals(bodies[0].proof.verificationMethod, didKeyId.href);
+});
+test("Context.sendActivity() never signs documents with gateway keys", async () => {
+	const ctx = createTestFederation().createContext(new URL(gateway));
+	const keys = [{
+		keyId: gatewayKeyId,
+		privateKey: rsaPrivateKey2
+	}, {
+		keyId: new URL(`${compatibleActorId(gateway)}#key-2`),
+		privateKey: ed25519GatewayKeyPair.privateKey
+	}];
+	const activity = new Create({
+		id: new URL("https://example.com/activities/1"),
+		actor: new URL("https://example.com/users/bob"),
+		object: new URL("https://example.com/notes/1")
+	});
+	const { bodies, requests } = await capture(() => ctx.sendActivity(keys, recipient, activity));
+	assertEquals(signatureKeyId(requests[0]), gatewayKeyId.href);
+	assertEquals(bodies[0].proof, void 0);
+	assertEquals(bodies[0].signature, void 0);
+});
+test("Context.sendActivity() never signs documents with keys at ap: URIs", async () => {
+	const ctx = createTestFederation().createContext(new URL(gateway));
+	const keys = [{
+		keyId: parseIri(`${actorId.href}#main-key`),
+		privateKey: rsaPrivateKey2
+	}, {
+		keyId: parseIri(`${actorId.href}#key-2`),
+		privateKey: ed25519GatewayKeyPair.privateKey
+	}];
+	const activity = new Create({
+		id: new URL("https://example.com/activities/1"),
+		actor: new URL("https://example.com/users/bob"),
+		object: new URL("https://example.com/notes/1")
+	});
+	const { bodies } = await capture(() => ctx.sendActivity(keys, recipient, activity));
+	assertEquals(bodies[0].proof, void 0);
+	assertEquals(bodies[0].signature, void 0);
+});
+test("Context.getDocumentLoader() signs requests with gateway keys for portable actors", async () => {
+	const documentLoader = await createTestFederation(() => actorId).createContext(new URL(gateway)).getDocumentLoader({ identifier: "alice" });
+	let keyId;
+	esm_default.spyGlobal();
+	try {
+		esm_default.get("https://example.com/notes/1", (cl) => {
+			keyId = signatureKeyId(cl.request);
+			return new Response(JSON.stringify({ id: cl.request.url }), { headers: { "Content-Type": "application/activity+json" } });
+		});
+		await documentLoader("https://example.com/notes/1");
+	} finally {
+		esm_default.hardReset();
+	}
+	assertEquals(keyId, gatewayKeyId.href);
+});
+async function actorDocument(gateways, id = actorId, signed = true) {
+	const keys = await createTestFederation(() => id).createContext(new URL(gateway)).getActorKeyPairs("alice");
+	const json = await new Person({
+		id,
+		inbox: parseIri(`${id.href}/inbox`),
+		gateways: gateways.map((g) => new URL(g)),
+		publicKey: keys[0].cryptographicKey,
+		assertionMethods: keys.map((k) => k.multikey)
+	}).toJsonLd({
+		format: "compact",
+		contextLoader: mockDocumentLoader
+	});
+	json["@context"] = [...json["@context"], "https://w3id.org/security/data-integrity/v1"];
+	return signed ? await sign(json) : json;
+}
+function createLoader(responses) {
+	return (url) => {
+		const document = responses[url.replace(/#.*$/, "")];
+		if (document == null) return mockDocumentLoader(url);
+		return Promise.resolve({
+			contextUrl: null,
+			documentUrl: url,
+			document: structuredClone(document)
+		});
+	};
+}
+async function deliver(body, gateways, { kv = new MemoryKvStore(), httpSignature = true, actor, documentLoader, keyId = gatewayKeyId } = {}) {
+	documentLoader ??= createLoader({ [compatibleActorId(gateway)]: actor ?? await actorDocument(gateways) });
+	const unsigned = new Request("https://local.example/inbox", {
+		method: "POST",
+		body: JSON.stringify(body),
+		headers: { "Content-Type": "application/activity+json" }
+	});
+	const request = httpSignature ? await signRequest(unsigned, rsaPrivateKey2, keyId) : unsigned;
+	const context = createRequestContext({
+		federation: createFederation({ kv: new MemoryKvStore() }),
+		request,
+		url: new URL(request.url),
+		data: void 0,
+		documentLoader,
+		contextLoader: mockDocumentLoader
+	});
+	let dispatched = 0;
+	const inboxListeners = new ActivityListenerSet();
+	inboxListeners.add(Create, () => {
+		dispatched++;
+	});
+	const response = await handleInbox(request, {
+		recipient: null,
+		context,
+		inboxContextFactory() {
+			return createInboxContext({
+				...context,
+				clone: void 0
+			});
+		},
+		kv,
+		kvPrefixes: {
+			activityIdempotence: ["_fedify", "activityIdempotence"],
+			publicKey: ["_fedify", "publicKey"],
+			acceptSignatureNonce: ["_fedify", "acceptSignatureNonce"]
+		},
+		actorDispatcher() {
+			return null;
+		},
+		inboxListeners,
+		onNotFound() {
+			return new Response("Not found", { status: 404 });
+		},
+		signatureTimeWindow: { minutes: 5 },
+		skipSignatureVerification: false
+	});
+	lastResponseText = await response.text();
+	return {
+		status: response.status,
+		dispatched
+	};
+}
+let lastResponseText = "";
+async function createJson(id) {
+	return await portableCreate(id).toJsonLd({
+		format: "compact",
+		context: portableContext,
+		contextLoader: mockDocumentLoader
+	});
+}
+test("handleInbox() requires proofs of portable actors despite gateway signatures", async () => {
+	assertEquals(await deliver(await createJson("unsigned"), [gateway]), {
+		status: 401,
+		dispatched: 0
+	});
+	assertEquals(await deliver({
+		...await sign(await createJson("tampered")),
+		object: "https://remote.example/notes/2"
+	}, [gateway]), {
+		status: 401,
+		dispatched: 0
+	});
+	assertEquals(await deliver(await sign(await createJson("signed")), [gateway]), {
+		status: 202,
+		dispatched: 1
+	});
+});
+const apKeyId = parseIri(`${actorId.href}?@gateway=${encodeURIComponent(gateway)}#main-key`);
+async function apActorDocument() {
+	const json = await new Person({
+		id: actorId,
+		inbox: parseIri(`${actorId.href}/inbox`),
+		gateways: [new URL(gateway)],
+		publicKey: new CryptographicKey({
+			id: parseIri(`${actorId.href}#main-key`),
+			owner: actorId,
+			publicKey: rsaPublicKey2.publicKey
+		})
+	}).toJsonLd({
+		format: "compact",
+		contextLoader: mockDocumentLoader
+	});
+	json["@context"] = [...json["@context"], "https://w3id.org/security/data-integrity/v1"];
+	return await sign(json);
+}
+test("handleInbox() requires proofs of portable actors despite signatures with keys at ap: key IDs", async () => {
+	const fetched = [];
+	const inner = createLoader({ [compatibleActorId(gateway)]: await apActorDocument() });
+	const documentLoader = (url, options) => {
+		fetched.push(url);
+		return inner(url, options);
+	};
+	assertEquals(await deliver(await createJson("unsigned"), [gateway], {
+		documentLoader,
+		keyId: apKeyId
+	}), {
+		status: 401,
+		dispatched: 0
+	});
+	assertEquals(fetched.some((url) => url.startsWith(compatibleActorId(gateway))), true);
+	assertEquals(await deliver(await sign(await createJson("signed")), [gateway], {
+		documentLoader,
+		keyId: apKeyId
+	}), {
+		status: 202,
+		dispatched: 1
+	});
+});
+test("RequestContext.getSignedKeyOwner() resolves keys at ap: key IDs", async () => {
+	const documentLoader = createLoader({ [compatibleActorId(gateway)]: await apActorDocument() });
+	const federation = new FederationImpl({
+		kv: new MemoryKvStore(),
+		contextLoaderFactory: () => mockDocumentLoader,
+		documentLoaderFactory: () => documentLoader
+	});
+	const request = await signRequest(new Request("https://local.example/notes/1", { headers: { Accept: "application/activity+json" } }), rsaPrivateKey2, apKeyId);
+	const ctx = federation.createContext(request, void 0);
+	assertEquals((await ctx.getSignedKey())?.id?.href, apKeyId.href);
+	assertEquals((await ctx.getSignedKeyOwner())?.id?.href, actorId.href);
+});
+test("handleInbox() fetches an unreachable gateway key once", async () => {
+	const fetched = [];
+	const documentLoader = (url) => {
+		if (url.replace(/#.*$/, "") !== compatibleActorId(gateway)) return mockDocumentLoader(url);
+		fetched.push(url);
+		return Promise.reject(new FetchError(url, "HTTP 503", new Response(null, { status: 503 })));
+	};
+	const kv = new MemoryKvStore();
+	for (let i = 0; i < 3; i++) {
+		const { status } = await deliver(await createJson(`unreachable-${i}`), [gateway], {
+			kv,
+			documentLoader
+		});
+		assertEquals(status, 401);
+	}
+	assertEquals(fetched.length, 1);
+});
+test("handleInbox() does not need gateway signatures for portable actors", async () => {
+	assertEquals(await deliver(await sign(await createJson("signed")), [otherGateway]), {
+		status: 202,
+		dispatched: 1
+	});
+	assertEquals(await deliver(await createJson("unsigned"), [otherGateway]), {
+		status: 401,
+		dispatched: 0
+	});
+});
+test("handleInbox() does not take Linked Data Signatures for portable actors", async () => {
+	const kv = new MemoryKvStore();
+	await new KvKeyCache(kv, ["_fedify", "publicKey"]).set(rsaPublicKey2.id, new CryptographicKey({
+		id: rsaPublicKey2.id,
+		owner: actorId,
+		publicKey: rsaPublicKey2.publicKey
+	}));
+	const ldSign = (document) => signJsonLd(document, rsaPrivateKey2, rsaPublicKey2.id, { contextLoader: mockDocumentLoader });
+	assertEquals(await deliver(await ldSign(await createJson("ld-only")), [gateway], {
+		kv,
+		httpSignature: false
+	}), {
+		status: 401,
+		dispatched: 0
+	});
+	assertEquals(lastResponseText, "Failed to verify the request signature.");
+});
+const otherDid = await exportDidKey((await crypto.subtle.generateKey("Ed25519", true, ["sign", "verify"])).publicKey);
+function compatibleCreateJson(id, activityDid = did) {
+	return {
+		"@context": portableContext,
+		id: `${gateway}/.well-known/apgateway/${activityDid}/activities/${id}`,
+		type: "Create",
+		actor: compatibleActorId(gateway),
+		object: "https://example.com/notes/1"
+	};
+}
+test("handleInbox() does not trust compatible-ID actors by web origin", async () => {
+	const id = new URL(compatibleActorId(gateway));
+	for (const signed of [true, false]) {
+		const actor = await actorDocument([gateway], id, signed);
+		assertEquals(await deliver(compatibleCreateJson(`unsigned-${signed}`), [gateway], { actor }), {
+			status: 401,
+			dispatched: 0
+		}, `actor document signed: ${signed}`);
+	}
+	assertEquals(await deliver(await sign(compatibleCreateJson("signed")), [gateway], { actor: await actorDocument([gateway], id) }), {
+		status: 202,
+		dispatched: 1
+	});
+});
+test("handleInbox() requires proofs of compatible-ID actors", async () => {
+	assertEquals(await deliver(compatibleCreateJson("unsigned"), [gateway]), {
+		status: 401,
+		dispatched: 0
+	});
+	assertEquals(await deliver(await sign(compatibleCreateJson("signed")), [gateway]), {
+		status: 202,
+		dispatched: 1
+	});
+	assertEquals(await deliver(await sign(compatibleCreateJson("unsigned-request")), [gateway], { httpSignature: false }), {
+		status: 202,
+		dispatched: 1
+	});
+});
+test("handleInbox() checks the DIDs of compatible activity IDs", async () => {
+	for (const actor of [actorId.href, compatibleActorId(gateway)]) assertEquals(await deliver(await sign({
+		...compatibleCreateJson("forged", otherDid),
+		actor
+	}), [gateway]), {
+		status: 401,
+		dispatched: 0
+	}, actor);
+	assertEquals(await deliver(await sign({
+		...compatibleCreateJson("forged-ap"),
+		id: `ap://${otherDid}/activities/forged-ap`
+	}), [gateway]), {
+		status: 401,
+		dispatched: 0
+	});
+	assertEquals(await deliver(await sign({
+		...compatibleCreateJson("malformed"),
+		id: `https://user@example.com/.well-known/apgateway/${did}/activities/2`
+	}), [gateway]), {
+		status: 401,
+		dispatched: 0
+	});
+});
+function countingLoader(responses) {
+	const inner = createLoader(responses);
+	let count = 0;
+	return {
+		documentLoader(url, options) {
+			if (url.replace(/#.*$/, "") === compatibleActorId(gateway)) count++;
+			return inner(url, options);
+		},
+		fetched: () => count
+	};
+}
+async function signedRequest(keyId = gatewayKeyId, privateKey = rsaPrivateKey2, spec) {
+	return await signRequest(new Request("https://local.example/notes/1", { headers: { Accept: "application/activity+json" } }), privateKey, keyId, spec == null ? {} : { spec });
+}
+test("handleInbox() fetches the actor of a gateway key once", async () => {
+	for (const [keyId, actor] of [[gatewayKeyId, await actorDocument([gateway])], [apKeyId, await apActorDocument()]]) {
+		const { documentLoader, fetched } = countingLoader({ [compatibleActorId(gateway)]: actor });
+		const kv = new MemoryKvStore();
+		for (let i = 0; i < 2; i++) {
+			assertEquals(await deliver(await createJson(`once-${i}`), [gateway], {
+				kv,
+				documentLoader,
+				keyId
+			}), {
+				status: 401,
+				dispatched: 0
+			});
+			assertEquals(fetched(), 1);
+		}
+	}
+});
+test("RequestContext.getSignedKeyOwner() does not fetch the actor of a gateway key again", async () => {
+	for (const [keyId, actor, gateways] of [[
+		gatewayKeyId,
+		await actorDocument([gateway, otherGateway]),
+		[`${gateway}/`, `${otherGateway}/`]
+	], [
+		apKeyId,
+		await apActorDocument(),
+		[`${gateway}/`]
+	]]) {
+		const { documentLoader, fetched } = countingLoader({ [compatibleActorId(gateway)]: actor });
+		const ctx = new FederationImpl({
+			kv: new MemoryKvStore(),
+			contextLoaderFactory: () => mockDocumentLoader,
+			documentLoaderFactory: () => documentLoader
+		}).createContext(await signedRequest(keyId), void 0);
+		assertEquals((await ctx.getSignedKey())?.id?.href, keyId.href);
+		assertEquals(fetched(), 1);
+		const owner = await ctx.getSignedKeyOwner();
+		assertEquals(owner?.id?.href, actorId.href);
+		assertEquals(owner?.gateways.map((g) => g.href), [...gateways]);
+		assertEquals(fetched(), 1);
+	}
+});
+test("getKeyOwner() reuses the actor of a cached gateway key", async () => {
+	for (const spec of [void 0, "rfc9421"]) {
+		const { documentLoader, fetched } = countingLoader({ [compatibleActorId(gateway)]: await actorDocument([gateway]) });
+		const options = {
+			documentLoader,
+			contextLoader: mockDocumentLoader,
+			keyCache: new KvKeyCache(new MemoryKvStore(), ["pk"])
+		};
+		const fresh = await verifyRequest(await signedRequest(gatewayKeyId, rsaPrivateKey2, spec), options);
+		const cached = await verifyRequest(await signedRequest(gatewayKeyId, rsaPrivateKey2, spec), options);
+		assertEquals(fetched(), 1);
+		for (const key of [fresh, cached]) assertEquals((await getKeyOwner(key, options))?.id?.href, actorId.href);
+		assertEquals(fetched(), 1);
+	}
+});
+test("doesActorOwnKey() checks the actor of a verified gateway key without fetching", async () => {
+	const { documentLoader, fetched } = countingLoader({ [compatibleActorId(gateway)]: await actorDocument([gateway]) });
+	const options = {
+		documentLoader,
+		contextLoader: mockDocumentLoader
+	};
+	const key = await verifyRequest(await signedRequest(), options);
+	assertEquals(fetched(), 1);
+	assertEquals(await doesActorOwnKey(portableCreate(), key, options), true);
+	assertEquals(await doesActorOwnKey(new Create({
+		id: parseIri(`ap+ef61://${otherDid}/activities/1`),
+		actor: parseIri(`ap+ef61://${otherDid}/actors/alice`)
+	}), key, options), false);
+	assertEquals(fetched(), 1);
+});
+test("doesActorOwnKey() and getKeyOwner() fully check other gateway keys", async () => {
+	const { documentLoader, fetched } = countingLoader({ [compatibleActorId(gateway)]: await actorDocument([gateway]) });
+	const options = {
+		documentLoader,
+		contextLoader: mockDocumentLoader
+	};
+	const verified = await verifyRequest(await signedRequest(), options);
+	assertEquals(fetched(), 1);
+	const others = [new CryptographicKey({
+		id: gatewayKeyId,
+		owner: actorId,
+		publicKey: rsaPublicKey2.publicKey
+	}), verified.clone({})];
+	let expected = 1;
+	for (const key of others) {
+		assertEquals(await doesActorOwnKey(portableCreate(), key, options), true);
+		assertEquals(fetched(), ++expected);
+		assertEquals((await getKeyOwner(key, options))?.id?.href, actorId.href);
+		assertEquals(fetched(), ++expected);
+	}
+	const mutated = await verifyRequest(await signedRequest(), options);
+	mutated.ownerId.href = parseIri(`ap+ef61://${otherDid}/actors/alice`).href;
+	assertEquals(getVerifiedKeyOwnerEvidence(mutated), void 0);
+});
+test("verifyRequest() does not vouch for the owners of keys that fail to verify signatures", async () => {
+	const documentLoader = createLoader({ [compatibleActorId(gateway)]: await actorDocument([gateway]) });
+	const cachedKeys = [];
+	const keyCache = new class extends KvKeyCache {
+		compatibleKeyScope(scope) {
+			const scoped = super.compatibleKeyScope(scope);
+			return {
+				...scoped,
+				set(keyId, key, options) {
+					if (key instanceof CryptographicKey) cachedKeys.push(key);
+					return scoped.set(keyId, key, options);
+				}
+			};
+		}
+	}(new MemoryKvStore(), ["pk"]);
+	assertEquals((await verifyRequestDetailed(await signedRequest(gatewayKeyId, rsaPrivateKey3), {
+		documentLoader,
+		contextLoader: mockDocumentLoader,
+		keyCache
+	})).verified, false);
+	assertEquals(cachedKeys.length, 1);
+	assertEquals(getVerifiedKeyOwnerEvidence(cachedKeys[0]), void 0);
+});
+test("doesActorOwnKey() fully checks cached gateway keys cached without their actors", async () => {
+	const { documentLoader, fetched } = countingLoader({ [compatibleActorId(gateway)]: await actorDocument([gateway]) });
+	const kv = new MemoryKvStore();
+	const options = {
+		documentLoader,
+		contextLoader: mockDocumentLoader,
+		keyCache: new KvKeyCache(kv, ["pk"])
+	};
+	await verifyRequest(await signedRequest(), options);
+	assertEquals(fetched(), 1);
+	const entryKey = [
+		"pk",
+		"__compatible",
+		"httpSignature",
+		gatewayKeyId.href
+	];
+	const { owner: _, ...entry } = await kv.get(entryKey) ?? {};
+	await kv.set(entryKey, entry);
+	const key = await verifyRequest(await signedRequest(), options);
+	assertEquals(fetched(), 1);
+	assertEquals(getVerifiedKeyOwnerEvidence(key), void 0);
+	assertEquals(await doesActorOwnKey(portableCreate(), key, options), true);
+	assertEquals(fetched(), 2);
+});
+test("Owners of verified gateway keys expire with their cache entries", async () => {
+	const documentLoader = createLoader({ [compatibleActorId(gateway)]: await actorDocument([gateway]) });
+	const now = Temporal.Now.instant();
+	const keyCache = new KvKeyCache(new MemoryKvStore(), ["pk"], {
+		keyTtl: Temporal.Duration.from({ minutes: 5 }),
+		now: () => now
+	});
+	const key = await verifyRequest(await signedRequest(), {
+		documentLoader,
+		contextLoader: mockDocumentLoader,
+		keyCache
+	});
+	const deadline = now.add({ minutes: 5 });
+	assertEquals(getVerifiedKeyOwnerEvidence(key, deadline.subtract({ seconds: 1 }))?.expires, deadline);
+	assertEquals(getVerifiedKeyOwnerEvidence(key, deadline), void 0);
+});
+//#endregion
+export {};

package/dist/federation/portable-inbox.test.d.mts

@@ -0,0 +1,2 @@
+import { Temporal } from "temporal-polyfill";
+import { URLPattern } from "urlpattern-polyfill";