earendil-works/pi · error · FrameError

Frame length ${frameLength} exceeds configured limit of ${th

Error message

Frame length ${frameLength} exceeds configured limit of ${this.maxFrameLength}

What it means

Error "Frame length ${frameLength} exceeds configured limit of ${this.maxFrameLength}" thrown in earendil-works/pi.

Source

Thrown at packages/protocol/src/framing.ts:163

	end(): void {
		if (this.state === "ended") throw new FrameError("Frame decoder has ended");
		if (this.state === "failed") throw new FrameError("Frame decoder has failed");
		if (this.headerLength !== 0 || this.expectedPayloadLength !== undefined) {
			this.fail("Truncated frame at end of stream");
		}
		this.state = "ended";
	}

	private fail(message: string): never {
		this.state = "failed";
		this.headerLength = 0;
		this.payloadBlocks = [];
		this.currentPayloadBlock = undefined;
		this.currentPayloadBlockLength = 0;
		this.expectedPayloadLength = undefined;
		this.payloadLength = 0;
		throw new FrameError(message);
	}
}

View on GitHub (pinned to 4af9d21d3b)

Solutions

1. Raise maxFrameLength on both peers or reduce the message size.

When it happens

Trigger: Thrown at packages/protocol/src/framing.ts:163 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of earendil-works/pi@4af9d21d3b (2026-08-24). Data as JSON: /api/errors/a79fff78a02a6233. Report an issue: GitHub.