"intro_payload", "IntroduceHandshakePayload" terminology
In the spec, this thing isn't given a proper name. It's just described as "ENCRYPTED". IMO the spec ought to be updated to use the word "payload". But torspec!255 (merged) will conflict with that, so maybe not right now. The terminology we have in Arti is "header" vs "payload" which is probably useful.
However, the type IntroduceHandshakePayload
has the word Handshake
in it which is redundant.
Also in Arti we have IntroPayloadExt
and IntroduceExt
. It's great that we have two types, but they should cross-reference to the names in the spec. But the spec doesn't give things names.
Proposals:
In arti, wait after !2026, then change IntroduceHandshakePayload
to IntroducePayload
.
In torspec, wait after torspec!255 (merged), then use "payload" for the plaintext of the ENCRYPTED part and consider using the word "header" for the outer part. Then, in arti, add the decided-on terminology to the docs, and also add a proper cross-reference.