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

package/dist/federation/portable-inbox.test.mjs

@@ -0,0 +1,1535 @@
+import { Temporal } from "temporal-polyfill";
+import "urlpattern-polyfill";
+globalThis.addEventListener = () => {};
+import { t as esm_default } from "../esm-BHXXx4Wx.mjs";
+import { t as MemoryKvStore } from "../kv-DCHkaJ9-.mjs";
+import { t as assertEquals } from "../assert_equals-Z6IcEbWU.mjs";
+import { t as assertFalse } from "../assert_false-CPdRnc3E.mjs";
+import { t as assertThrows } from "../assert_throws-BYITOvPO.mjs";
+import "../std__assert-DvMDRPes.mjs";
+import { t as assert } from "../assert-D1Eafmd_.mjs";
+import { p as signJsonLd } from "../ld-CzaP-hJl.mjs";
+import { a as signObject } from "../proof-Dxy6ByqI.mjs";
+import { l as signRequest, p as verifyRequestDetailed } from "../http-siciWkmx.mjs";
+import { a as rsaPrivateKey3, c as rsaPublicKey3, i as rsaPrivateKey2, n as ed25519PrivateKey, r as ed25519PublicKey, s as rsaPublicKey2 } from "../keys-DIJNHW-Y.mjs";
+import { _ as coversDelivery, o as createFederation, v as forwardPortableInboxActivity, y as resolvePortableInboxForwardingOptions } from "../middleware-D7_LO-Vs.mjs";
+import { Create, CryptographicKey, Follow, Note, Person, Tombstone } from "@fedify/vocab";
+import { exportDidKey, formatIri, parseIri } from "@fedify/vocab-runtime";
+import { mockDocumentLoader, test } from "@fedify/fixture";
+import { encodeBase64 } from "byte-encodings/base64";
+//#region src/federation/portable-inbox.test.ts
+const did = await exportDidKey(ed25519PublicKey.publicKey);
+const keyId = new URL(`${did}#${did.substring(8)}`);
+const otherKeyPair = await crypto.subtle.generateKey("Ed25519", true, ["sign", "verify"]);
+const otherDid = await exportDidKey(otherKeyPair.publicKey);
+const LOCAL = "https://example.com";
+const GATEWAY2 = "https://example.org";
+const GATEWAY3 = "https://example.net";
+function inboxUrl(authority = did, path = "/users/alice/inbox", origin = LOCAL) {
+	return `${origin}/.well-known/apgateway/${authority}${path}`;
+}
+function post(url, body, headers = {}) {
+	return new Request(url, {
+		method: "POST",
+		headers: {
+			"Content-Type": "application/activity+json",
+			...headers
+		},
+		body: JSON.stringify(body)
+	});
+}
+var RecordingQueue = class {
+	messages = [];
+	failFor;
+	enqueue(message) {
+		if (this.failFor != null && message.type === "outbox" && message.inbox.startsWith(this.failFor)) return Promise.reject(/* @__PURE__ */ new Error("Enqueue failed."));
+		this.messages.push(message);
+		return Promise.resolve();
+	}
+	listen() {
+		return Promise.resolve();
+	}
+	get outbox() {
+		return this.messages.filter((m) => m.type === "outbox");
+	}
+};
+function setup({ gateways = [
+	LOCAL,
+	GATEWAY2,
+	GATEWAY3
+], kv = new MemoryKvStore(), queue, options = {}, actor, listenerError = false, keyPairs = true, aliceKeyPairs = [], mapPortableActorId, onSharedInboxKey } = {}) {
+	const federation = createFederation({
+		kv,
+		...options.allowPrivateAddress ? {} : {
+			documentLoaderFactory: () => mockDocumentLoader,
+			contextLoaderFactory: () => mockDocumentLoader
+		},
+		manuallyStartQueue: true,
+		...queue == null ? {} : { queue: { outbox: queue } },
+		...options
+	});
+	const received = [];
+	const actorCallbacks = federation.setActorDispatcher("/users/{identifier}", actor ?? ((ctx, identifier) => {
+		if (identifier === "ordinary") return new Person({
+			id: ctx.getActorUri(identifier),
+			inbox: ctx.getInboxUri(identifier)
+		});
+		if (identifier !== "alice") return null;
+		return new Person({
+			id: parseIri(`ap+ef61://${did}/users/alice`),
+			inbox: ctx.getPortableInboxUri(identifier, did),
+			gateways: gateways.map((g) => new URL(g))
+		});
+	}));
+	if (keyPairs) actorCallbacks.setKeyPairsDispatcher((_ctx, identifier) => identifier === "ordinary" ? [{
+		privateKey: rsaPrivateKey2,
+		publicKey: rsaPublicKey2.publicKey
+	}] : identifier === "alice" ? aliceKeyPairs : []);
+	if (mapPortableActorId != null) actorCallbacks.mapPortableActorId((_ctx, identifier) => mapPortableActorId(identifier));
+	const reports = [];
+	const inboxListeners = federation.setInboxListeners("/users/{identifier}/inbox", "/inbox").onRequestFinished((_ctx, report) => {
+		reports.push(report);
+	});
+	if (onSharedInboxKey != null) inboxListeners.setSharedKeyDispatcher(() => {
+		onSharedInboxKey();
+		return null;
+	});
+	inboxListeners.on(Follow, (ctx, activity) => {
+		received.push({
+			activity,
+			recipient: ctx.recipient
+		});
+		if (listenerError) throw new Error("Listener failed.");
+	}).on(Create, (ctx, activity) => {
+		received.push({
+			activity,
+			recipient: ctx.recipient
+		});
+	});
+	return {
+		federation,
+		received,
+		kv,
+		queue,
+		reports
+	};
+}
+let activityCounter = 0;
+async function signedFollow(authority = did, privateKey = ed25519PrivateKey, signingKeyId = keyId) {
+	return await (await signObject(new Follow({
+		id: parseIri(`ap+ef61://${authority}/follows/${++activityCounter}`),
+		actor: parseIri(`ap+ef61://${authority}/users/bob`),
+		object: parseIri(`ap+ef61://${did}/users/alice`)
+	}), privateKey, signingKeyId, { contextLoader: mockDocumentLoader })).toJsonLd({ contextLoader: mockDocumentLoader });
+}
+test("Federation.fetch() delivers to portable inboxes", async (t) => {
+	const queue = new RecordingQueue();
+	const { federation, received } = setup({ queue });
+	const json = await signedFollow();
+	await t.step("routes to the existing inbox listeners", async () => {
+		assertEquals((await federation.fetch(post(inboxUrl(), json), { contextData: void 0 })).status, 202);
+		assertEquals(received.length, 1);
+		assertEquals(received[0].recipient, "alice");
+		assert(received[0].activity instanceof Follow);
+	});
+	await t.step("forwards the activity to the other gateways", () => {
+		assertEquals(queue.outbox.map((m) => m.inbox).sort(), [inboxUrl(did, "/users/alice/inbox", GATEWAY3), inboxUrl(did, "/users/alice/inbox", GATEWAY2)]);
+		for (const message of queue.outbox) {
+			assertEquals(message.keys, []);
+			assertEquals(message.activity, json);
+			assertFalse(message.sharedInbox);
+		}
+	});
+	await t.step("neither forwards nor dispatches duplicates", async () => {
+		assertEquals((await federation.fetch(post(inboxUrl(), json), { contextData: void 0 })).status, 202);
+		assertEquals(received.length, 1);
+		assertEquals(queue.outbox.length, 2);
+	});
+	await t.step("accepts ap: and percent-encoded DIDs", async () => {
+		assertEquals((await federation.fetch(post(inboxUrl(did.replaceAll(":", "%3A")), await signedFollow()), { contextData: void 0 })).status, 202);
+		assertEquals(received.length, 2);
+	});
+});
+test("Federation.fetch() delivers to portable inboxes without key pairs", async () => {
+	const queue = new RecordingQueue();
+	const { federation, received } = setup({
+		queue,
+		keyPairs: false
+	});
+	assertEquals((await federation.fetch(post(inboxUrl(), await signedFollow()), { contextData: void 0 })).status, 202);
+	assertEquals(received.length, 1);
+	assertEquals(queue.outbox.length, 2);
+});
+test("Federation.fetch() refuses portable inbox deliveries it does not accept", async (t) => {
+	const { federation, received } = setup({ gateways: [GATEWAY2] });
+	const json = await signedFollow();
+	await t.step("this server is not a gateway of the actor", async () => {
+		assertEquals((await federation.fetch(post(inboxUrl(), json), { contextData: void 0 })).status, 404);
+	});
+	const accepting = setup();
+	const cases = [
+		["unknown actor", inboxUrl(did, "/users/unknown/inbox")],
+		["non-portable actor", inboxUrl(did, "/users/ordinary/inbox")],
+		["DID mismatch", inboxUrl(otherDid)],
+		["shared inbox", inboxUrl(did, "/inbox")],
+		["actor path", inboxUrl(did, "/users/alice")],
+		["unregistered path", inboxUrl(did, "/unknown/alice/inbox")]
+	];
+	for (const [name, url] of cases) await t.step(name, async () => {
+		assertEquals((await accepting.federation.fetch(post(url, json), { contextData: void 0 })).status, 404);
+	});
+	await t.step("inbox mismatch", async () => {
+		const { federation } = setup({ actor: () => new Person({
+			id: parseIri(`ap+ef61://${did}/users/alice`),
+			inbox: parseIri(`ap+ef61://${did}/users/alice/other-inbox`),
+			gateways: [new URL(LOCAL)]
+		}) });
+		assertEquals((await federation.fetch(post(inboxUrl(), json), { contextData: void 0 })).status, 404);
+	});
+	await t.step("tombstone", async () => {
+		const { federation } = setup({ actor: () => new Tombstone({ id: parseIri(`ap+ef61://${did}/users/alice`) }) });
+		assertEquals((await federation.fetch(post(inboxUrl(), json), { contextData: void 0 })).status, 404);
+	});
+	await t.step("malformed DID", async () => {
+		assertEquals((await accepting.federation.fetch(post(`${LOCAL}/.well-known/apgateway/did:key:/users/alice/inbox`, json), { contextData: void 0 })).status, 400);
+	});
+	await t.step("listeners are not called", () => {
+		assertEquals(received.length, 0);
+		assertEquals(accepting.received.length, 0);
+	});
+});
+test("onRequestFinished retains crypto success when a portable activity's DID mismatches", async () => {
+	const { federation, reports, received } = setup();
+	const signingKeyId = new URL(`${otherDid}#${otherDid.substring(8)}`);
+	const activity = await signObject(new Follow({
+		id: parseIri(`ap+ef61://${did}/follows/mismatched-report`),
+		actor: parseIri(`ap+ef61://${otherDid}/users/bob`),
+		object: parseIri(`ap+ef61://${did}/users/alice`)
+	}), otherKeyPair.privateKey, signingKeyId, { contextLoader: mockDocumentLoader });
+	assertEquals((await federation.fetch(post(inboxUrl(), await activity.toJsonLd({ contextLoader: mockDocumentLoader })), { contextData: void 0 })).status, 401);
+	assertEquals(received.length, 0);
+	assertEquals(reports.length, 1);
+	const report = reports[0];
+	assert(report.authentication.status === "rejected");
+	assert(report.authentication.reason.type === "proofPolicy");
+	assertEquals(report.authentication.reason.policy, "portableActivity");
+	assertEquals(report.authentication.reason.detail?.type, "verificationMethodMismatch");
+	assert(report.attempts.some((attempt) => attempt.mechanism === "objectIntegrity" && attempt.checks.some((check) => check.status === "verified")));
+	assert(report.attempts.some((attempt) => attempt.status === "rejected" && attempt.reason.type === "proofPolicy" && attempt.reason.reason.type === "verificationMethodMismatch"));
+	assertEquals(report.outcome, {
+		type: "response",
+		status: 401,
+		disposition: "rejected",
+		reason: "authentication"
+	});
+});
+test("Federation.fetch() applies the proof policy to portable inbox deliveries", async (t) => {
+	const queue = new RecordingQueue();
+	const { federation, received } = setup({ queue });
+	await t.step("unsigned portable activity", async () => {
+		const json = await new Follow({
+			id: parseIri(`ap+ef61://${did}/follows/unsigned`),
+			actor: parseIri(`ap+ef61://${did}/users/bob`),
+			object: parseIri(`ap+ef61://${did}/users/alice`)
+		}).toJsonLd({ contextLoader: mockDocumentLoader });
+		assertEquals((await federation.fetch(post(inboxUrl(), json), { contextData: void 0 })).status, 401);
+	});
+	await t.step("proof made by another DID", async () => {
+		const json = await signedFollow(did, otherKeyPair.privateKey, new URL(`${otherDid}#${otherDid.substring(8)}`));
+		assertEquals((await federation.fetch(post(inboxUrl(), json), { contextData: void 0 })).status, 401);
+	});
+	await t.step("unsigned portable object in a signed activity", async () => {
+		const json = await (await signObject(new Create({
+			id: parseIri(`ap+ef61://${did}/creates/1`),
+			actor: parseIri(`ap+ef61://${did}/users/bob`),
+			object: new Note({
+				id: parseIri(`ap+ef61://${did}/notes/1`),
+				content: "Hello"
+			})
+		}), ed25519PrivateKey, keyId, { contextLoader: mockDocumentLoader })).toJsonLd({ contextLoader: mockDocumentLoader });
+		assertEquals((await federation.fetch(post(inboxUrl(), json), { contextData: void 0 })).status, 401);
+	});
+	await t.step("nothing is dispatched or forwarded", () => {
+		assertEquals(received.length, 0);
+		assertEquals(queue.outbox.length, 0);
+	});
+});
+test("Federation.fetch() does not forward activities authenticated only by HTTP Signatures", async () => {
+	const queue = new RecordingQueue();
+	const { federation, received } = setup({ queue });
+	const activity = {
+		"@context": "https://www.w3.org/ns/activitystreams",
+		id: "https://example.com/follows/http",
+		type: "Follow",
+		actor: "https://example.com/person2",
+		object: formatIri(parseIri(`ap+ef61://${did}/users/alice`))
+	};
+	const request = await signRequest(post(inboxUrl(), activity), rsaPrivateKey3, new URL("https://example.com/person2#key3"));
+	assertEquals((await federation.fetch(request, { contextData: void 0 })).status, 202);
+	assertEquals(received.length, 1);
+	assertEquals(queue.outbox.length, 0);
+});
+test("Federation.fetch() forwards activities authenticated by Linked Data Signatures", async () => {
+	const queue = new RecordingQueue();
+	const { federation, received } = setup({ queue });
+	const activity = await signJsonLd({
+		"@context": "https://www.w3.org/ns/activitystreams",
+		id: "https://example.com/follows/lds",
+		type: "Follow",
+		actor: "https://example.com/person2",
+		object: formatIri(parseIri(`ap+ef61://${did}/users/alice`))
+	}, rsaPrivateKey3, rsaPublicKey3.id, { contextLoader: mockDocumentLoader });
+	assertEquals((await federation.fetch(post(inboxUrl(), activity), { contextData: void 0 })).status, 202);
+	assertEquals(received.length, 1);
+	assertEquals(queue.outbox.length, 2);
+	for (const message of queue.outbox) assertEquals(message.activity, activity);
+});
+test("Federation.fetch() does not forward portable inbox deliveries without verification", async () => {
+	const queue = new RecordingQueue();
+	const { federation, received } = setup({
+		queue,
+		options: { skipSignatureVerification: true }
+	});
+	assertEquals((await federation.fetch(post(inboxUrl(), await signedFollow()), { contextData: void 0 })).status, 202);
+	assertEquals(received.length, 1);
+	assertEquals(queue.outbox.length, 0);
+});
+test("Federation.fetch() does not forward portable inbox deliveries whose listener failed", async () => {
+	const queue = new RecordingQueue();
+	const { federation } = setup({
+		queue,
+		listenerError: true
+	});
+	const json = await signedFollow();
+	let response = await federation.fetch(post(inboxUrl(), json), { contextData: void 0 });
+	assertEquals(response.status, 500);
+	assertEquals(queue.outbox.length, 0);
+	response = await federation.fetch(post(inboxUrl(), json), { contextData: void 0 });
+	assertEquals(response.status, 500);
+	assertEquals(queue.outbox.length, 0);
+});
+test("Federation.fetch() forwards each portable inbox delivery at most once", async (t) => {
+	await t.step("concurrent deliveries", async () => {
+		const queue = new RecordingQueue();
+		const { federation } = setup({ queue });
+		const json = await signedFollow();
+		const responses = await Promise.all([
+			federation.fetch(post(inboxUrl(), json), { contextData: void 0 }),
+			federation.fetch(post(inboxUrl(), json), { contextData: void 0 }),
+			federation.fetch(post(inboxUrl(), json), { contextData: void 0 })
+		]);
+		for (const response of responses) assertEquals(response.status, 202);
+		assertEquals(queue.outbox.map((m) => m.inbox).sort(), [inboxUrl(did, "/users/alice/inbox", GATEWAY3), inboxUrl(did, "/users/alice/inbox", GATEWAY2)]);
+	});
+	await t.step("failed hand-offs are not retried", async () => {
+		const queue = new RecordingQueue();
+		queue.failFor = GATEWAY2;
+		const { federation, received } = setup({ queue });
+		const json = await signedFollow();
+		let response = await federation.fetch(post(inboxUrl(), json), { contextData: void 0 });
+		assertEquals(response.status, 202);
+		assertEquals(queue.outbox.map((m) => m.inbox), [inboxUrl(did, "/users/alice/inbox", GATEWAY3)]);
+		queue.failFor = void 0;
+		response = await federation.fetch(post(inboxUrl(), json), { contextData: void 0 });
+		assertEquals(response.status, 202);
+		assertEquals(queue.outbox.length, 1);
+		assertEquals(received.length, 1);
+	});
+	await t.step("a delivery forwarded back is not forwarded again", async () => {
+		const queue = new RecordingQueue();
+		const local = setup({
+			queue,
+			kv: new MemoryKvStore()
+		});
+		const json = await signedFollow();
+		await local.federation.fetch(post(inboxUrl(), json), { contextData: void 0 });
+		assertEquals(queue.outbox.length, 2);
+		assertEquals((await local.federation.fetch(post(inboxUrl(), json), { contextData: void 0 })).status, 202);
+		assertEquals(queue.outbox.length, 2);
+		assertEquals(local.received.length, 1);
+	});
+	await t.step("without KvStore.cas()", async () => {
+		const queue = new RecordingQueue();
+		const memory = new MemoryKvStore();
+		const { federation, received } = setup({
+			queue,
+			kv: {
+				get: (key) => memory.get(key),
+				set: (key, value, options) => memory.set(key, value, options),
+				delete: (key) => memory.delete(key),
+				list: (prefix) => memory.list(prefix)
+			}
+		});
+		assertEquals((await federation.fetch(post(inboxUrl(), await signedFollow()), { contextData: void 0 })).status, 202);
+		assertEquals(received.length, 1);
+		assertEquals(queue.outbox.length, 0);
+	});
+	await t.step("configured origin", async () => {
+		const queue = new RecordingQueue();
+		const { federation } = setup({
+			queue,
+			gateways: [
+				GATEWAY2,
+				LOCAL,
+				GATEWAY3
+			],
+			options: { origin: GATEWAY2 }
+		});
+		assertEquals((await federation.fetch(post(inboxUrl(), await signedFollow()), { contextData: void 0 })).status, 202);
+		assertEquals(queue.outbox.map((m) => m.inbox), [inboxUrl(did, "/users/alice/inbox", GATEWAY3)]);
+	});
+	await t.step("gateway cap", async () => {
+		const queue = new RecordingQueue();
+		const gateways = [LOCAL];
+		for (let i = 0; i < 15; i++) gateways.push(`https://gw${i}.example.net`);
+		const { federation } = setup({
+			queue,
+			gateways
+		});
+		assertEquals((await federation.fetch(post(inboxUrl(), await signedFollow()), { contextData: void 0 })).status, 202);
+		assertEquals(queue.outbox.length, 10);
+	});
+});
+test("FederationOptions.portableInboxForwarding", async (t) => {
+	await t.step("maxTargets", async () => {
+		const queue = new RecordingQueue();
+		const { federation } = setup({
+			queue,
+			options: { portableInboxForwarding: { maxTargets: 1 } }
+		});
+		assertEquals((await federation.fetch(post(inboxUrl(), await signedFollow()), { contextData: void 0 })).status, 202);
+		assertEquals(queue.outbox.map((m) => m.inbox), [inboxUrl(did, "/users/alice/inbox", GATEWAY2)]);
+	});
+	await t.step("maxTargets: 0 turns off forwarding", async () => {
+		const queue = new RecordingQueue();
+		const { federation, received } = setup({
+			queue,
+			options: { portableInboxForwarding: { maxTargets: 0 } }
+		});
+		assertEquals((await federation.fetch(post(inboxUrl(), await signedFollow()), { contextData: void 0 })).status, 202);
+		assertEquals(received.length, 1);
+		assertEquals(queue.outbox.length, 0);
+	});
+	await t.step("ttl", async () => {
+		const queue = new RecordingQueue();
+		const memory = new MemoryKvStore();
+		const claimTtls = [];
+		const { federation } = setup({
+			queue,
+			kv: {
+				get: (key) => memory.get(key),
+				set: (key, value, options) => memory.set(key, value, options),
+				delete: (key) => memory.delete(key),
+				list: (prefix) => memory.list(prefix),
+				cas: (key, expected, value, options) => {
+					if (key[1] === "portableInboxForwarding") claimTtls.push(options?.ttl);
+					return memory.cas(key, expected, value, options);
+				}
+			},
+			options: { portableInboxForwarding: { ttl: Temporal.Duration.from({ days: 7 }) } }
+		});
+		assertEquals((await federation.fetch(post(inboxUrl(), await signedFollow()), { contextData: void 0 })).status, 202);
+		assertEquals(queue.outbox.length, 2);
+		assertEquals(claimTtls.map((ttl) => ttl?.total("day")), [7, 7]);
+	});
+	await t.step("longest deadline", () => {
+		assertEquals(resolvePortableInboxForwardingOptions({ deadline: { milliseconds: 2 ** 31 - 1 } }).deadline.total("millisecond"), 2 ** 31 - 1);
+	});
+	await t.step("defaults", () => {
+		const resolved = resolvePortableInboxForwardingOptions();
+		assertEquals(resolved.maxTargets, 10);
+		assertEquals(resolved.ttl.total("day"), 30);
+		assertEquals(resolved.deadline.total("second"), 10);
+	});
+	await t.step("invalid values", () => {
+		for (const portableInboxForwarding of [
+			{ maxTargets: -1 },
+			{ maxTargets: 1.5 },
+			{ maxTargets: NaN },
+			{ ttl: { seconds: 0 } },
+			{ ttl: { weeks: 1 } },
+			{ ttl: { months: 1 } },
+			{ deadline: { seconds: -1 } },
+			{ deadline: { years: 1 } },
+			{ deadline: { milliseconds: 2 ** 31 } }
+		]) assertThrows(() => setup({ options: { portableInboxForwarding } }), RangeError);
+	});
+});
+test("Federation.fetch() forwards portable inbox deliveries immediately without a queue", async () => {
+	esm_default.spyGlobal();
+	const requests = [];
+	esm_default.post(`begin:${GATEWAY2}/`, async (callLog) => {
+		const request = callLog.request;
+		requests.push({
+			url: request.url,
+			headers: new Headers(request.headers),
+			body: await request.json()
+		});
+		return new Response(null, { status: 202 });
+	});
+	esm_default.post(`begin:${GATEWAY3}/`, () => {
+		throw new TypeError("Connection refused.");
+	});
+	try {
+		const { federation, received } = setup({ options: { allowPrivateAddress: true } });
+		const json = await signedFollow();
+		let response = await federation.fetch(post(inboxUrl(), json), { contextData: void 0 });
+		assertEquals(response.status, 202);
+		assertEquals(received.length, 1);
+		assertEquals(requests.length, 1);
+		assertEquals(requests[0].url, inboxUrl(did, "/users/alice/inbox", GATEWAY2));
+		assertFalse(requests[0].headers.has("Signature"));
+		assertFalse(requests[0].headers.has("Signature-Input"));
+		assertEquals(requests[0].body, json);
+		response = await federation.fetch(post(inboxUrl(), json), { contextData: void 0 });
+		assertEquals(response.status, 202);
+		assertEquals(requests.length, 1);
+		assertEquals(esm_default.callHistory.calls(`begin:${GATEWAY3}/`).length, 1);
+	} finally {
+		esm_default.hardReset();
+	}
+});
+test("Federation.fetch() forwards portable inbox deliveries when it enqueues them", async () => {
+	const queue = new RecordingQueue();
+	const inboxQueue = new RecordingQueue();
+	let sharedInboxKeyCalls = 0;
+	const { federation, received } = setup({
+		queue,
+		keyPairs: false,
+		onSharedInboxKey: () => sharedInboxKeyCalls++,
+		options: { queue: {
+			inbox: inboxQueue,
+			outbox: queue
+		} }
+	});
+	assertEquals((await federation.fetch(post(inboxUrl(), await signedFollow()), { contextData: void 0 })).status, 202);
+	assertEquals(received.length, 0);
+	assertEquals(inboxQueue.messages.length, 1);
+	assertEquals(inboxQueue.messages[0].type, "inbox");
+	assertEquals(queue.outbox.length, 2);
+	await federation.processQueuedTask(void 0, inboxQueue.messages[0]);
+	assertEquals(received.length, 1);
+	assertEquals(received[0].recipient, "alice");
+	assertEquals(sharedInboxKeyCalls, 0);
+});
+test("forwardPortableInboxActivity() does not wait for slow gateways", async () => {
+	esm_default.spyGlobal();
+	let release = () => {};
+	const pending = new Promise((resolve) => release = resolve);
+	esm_default.post(`begin:${GATEWAY2}/`, async () => {
+		await pending;
+		throw new TypeError("Connection reset.");
+	});
+	try {
+		const kv = new MemoryKvStore();
+		const activityId = parseIri(`ap+ef61://${did}/follows/slow`);
+		const parameters = {
+			recipient: {
+				actorId: parseIri(`ap+ef61://${did}/users/alice`),
+				inboxId: parseIri(`ap+ef61://${did}/users/alice/inbox`),
+				canonicalInboxId: `ap://${did}/users/alice/inbox`,
+				gateways: [new URL(LOCAL), new URL(GATEWAY2)]
+			},
+			activity: { id: formatIri(activityId) },
+			activityId,
+			activityType: "https://www.w3.org/ns/activitystreams#Follow",
+			excludedOrigins: [LOCAL],
+			baseUrl: LOCAL,
+			kv,
+			kvPrefix: ["_fedify", "portableInboxForwarding"],
+			options: resolvePortableInboxForwardingOptions({ deadline: { milliseconds: 10 } }),
+			allowPrivateAddress: true
+		};
+		const started = performance.now();
+		const forwarded = await forwardPortableInboxActivity(parameters);
+		assert(performance.now() - started < 5e3);
+		assertEquals(forwarded.map((u) => u.href), [inboxUrl(did, "/users/alice/inbox", GATEWAY2)]);
+		release();
+		await new Promise((resolve) => setTimeout(resolve, 10));
+		assertEquals(await forwardPortableInboxActivity(parameters), []);
+		assertEquals(esm_default.callHistory.calls().length, 1);
+	} finally {
+		esm_default.hardReset();
+	}
+});
+function compatibleAlice(path = "/users/alice", { authority = did, origin = LOCAL, gateways = [
+	LOCAL,
+	GATEWAY2,
+	GATEWAY3
+] } = {}) {
+	return {
+		id: new URL(`${origin}/.well-known/apgateway/${authority}${path}`),
+		inbox: new URL(inboxUrl(authority, `${path}/inbox`, origin)),
+		gateways: gateways.map((g) => new URL(g))
+	};
+}
+test("Federation.fetch() delivers to portable inboxes of compatible-ID actors", async (t) => {
+	const apAlice = parseIri(`ap+ef61://${did}/users/alice`);
+	const apInbox = parseIri(`ap+ef61://${did}/users/alice/inbox`);
+	const cases = [
+		[
+			"compatible actor and inbox",
+			compatibleAlice(),
+			""
+		],
+		[
+			"on another gateway",
+			compatibleAlice(void 0, { origin: GATEWAY2 }),
+			""
+		],
+		[
+			"compatible actor and ap: inbox",
+			{
+				...compatibleAlice(),
+				inbox: apInbox
+			},
+			""
+		],
+		[
+			"ap: actor and compatible inbox",
+			{
+				...compatibleAlice(),
+				id: apAlice
+			},
+			""
+		],
+		[
+			"compatible inbox with a query",
+			{
+				...compatibleAlice(),
+				inbox: new URL(inboxUrl() + "?page=1")
+			},
+			"?page=1"
+		]
+	];
+	for (const [name, alice, query] of cases) await t.step(name, async () => {
+		const queue = new RecordingQueue();
+		const { federation, received } = setup({
+			queue,
+			actor: (_ctx, identifier) => identifier === "alice" ? new Person(alice) : null
+		});
+		assertEquals((await federation.fetch(post(inboxUrl(), await signedFollow()), { contextData: void 0 })).status, 202);
+		assertEquals(received.length, 1);
+		assertEquals(received[0].recipient, "alice");
+		assertEquals(queue.outbox.map((m) => m.inbox).sort(), [inboxUrl(did, "/users/alice/inbox", GATEWAY3) + query, inboxUrl(did, "/users/alice/inbox", GATEWAY2) + query]);
+	});
+	const json = await signedFollow();
+	const rejections = [
+		["DID mismatch", new Person(compatibleAlice(void 0, { authority: otherDid }))],
+		["inbox mismatch", new Person({
+			...compatibleAlice(),
+			inbox: new URL(inboxUrl(did, "/users/alice/other-inbox"))
+		})],
+		["this server is not a gateway of the actor", new Person(compatibleAlice(void 0, { gateways: [GATEWAY2] }))],
+		["malformed actor ID", new Person({
+			...compatibleAlice(),
+			id: new URL(compatibleAlice().id.href + "?@gateway=https%3A%2F%2Fexample.com")
+		})],
+		["malformed inbox ID", new Person({
+			...compatibleAlice(),
+			inbox: new URL(inboxUrl() + "?@gateway=https%3A%2F%2Fexample.com")
+		})]
+	];
+	for (const [name, actor] of rejections) await t.step(name, async () => {
+		const { federation, received } = setup({ actor: (_ctx, identifier) => identifier === "alice" ? actor : null });
+		assertEquals((await federation.fetch(post(inboxUrl(), json), { contextData: void 0 })).status, 404);
+		assertEquals(received.length, 0);
+	});
+});
+test("forwardPortableInboxActivity() deduplicates compatible activity IDs", async () => {
+	const kv = new MemoryKvStore();
+	const queue = new RecordingQueue();
+	const forward = (activityId) => forwardPortableInboxActivity({
+		recipient: {
+			actorId: compatibleAlice().id,
+			inboxId: parseIri(`ap+ef61://${did}/users/alice/inbox`),
+			canonicalInboxId: `ap+ef61://${did}/users/alice/inbox`,
+			gateways: [new URL(LOCAL), new URL(GATEWAY2)]
+		},
+		activity: { id: activityId.href },
+		activityId,
+		activityType: "https://www.w3.org/ns/activitystreams#Follow",
+		excludedOrigins: [LOCAL],
+		baseUrl: LOCAL,
+		kv,
+		kvPrefix: ["_fedify", "portableInboxForwarding"],
+		outboxQueue: queue
+	});
+	const path = `${did}/follows/compatible`;
+	assertEquals((await forward(new URL(`${LOCAL}/.well-known/apgateway/${path}`))).length, 1);
+	for (const id of [
+		new URL(`${GATEWAY2}/.well-known/apgateway/${path}`),
+		new URL(`${LOCAL}/.well-known/apgateway/${path}?x=1`),
+		parseIri(`ap://${path}`)
+	]) assertEquals(await forward(id), [], id.href);
+	assertEquals(queue.outbox.length, 1);
+});
+const aliceId = parseIri(`ap+ef61://${did}/users/alice`);
+const rsaGatewayKeyPair = await crypto.subtle.generateKey({
+	name: "RSASSA-PKCS1-v1_5",
+	modulusLength: 2048,
+	publicExponent: new Uint8Array([
+		1,
+		0,
+		1
+	]),
+	hash: "SHA-256"
+}, true, ["sign", "verify"]);
+function compatibleAliceId(origin = LOCAL) {
+	return `${origin}/.well-known/apgateway/${did}/users/alice`;
+}
+function mapAlice(identifier) {
+	return identifier === "alice" ? aliceId : null;
+}
+function signatureKeyId(headers) {
+	return headers.get("Signature-Input")?.match(/keyid="([^"]+)"/)?.[1] ?? headers.get("Signature")?.match(/keyId="([^"]+)"/)?.[1];
+}
+/**
+* Makes a document loader that serves Alice's actor document as the gateway
+* at {@link LOCAL} does: signed by her DID, and embedding the gateway keys in
+* its `assertionMethod`.
+*/
+async function createGatewayLoader(keyPairs, origin = LOCAL) {
+	const { federation } = setup({
+		aliceKeyPairs: keyPairs,
+		mapPortableActorId: mapAlice
+	});
+	const keys = await federation.createContext(new URL(origin)).getActorKeyPairs("alice");
+	const document = await (await signObject(new Person({
+		id: aliceId,
+		inbox: parseIri(`${aliceId.href}/inbox`),
+		gateways: [
+			new URL(LOCAL),
+			new URL(GATEWAY2),
+			new URL(GATEWAY3)
+		],
+		assertionMethods: keys.map((k) => k.multikey)
+	}), ed25519PrivateKey, keyId, { contextLoader: mockDocumentLoader })).toJsonLd({ contextLoader: mockDocumentLoader });
+	return (url) => {
+		if (url.replace(/#.*$/, "") !== compatibleAliceId(origin)) return mockDocumentLoader(url);
+		return Promise.resolve({
+			contextUrl: null,
+			documentUrl: url,
+			document: structuredClone(document)
+		});
+	};
+}
+function toRequest({ url, headers, body }) {
+	return new Request(url, {
+		method: "POST",
+		headers,
+		body
+	});
+}
+async function assertSignedBy(request, expectedKeyId, documentLoader) {
+	assertEquals(signatureKeyId(request.headers), expectedKeyId);
+	const result = await verifyRequestDetailed(toRequest(request), {
+		documentLoader,
+		contextLoader: mockDocumentLoader
+	});
+	assert(result.verified, JSON.stringify(result));
+	assertEquals(result.key.id?.href, expectedKeyId);
+}
+/** Records the requests made to the gateways other than {@link LOCAL}. */
+function captureGatewayRequests(respond = () => new Response(null, { status: 202 })) {
+	const requests = [];
+	esm_default.spyGlobal();
+	for (const gateway of [GATEWAY2, GATEWAY3]) esm_default.post(`begin:${gateway}/`, async (callLog) => {
+		const request = callLog.request;
+		const captured = {
+			url: request.url,
+			headers: new Headers(request.headers),
+			body: await request.text()
+		};
+		requests.push(captured);
+		return respond(captured);
+	});
+	return requests;
+}
+test("Federation.fetch() signs forwarded portable inbox deliveries with gateway keys", async (t) => {
+	const keyOrders = [[
+		"RSA key first",
+		[rsaGatewayKeyPair, otherKeyPair],
+		"#main-key"
+	], [
+		"Ed25519 key first",
+		[otherKeyPair, rsaGatewayKeyPair],
+		"#key-2"
+	]];
+	for (const [name, aliceKeyPairs, fragment] of keyOrders) await t.step(name, async () => {
+		const requests = captureGatewayRequests();
+		try {
+			const kv = new MemoryKvStore();
+			const { federation, received } = setup({
+				kv,
+				aliceKeyPairs,
+				mapPortableActorId: mapAlice,
+				options: { allowPrivateAddress: true }
+			});
+			const json = await signedFollow();
+			assertEquals((await federation.fetch(post(inboxUrl(), json), { contextData: void 0 })).status, 202);
+			assertEquals(received.length, 1);
+			assertEquals(requests.map((r) => r.url).sort(), [inboxUrl(did, "/users/alice/inbox", GATEWAY3), inboxUrl(did, "/users/alice/inbox", GATEWAY2)]);
+			const loader = await createGatewayLoader(aliceKeyPairs);
+			for (const request of requests) {
+				await assertSignedBy(request, compatibleAliceId() + fragment, loader);
+				assertEquals(JSON.parse(request.body), json);
+			}
+			assertEquals(await kv.get([
+				"_fedify",
+				"httpMessageSignaturesSpec",
+				GATEWAY2
+			]), "rfc9421");
+		} finally {
+			esm_default.hardReset();
+		}
+	});
+});
+test("Federation.fetch() signs queued forwarded portable inbox deliveries with gateway keys", async () => {
+	const queue = new RecordingQueue();
+	const aliceKeyPairs = [otherKeyPair, rsaGatewayKeyPair];
+	const { federation } = setup({
+		queue,
+		aliceKeyPairs,
+		mapPortableActorId: mapAlice,
+		options: { allowPrivateAddress: true }
+	});
+	assertEquals((await federation.fetch(post(inboxUrl(), await signedFollow()), { contextData: void 0 })).status, 202);
+	assertEquals(queue.outbox.length, 2);
+	const expectedKeyId = `${compatibleAliceId()}#key-2`;
+	for (const message of queue.outbox) {
+		assertEquals(message.keys.map((k) => k.keyId), [expectedKeyId]);
+		assertEquals(message.keys[0].privateKey.kty, "RSA");
+	}
+	const requests = captureGatewayRequests();
+	try {
+		for (const message of queue.outbox) await federation.processQueuedTask(void 0, message);
+	} finally {
+		esm_default.hardReset();
+	}
+	assertEquals(requests.length, 2);
+	const loader = await createGatewayLoader(aliceKeyPairs);
+	for (const request of requests) await assertSignedBy(request, expectedKeyId, loader);
+});
+test("Federation.fetch() forwards portable inbox deliveries unsigned without gateway keys", async (t) => {
+	const otherActorId = parseIri(`ap+ef61://${otherDid}/users/alice`);
+	const cases = [
+		["without a mapper", { aliceKeyPairs: [rsaGatewayKeyPair] }],
+		["the mapper returns null", {
+			aliceKeyPairs: [rsaGatewayKeyPair],
+			mapPortableActorId: () => null
+		}],
+		["the mapper returns another actor", {
+			aliceKeyPairs: [rsaGatewayKeyPair],
+			mapPortableActorId: () => otherActorId
+		}],
+		["the mapper returns another actor of the same DID", {
+			aliceKeyPairs: [rsaGatewayKeyPair],
+			mapPortableActorId: () => parseIri(`ap+ef61://${did}/users/bob`)
+		}],
+		["without a key pairs dispatcher", {
+			keyPairs: false,
+			mapPortableActorId: mapAlice
+		}],
+		["without key pairs", { mapPortableActorId: mapAlice }],
+		["without an RSA key", {
+			aliceKeyPairs: [otherKeyPair],
+			mapPortableActorId: mapAlice
+		}]
+	];
+	for (const [name, options] of cases) await t.step(name, async () => {
+		const queue = new RecordingQueue();
+		const { federation, received } = setup({
+			...options,
+			queue
+		});
+		assertEquals((await federation.fetch(post(inboxUrl(), await signedFollow()), { contextData: void 0 })).status, 202);
+		assertEquals(received.length, 1);
+		assertEquals(queue.outbox.length, 2);
+		for (const message of queue.outbox) assertEquals(message.keys, []);
+	});
+});
+test("Federation.fetch() signs forwarded portable inbox deliveries if the mapper returns an equivalent ID", async (t) => {
+	const ids = [
+		["ap: URI", parseIri(`ap://${did}/users/alice`)],
+		["percent-encoded DID", parseIri(`ap+ef61://${did.replaceAll(":", "%3A")}/users/alice`)],
+		["compatible identifier", new URL(compatibleAliceId(GATEWAY2))]
+	];
+	for (const [name, id] of ids) await t.step(name, async () => {
+		const queue = new RecordingQueue();
+		const { federation } = setup({
+			queue,
+			aliceKeyPairs: [rsaGatewayKeyPair],
+			mapPortableActorId: (identifier) => identifier === "alice" ? id : null
+		});
+		assertEquals((await federation.fetch(post(inboxUrl(), await signedFollow()), { contextData: void 0 })).status, 202);
+		assertEquals(queue.outbox.length, 2);
+		for (const message of queue.outbox) assertEquals(message.keys.map((k) => k.keyId), [`${compatibleAliceId()}#main-key`]);
+	});
+});
+test("Federation.fetch() signs forwarded portable inbox deliveries with the gateway keys of the canonical origin", async () => {
+	const queue = new RecordingQueue();
+	const { federation } = setup({
+		queue,
+		gateways: [
+			GATEWAY2,
+			LOCAL,
+			GATEWAY3
+		],
+		aliceKeyPairs: [rsaGatewayKeyPair],
+		mapPortableActorId: mapAlice,
+		options: { origin: GATEWAY2 }
+	});
+	assertEquals((await federation.fetch(post(inboxUrl(), await signedFollow()), { contextData: void 0 })).status, 202);
+	assertEquals(queue.outbox.length, 1);
+	assertEquals(queue.outbox[0].keys.map((k) => k.keyId), [`${compatibleAliceId(GATEWAY2)}#main-key`]);
+});
+test("Federation.fetch() double-knocks forwarded portable inbox deliveries", async (t) => {
+	await t.step("firstKnock", async () => {
+		const requests = captureGatewayRequests();
+		try {
+			const { federation } = setup({
+				aliceKeyPairs: [rsaGatewayKeyPair],
+				mapPortableActorId: mapAlice,
+				options: {
+					allowPrivateAddress: true,
+					firstKnock: "draft-cavage-http-signatures-12"
+				}
+			});
+			assertEquals((await federation.fetch(post(inboxUrl(), await signedFollow()), { contextData: void 0 })).status, 202);
+			assertEquals(requests.length, 2);
+			for (const request of requests) {
+				assert(request.headers.has("Signature"));
+				assertFalse(request.headers.has("Signature-Input"));
+			}
+		} finally {
+			esm_default.hardReset();
+		}
+	});
+	await t.step("falls back to the other spec", async () => {
+		const requests = captureGatewayRequests((request) => new Response(null, { status: request.headers.has("Signature-Input") ? 401 : 202 }));
+		try {
+			const kv = new MemoryKvStore();
+			const { federation } = setup({
+				kv,
+				aliceKeyPairs: [rsaGatewayKeyPair],
+				mapPortableActorId: mapAlice,
+				options: { allowPrivateAddress: true }
+			});
+			assertEquals((await federation.fetch(post(inboxUrl(), await signedFollow()), { contextData: void 0 })).status, 202);
+			assertEquals(requests.length, 4);
+			const loader = await createGatewayLoader([rsaGatewayKeyPair]);
+			for (const request of requests) {
+				if (request.headers.has("Signature-Input")) continue;
+				await assertSignedBy(request, `${compatibleAliceId()}#main-key`, loader);
+			}
+			assertEquals(await kv.get([
+				"_fedify",
+				"httpMessageSignaturesSpec",
+				GATEWAY2
+			]), "draft-cavage-http-signatures-12");
+		} finally {
+			esm_default.hardReset();
+		}
+	});
+});
+test("A Fedify gateway accepts signed forwarded portable inbox deliveries", async () => {
+	const requests = captureGatewayRequests();
+	let forwarded;
+	try {
+		const { federation } = setup({
+			aliceKeyPairs: [rsaGatewayKeyPair],
+			mapPortableActorId: mapAlice,
+			options: { allowPrivateAddress: true }
+		});
+		assertEquals((await federation.fetch(post(inboxUrl(), await signedFollow()), { contextData: void 0 })).status, 202);
+		forwarded = requests.find((r) => r.url.startsWith(`${GATEWAY2}/`));
+	} finally {
+		esm_default.hardReset();
+	}
+	await assertSignedBy(forwarded, `${compatibleAliceId()}#main-key`, await createGatewayLoader([rsaGatewayKeyPair]));
+	const queue = new RecordingQueue();
+	const loader = await createGatewayLoader([rsaGatewayKeyPair]);
+	const { federation, received } = setup({
+		queue,
+		options: {
+			origin: GATEWAY2,
+			documentLoaderFactory: () => loader
+		}
+	});
+	assertEquals((await federation.fetch(toRequest(forwarded), { contextData: void 0 })).status, 202);
+	assertEquals(received.length, 1);
+	assertEquals(received[0].recipient, "alice");
+	assertEquals(queue.outbox.map((m) => m.inbox), [inboxUrl(did, "/users/alice/inbox", GATEWAY3)]);
+});
+/** Records the URLs that a document loader is asked for. */
+function recordLoader(loader) {
+	const urls = [];
+	return {
+		urls,
+		loader: (url, options) => {
+			urls.push(url);
+			return loader(url, options);
+		}
+	};
+}
+const gateway2KeyId = new URL(`${compatibleAliceId(GATEWAY2)}#main-key`);
+/** Signs a delivery to Alice's inbox on {@link LOCAL}. */
+async function signDelivery(body, { keyId = gateway2KeyId, privateKey = rsaGatewayKeyPair.privateKey, spec = "draft-cavage-http-signatures-12", components, label, headers } = {}) {
+	const signed = await signRequest(post(inboxUrl(), body, headers), privateKey, keyId, {
+		spec,
+		...components == null ? {} : { body: null },
+		rfc9421: {
+			label,
+			components: components?.map((value) => ({
+				value,
+				params: {}
+			}))
+		}
+	});
+	return new Request(signed.url, {
+		method: "POST",
+		headers: signed.headers,
+		body: JSON.stringify(body)
+	});
+}
+async function deliverToGateway(request, { loader, kv, maxTargets, maxHttpSignatures }) {
+	const queue = new RecordingQueue();
+	const { federation, received, kv: store } = setup({
+		queue,
+		kv,
+		options: {
+			documentLoaderFactory: () => loader,
+			maxHttpSignatures,
+			...maxTargets == null ? {} : { portableInboxForwarding: { maxTargets } }
+		}
+	});
+	const response = await federation.fetch(request, { contextData: void 0 });
+	assert(received.length <= 1);
+	return {
+		response,
+		queue,
+		kv: store
+	};
+}
+function forwardedGateways(queue) {
+	return queue.outbox.map((m) => new URL(m.inbox).origin).sort();
+}
+test("Federation.fetch() does not forward portable inbox deliveries back to the gateway that forwarded them", async (t) => {
+	const gatewayLoader = await createGatewayLoader([rsaGatewayKeyPair], GATEWAY2);
+	for (const spec of ["draft-cavage-http-signatures-12", "rfc9421"]) await t.step(spec, async () => {
+		const { loader, urls } = recordLoader(gatewayLoader);
+		const json = await signedFollow();
+		const { response, queue, kv } = await deliverToGateway(await signDelivery(json, { spec }), { loader });
+		assertEquals(response.status, 202);
+		assertEquals(forwardedGateways(queue), [GATEWAY3]);
+		assertEquals(urls.filter((u) => u.startsWith(GATEWAY2)), [gateway2KeyId.href]);
+		const { queue: queue2 } = await deliverToGateway(post(inboxUrl(), json), {
+			loader,
+			kv
+		});
+		assertEquals(queue2.outbox, []);
+	});
+	await t.step("identified before the targets are capped", async () => {
+		const { queue } = await deliverToGateway(await signDelivery(await signedFollow()), {
+			loader: gatewayLoader,
+			maxTargets: 1
+		});
+		assertEquals(forwardedGateways(queue), [GATEWAY3]);
+	});
+	await t.step("with an unrelated signature first", async () => {
+		const { loader, urls } = recordLoader(gatewayLoader);
+		const json = await signedFollow();
+		const unrelated = await signDelivery(json, {
+			spec: "rfc9421",
+			keyId: new URL("https://unrelated.example/key"),
+			privateKey: rsaPrivateKey3,
+			label: "sig1"
+		});
+		const gateway = await signDelivery(json, {
+			spec: "rfc9421",
+			label: "sig2"
+		});
+		const headers = new Headers(gateway.headers);
+		for (const name of ["Signature-Input", "Signature"]) headers.set(name, `${unrelated.headers.get(name)}, ${gateway.headers.get(name)}`);
+		const { queue } = await deliverToGateway(new Request(gateway.url, {
+			method: "POST",
+			headers,
+			body: JSON.stringify(json)
+		}), { loader });
+		assertEquals(forwardedGateways(queue), [GATEWAY3]);
+		assertFalse(urls.some((u) => u.startsWith("https://unrelated.example/")));
+	});
+	await t.step("with the gateway's signature beyond maxHttpSignatures", async () => {
+		const json = await signedFollow();
+		const unrelated = await signDelivery(json, {
+			spec: "rfc9421",
+			keyId: new URL("https://unrelated.example/key"),
+			privateKey: rsaPrivateKey3,
+			label: "sig1"
+		});
+		const gateway = await signDelivery(json, {
+			spec: "rfc9421",
+			label: "sig2"
+		});
+		const headers = new Headers(gateway.headers);
+		for (const name of ["Signature-Input", "Signature"]) headers.set(name, `${unrelated.headers.get(name)}, ${gateway.headers.get(name)}`);
+		const request = () => new Request(gateway.url, {
+			method: "POST",
+			headers,
+			body: JSON.stringify(json)
+		});
+		for (const [maxHttpSignatures, expected] of [[2, [GATEWAY3]], [1, [GATEWAY2, GATEWAY3]]]) {
+			const { loader, urls } = recordLoader(gatewayLoader);
+			const { queue } = await deliverToGateway(request(), {
+				loader,
+				maxHttpSignatures
+			});
+			assertEquals(forwardedGateways(queue), [...expected].sort());
+			assertEquals(urls.some((u) => u.startsWith(GATEWAY2)), maxHttpSignatures > 1);
+		}
+	});
+	await t.step("activity authenticated by a Linked Data Signature", async () => {
+		const { queue } = await deliverToGateway(await signDelivery(await signJsonLd({
+			"@context": "https://www.w3.org/ns/activitystreams",
+			id: `https://example.com/follows/lds-${++activityCounter}`,
+			type: "Follow",
+			actor: "https://example.com/person2",
+			object: formatIri(aliceId)
+		}, rsaPrivateKey3, rsaPublicKey3.id, { contextLoader: mockDocumentLoader })), { loader: gatewayLoader });
+		assertEquals(forwardedGateways(queue), [GATEWAY3]);
+	});
+});
+test("Federation.fetch() forwards portable inbox deliveries whose sending gateway is not identified", async (t) => {
+	const gatewayLoader = await createGatewayLoader([rsaGatewayKeyPair], GATEWAY2);
+	const bobKeyId = new URL(`${GATEWAY2}/.well-known/apgateway/${did}/users/bob#main-key`);
+	const compatibleId = new URL(compatibleAliceId(GATEWAY2));
+	const unsignedActor = await new Person({
+		id: compatibleId,
+		inbox: new URL(`${compatibleId.href}/inbox`),
+		publicKey: rsaPublicKey2.clone({
+			id: gateway2KeyId,
+			owner: compatibleId
+		})
+	}).toJsonLd({ contextLoader: mockDocumentLoader });
+	const unsignedLoader = (url) => {
+		if (url.replace(/#.*$/, "") !== compatibleId.href) return mockDocumentLoader(url);
+		return Promise.resolve({
+			contextUrl: null,
+			documentUrl: url,
+			document: structuredClone(unsignedActor)
+		});
+	};
+	const json = await signedFollow();
+	const contentDigest = `sha-256=:${encodeBase64(await crypto.subtle.digest("SHA-256", new TextEncoder().encode(JSON.stringify(json))))}:`;
+	const cases = [
+		{
+			name: "unsigned",
+			unsigned: true,
+			fetches: false
+		},
+		{
+			name: "invalid signature",
+			sign: { privateKey: rsaPrivateKey2 },
+			fetches: true
+		},
+		{
+			name: "unknown key",
+			loader: mockDocumentLoader,
+			fetches: true
+		},
+		{
+			name: "gateway not in gateways",
+			sign: { keyId: new URL(`https://unlisted.example/.well-known/apgateway/${did}/users/alice#main-key`) },
+			fetches: false
+		},
+		{
+			name: "key of another actor",
+			sign: { keyId: bobKeyId },
+			fetches: false
+		},
+		{
+			name: "key at an ap: key ID",
+			sign: { keyId: parseIri(`ap+ef61://${did}/users/alice?@gateway=${encodeURIComponent(GATEWAY2)}#main-key`) },
+			fetches: false
+		},
+		{
+			name: "content-digest not covered",
+			sign: {
+				spec: "rfc9421",
+				components: ["@method", "@target-uri"]
+			},
+			fetches: false
+		},
+		{
+			name: "target URI not covered",
+			sign: {
+				spec: "rfc9421",
+				components: [
+					"@method",
+					"@authority",
+					"@path",
+					"content-digest"
+				],
+				headers: { "Content-Digest": contentDigest }
+			},
+			fetches: false
+		},
+		{
+			name: "non-canonical spelling of content-digest",
+			sign: {
+				spec: "rfc9421",
+				components: [
+					"@method",
+					"@target-uri",
+					"Content-Digest"
+				],
+				headers: { "Content-Digest": "sha-256=:AAAA:" }
+			},
+			fetches: false
+		},
+		{
+			name: "key not vouched for by the DID",
+			sign: { privateKey: rsaPrivateKey2 },
+			loader: unsignedLoader,
+			fetches: true
+		}
+	];
+	for (const { name, sign, unsigned, loader, fetches } of cases) await t.step(name, async () => {
+		const recorded = recordLoader(loader ?? gatewayLoader);
+		const { response, queue } = await deliverToGateway(unsigned ? post(inboxUrl(), json) : await signDelivery(json, sign), { loader: recorded.loader });
+		assertEquals(response.status, 202);
+		assertEquals(forwardedGateways(queue), [GATEWAY3, GATEWAY2].sort());
+		assertEquals(recorded.urls.some((u) => u.includes("/.well-known/apgateway/")), fetches);
+	});
+	await t.step("already forwarded to the gateway", async () => {
+		const recorded = recordLoader(gatewayLoader);
+		const kv = new MemoryKvStore();
+		const json = await signedFollow();
+		const { queue } = await deliverToGateway(post(inboxUrl(), json), {
+			loader: recorded.loader,
+			kv
+		});
+		assertEquals(forwardedGateways(queue), [GATEWAY3, GATEWAY2].sort());
+		const { queue: queue2 } = await deliverToGateway(await signDelivery(json), {
+			loader: recorded.loader,
+			kv
+		});
+		assertEquals(queue2.outbox, []);
+		assertEquals(recorded.urls.filter((u) => u.startsWith(GATEWAY2)), []);
+	});
+});
+function forwardingParameters(overrides = {}) {
+	const activityId = parseIri(`ap+ef61://${did}/follows/${++activityCounter}`);
+	return {
+		recipient: {
+			actorId: aliceId,
+			inboxId: parseIri(`ap+ef61://${did}/users/alice/inbox`),
+			canonicalInboxId: `ap://${did}/users/alice/inbox`,
+			gateways: [new URL(LOCAL), new URL(GATEWAY2)]
+		},
+		activity: { id: formatIri(activityId) },
+		activityId,
+		activityType: "https://www.w3.org/ns/activitystreams#Follow",
+		excludedOrigins: [LOCAL],
+		baseUrl: LOCAL,
+		kv: new MemoryKvStore(),
+		kvPrefix: ["_fedify", "portableInboxForwarding"],
+		allowPrivateAddress: true,
+		...overrides
+	};
+}
+const gatewayKey = {
+	keyId: new URL(`${compatibleAliceId()}#main-key`),
+	privateKey: rsaGatewayKeyPair.privateKey
+};
+test("forwardPortableInboxActivity() gets keys only when it forwards", async () => {
+	let calls = 0;
+	const parameters = forwardingParameters({
+		outboxQueue: new RecordingQueue(),
+		getKeys: () => {
+			calls++;
+			return Promise.resolve([gatewayKey]);
+		}
+	});
+	assertEquals((await forwardPortableInboxActivity(parameters)).length, 1);
+	assertEquals(calls, 1);
+	assertEquals(await forwardPortableInboxActivity(parameters), []);
+	assertEquals(calls, 1);
+});
+test("forwardPortableInboxActivity() forwards unsigned if it cannot get keys", async (t) => {
+	const nonExtractable = await crypto.subtle.generateKey({
+		name: "RSASSA-PKCS1-v1_5",
+		modulusLength: 2048,
+		publicExponent: new Uint8Array([
+			1,
+			0,
+			1
+		]),
+		hash: "SHA-256"
+	}, false, ["sign", "verify"]);
+	const getKeysCases = [["getKeys() rejects", () => Promise.reject(/* @__PURE__ */ new Error("Unavailable."))], ["the key is not extractable", () => Promise.resolve([{
+		keyId: gatewayKey.keyId,
+		privateKey: nonExtractable.privateKey
+	}])]];
+	for (const [name, getKeys] of getKeysCases) {
+		await t.step(`${name} (queued)`, async () => {
+			const queue = new RecordingQueue();
+			assertEquals((await forwardPortableInboxActivity(forwardingParameters({
+				outboxQueue: queue,
+				getKeys
+			}))).length, 1);
+			assertEquals(queue.outbox.length, 1);
+			assertEquals(queue.outbox[0].keys, []);
+		});
+		await t.step(`${name} (immediate)`, async () => {
+			const requests = captureGatewayRequests();
+			try {
+				assertEquals((await forwardPortableInboxActivity(forwardingParameters({ getKeys }))).length, 1);
+			} finally {
+				esm_default.hardReset();
+			}
+			assertEquals(requests.length, 1);
+			assertEquals(signatureKeyId(requests[0].headers), void 0);
+		});
+	}
+});
+test("forwardPortableInboxActivity() does not wait for slow keys", async () => {
+	let release = () => {};
+	const pending = new Promise((resolve) => release = resolve);
+	const requests = captureGatewayRequests();
+	try {
+		const started = performance.now();
+		const forwarded = await forwardPortableInboxActivity(forwardingParameters({
+			options: resolvePortableInboxForwardingOptions({ deadline: { milliseconds: 10 } }),
+			getKeys: async () => {
+				await pending;
+				throw new Error("Unavailable.");
+			}
+		}));
+		assert(performance.now() - started < 5e3);
+		assertEquals(forwarded.length, 1);
+		assertEquals(requests.length, 0);
+		release();
+		for (let i = 0; i < 100 && requests.length < 1; i++) await new Promise((resolve) => setTimeout(resolve, 10));
+		assertEquals(requests.length, 1);
+		assertEquals(signatureKeyId(requests[0].headers), void 0);
+	} finally {
+		esm_default.hardReset();
+	}
+});
+function gatewaySignature(keyId, verify) {
+	return {
+		keyId,
+		coversDelivery: true,
+		verify
+	};
+}
+function gatewayKeyOf(keyId, owner = aliceId) {
+	return new CryptographicKey({
+		id: keyId,
+		owner,
+		publicKey: rsaGatewayKeyPair.publicKey
+	});
+}
+test("forwardPortableInboxActivity() skips the gateway that forwarded the activity", async (t) => {
+	const recipient = {
+		actorId: parseIri(`ap://${did}/users/alice`),
+		inboxId: parseIri(`ap+ef61://${did}/users/alice/inbox`),
+		canonicalInboxId: `ap://${did}/users/alice/inbox`,
+		gateways: [
+			new URL(LOCAL),
+			new URL(GATEWAY3),
+			new URL(GATEWAY2)
+		]
+	};
+	const owners = [["identified", aliceId], ["identified by a key of a compatible identifier", new URL(compatibleAliceId())]];
+	for (const [name, owner] of owners) await t.step(name, async () => {
+		const queue = new RecordingQueue();
+		assertEquals((await forwardPortableInboxActivity(forwardingParameters({
+			recipient,
+			outboxQueue: queue,
+			signatures: [gatewaySignature(gateway2KeyId, () => Promise.resolve(gatewayKeyOf(gateway2KeyId, owner)))]
+		}))).map((u) => u.origin), [GATEWAY3]);
+	});
+	const notIdentified = [
+		["verify() rejects", [gatewaySignature(gateway2KeyId, () => Promise.reject(/* @__PURE__ */ new Error("Failed.")))]],
+		["verify() throws", [gatewaySignature(gateway2KeyId, () => {
+			throw new Error("Failed.");
+		})]],
+		["not verified", [gatewaySignature(gateway2KeyId, () => Promise.resolve(null))]],
+		["the key is not owned by a portable actor", [gatewaySignature(gateway2KeyId, () => Promise.resolve(gatewayKeyOf(gateway2KeyId, new URL(`${GATEWAY2}/users/alice`))))]],
+		["the key is owned by another actor", [gatewaySignature(gateway2KeyId, () => Promise.resolve(gatewayKeyOf(gateway2KeyId, parseIri(`ap://${did}/users/bob`))))]],
+		["another key is verified", [gatewaySignature(gateway2KeyId, () => Promise.resolve(gatewayKeyOf(new URL(`${compatibleAliceId(GATEWAY3)}#main-key`))))]],
+		["the signature does not cover the delivery", [{
+			...gatewaySignature(gateway2KeyId, () => Promise.resolve(gatewayKeyOf(gateway2KeyId))),
+			coversDelivery: false
+		}]]
+	];
+	for (const [name, signatures] of notIdentified) await t.step(name, async () => {
+		const queue = new RecordingQueue();
+		assertEquals((await forwardPortableInboxActivity(forwardingParameters({
+			recipient,
+			outboxQueue: queue,
+			signatures
+		}))).map((u) => u.origin), [GATEWAY3, GATEWAY2]);
+	});
+	await t.step("verified only if it may save a request", async (t) => {
+		const cases = [
+			["forwarding is turned off", { options: resolvePortableInboxForwardingOptions({ maxTargets: 0 }) }],
+			["no compare-and-swap", { kv: {
+				...new MemoryKvStore(),
+				cas: void 0
+			} }],
+			["this server", { excludedOrigins: [LOCAL, GATEWAY2] }]
+		];
+		for (const [name, overrides] of cases) await t.step(name, async () => {
+			let calls = 0;
+			await forwardPortableInboxActivity(forwardingParameters({
+				recipient,
+				outboxQueue: new RecordingQueue(),
+				signatures: [gatewaySignature(gateway2KeyId, () => {
+					calls++;
+					return Promise.resolve(gatewayKeyOf(gateway2KeyId));
+				})],
+				...overrides
+			}));
+			assertEquals(calls, 0);
+		});
+	});
+	await t.step("verification does not finish in time", async () => {
+		let release = () => {};
+		const pending = new Promise((resolve) => release = resolve);
+		const kv = new MemoryKvStore();
+		const parameters = forwardingParameters({
+			recipient,
+			kv,
+			outboxQueue: new RecordingQueue(),
+			options: resolvePortableInboxForwardingOptions({
+				maxTargets: 1,
+				deadline: { milliseconds: 10 }
+			}),
+			signatures: [gatewaySignature(gateway2KeyId, () => pending)]
+		});
+		const started = performance.now();
+		const forwarded = await forwardPortableInboxActivity(parameters);
+		assert(performance.now() - started < 5e3);
+		assertEquals(forwarded.map((u) => u.origin), [GATEWAY3]);
+		release(gatewayKeyOf(gateway2KeyId));
+		await new Promise((resolve) => setTimeout(resolve, 20));
+		const claimed = [];
+		for await (const { key } of kv.list(parameters.kvPrefix)) claimed.push(String(key.at(-1)));
+		assertEquals(claimed, [GATEWAY3]);
+	});
+});
+test("coversDelivery()", () => {
+	const signature = (label, ...names) => ({
+		keyId: gateway2KeyId,
+		label,
+		components: names.map((value) => ({
+			value,
+			params: {}
+		}))
+	});
+	assert(coversDelivery(signature("sig1", "@method", "@target-uri", "@authority", "content-digest")));
+	assert(coversDelivery(signature(null, "(request-target)", "host", "date", "digest")));
+	assertFalse(coversDelivery(signature("sig1", "@method", "@target-uri")));
+	assertFalse(coversDelivery(signature("sig1", "@method", "@target-uri", "Content-Digest")));
+	assertFalse(coversDelivery(signature("sig1", "@method", "@authority", "@path", "content-digest")));
+	assertFalse(coversDelivery(signature(null, "(request-target)", "digest")));
+	assertFalse(coversDelivery({
+		keyId: gateway2KeyId,
+		label: "sig1",
+		components: [
+			{
+				value: "@method",
+				params: {}
+			},
+			{
+				value: "@target-uri",
+				params: {}
+			},
+			{
+				value: "content-digest",
+				params: { req: true }
+			}
+		]
+	}));
+});
+test("Context.getPortableInboxUri()", async (t) => {
+	const { federation } = setup();
+	await t.step("Context", () => {
+		const ctx = federation.createContext(new URL(LOCAL), void 0);
+		const uri = ctx.getPortableInboxUri("alice", did);
+		assertEquals(uri.protocol, "ap+ef61:");
+		assertEquals(formatIri(uri), `ap+ef61://${did}/users/alice/inbox`);
+		assertThrows(() => ctx.getPortableInboxUri("alice", "not-a-did"), TypeError);
+	});
+	await t.step("RequestContext without portable request", () => {
+		const ctx = federation.createContext(new Request(LOCAL), void 0);
+		assertThrows(() => ctx.getPortableInboxUri("alice"), TypeError);
+		assertEquals(formatIri(ctx.getPortableInboxUri("alice", did)), `ap+ef61://${did}/users/alice/inbox`);
+	});
+});
+test("Federation.fetch() serves and delivers to one portable actor dispatcher", async () => {
+	const { federation, received } = setup({ actor: async (ctx, identifier) => {
+		if (identifier !== "alice") return null;
+		if (ctx.portableRequest != null && ctx.portableRequest.authority !== did) return null;
+		return await signObject(new Person({
+			id: ctx.getPortableActorUri(identifier, did),
+			inbox: ctx.getPortableInboxUri(identifier, did),
+			gateways: [new URL(LOCAL)]
+		}), ed25519PrivateKey, keyId, { contextLoader: mockDocumentLoader });
+	} });
+	assertEquals((await federation.fetch(post(inboxUrl(), await signedFollow()), { contextData: void 0 })).status, 202);
+	assertEquals(received.length, 1);
+	assertEquals(received[0].recipient, "alice");
+	const get = (authority) => federation.fetch(new Request(inboxUrl(authority, "/users/alice"), { headers: { Accept: "application/activity+json" } }), { contextData: void 0 });
+	const actor = await get(did);
+	assertEquals(actor.status, 200);
+	const json = await actor.json();
+	assertEquals(json.id, `ap+ef61://${did}/users/alice`);
+	assertEquals(json.inbox, `ap+ef61://${did}/users/alice/inbox`);
+	assertEquals((await get(otherDid)).status, 404);
+});
+test("Federation.fetch() keeps ordinary inbox deliveries unchanged", async () => {
+	const queue = new RecordingQueue();
+	const { federation, received } = setup({ queue });
+	assertEquals((await federation.fetch(post(`${LOCAL}/users/alice/inbox`, await signedFollow()), { contextData: void 0 })).status, 202);
+	assertEquals(received.length, 1);
+	assertEquals(queue.outbox.length, 0);
+});
+test("onRequestFinished covers portable ingress and recipient lookup failures", async () => {
+	const { federation, reports } = setup({ options: { portableInboxForwarding: { maxTargets: 0 } } });
+	assertEquals((await federation.fetch(post(inboxUrl(), await signedFollow()), { contextData: void 0 })).status, 202);
+	assertEquals(reports.length, 1);
+	assertEquals(reports[0].inbox, {
+		kind: "portable",
+		recipient: "alice"
+	});
+	assertEquals(reports[0].authentication.status, "verified");
+	assert(reports[0].attempts.some((attempt) => attempt.subject.pointer === "" && attempt.status === "verified"));
+	const absent = setup({ actor: () => null });
+	assertEquals((await absent.federation.fetch(post(inboxUrl(), {}), { contextData: void 0 })).status, 404);
+	assertEquals(absent.reports[0].payload, { status: "unavailable" });
+	assertEquals(absent.reports[0].authentication, { status: "notDetermined" });
+	const failure = /* @__PURE__ */ new Error("recipient lookup failed");
+	const broken = setup({ actor: () => {
+		throw failure;
+	} });
+	let thrown;
+	try {
+		await broken.federation.fetch(post(inboxUrl(), {}), { contextData: void 0 });
+	} catch (error) {
+		thrown = error;
+	}
+	assertEquals(thrown, failure);
+	assertEquals(broken.reports.length, 1);
+	assertEquals(broken.reports[0].outcome, {
+		type: "exception",
+		stage: "prepare",
+		error: failure
+	});
+});
+//#endregion
+export {};