[spec] Per-recipient format is unspecified about age HOT 6 CLOSED

Yeah, I realized line wrapping should not be defined in encode at all, but in the ssh-rsa definition, since it's the only multiline one.

from age.

As a start, I moved the wrapping part to the ssh-rsa block, which should be a no-op.

from age.

Based on my current understanding of the format, I suggest something like the following:

The text header has the following format:

VERSION_STRING\n
RECIPIENT_LINE_1\n
[...]
RECIPIENT_LINE_N\n
--- MAC\n

All whitespace separators in the header are either a single space character or a single newline (\n) character.

Recipient lines within the header have the following format:

-> TYPE_NAME ARG_1 ARG_2 [...] ARG_J\nBODY

where BODY may have internal newline characters, but does not end in a newline character.

from age.

This issue needs to be resolved in order to clear up the definition of what a "recipient line" is, which constraints how implementations ignore unknown recipient types, and how future recipient lines are implemented.

from age.

In str4d/rage#52 I am parsing unknown recipient lines using the above format, with the additional constraints that BODY is only Base64-encoded data, and ARG_N may be either Base64-encoded data or a decimal integer.

from age.

This is now fixed in the spec, I will make available some test cases of valid weird age files with arbitrary recipients or unknown versions.

The first line of the header is age-encryption.org/ followed by an arbitrary version string. Here and below, an arbitrary string is a sequence of ASCII characters with values 33 to 126. We describe version v1, other versions can change anything after the first line.

The rest of the header is a sequence of one or more recipient stanzas. Each recipient stanza starts with a line beginning with -> and its type name, followed by zero or more SP-separated arguments. The type name and the arguments are arbitrary strings. Unknown recipient types are ignored. The rest of the recipient stanza is a body of canonical base64 from RFC 4648 without padding wrapped at exactly 64 columns.

from age.