Expand description
Contract-owned request-signing bytes and header vocabulary.
Structs§
- Grant
Envelope V2Payload - The fields covered by a GrantEnvelope v2 server signature.
- Grant
Envelope V2Right - One ordered right in a GrantEnvelope v2 canonical payload.
Enums§
- Grant
Envelope V2Codec Error - A fail-closed GrantEnvelope v2 canonical-payload codec error.
Constants§
- BISCUIT_
AUTHORITY_ PUBLIC_ KEY_ ROLE - Exact signed/wire role label for the ephemeral Biscuit authority key.
- DEVICE_
PROOF_ PUBLIC_ KEY_ ROLE - Exact signed/wire role label for the non-extractable device proof key.
- GRANT_
ENVELOPE_ V2_ DOMAIN - Domain prepended to every server-signed GrantEnvelope v2 canonical payload.
- GRANT_
ENVELOPE_ V2_ FORMAT_ VERSION - Signed format discriminator immediately following the GrantEnvelope domain.
- HEADER_
ACTION_ URL - HEADER_
ALGORITHM - HEADER_
IDENTITY - HEADER_
NONCE_ BIN - HEADER_
REQUIRED - HEADER_
SIGNATURE_ BIN - HEADER_
TIMESTAMP - HEADER_
WEBAUTHN_ AUTH_ DATA_ BIN - HEADER_
WEBAUTHN_ CLIENT_ DATA_ BIN - HEADER_
WEBAUTHN_ USER_ HANDLE_ BIN - IDENTITY_
BINDING_ CHALLENGE_ V2_ DOMAIN - Domain for the WebAuthn assertion that binds both client-minted session signing roles. Includes its terminal NUL byte.
- ONE_
KEY_ DEVICE_ BINDING_ CHALLENGE_ DOMAIN - Domain separator for the one-key passkey↔device-key binding challenge
introduced by weft#2047 (possession-first identity, two-key model retired).
Promoted here from weft-local
weft-authz::webauthnso weft, heddle, and tapestry share ONE definition. Unlike the-v2NUL-terminated domains, this value is the bare string with NO terminal NUL: the challenge framing inserts an explicit0x00separator between the domain and the key. This matches weft’sONE_KEY_DEVICE_BINDING_CHALLENGE_DOMAINbyte-for-byte. - POP_
DELEGATION_ V1_ DOMAIN - Domain owned authoritatively by Weft’s strict
pop_delegationverifier. Mirrored here so Rust and TypeScript producers cannot drift. - PROVIDER_
PLAN_ DOMAIN - RECOVERY_
NEW_ DEVICE_ POP_ V1_ DOMAIN - Domain separator for the recovery new-device-key proof-of-possession
(weft#2047 leg 2). Distinct from the credential-rotation (
heddle-credential- rotation-v1) and SA-issuance (heddle-sa-credential-issue-v1) PoP domains so a signature captured against one RPC cannot be replayed against another. Bare string with explicit0x00field separators, matching that PoP family. - TIER_
1_ REQUEST_ SIGNING_ V1_ DOMAIN - Deployed domain for Tier-1 request signatures. This legacy v1 value predates the terminal-NUL convention and MUST remain byte-for-byte stable.
- TRANSPORT_
BOOTSTRAP_ SIGNING_ V1_ DOMAIN - Deployed domain used by endpoint-descriptor and relay-admission bootstrap signatures. It currently has the same bytes as request signing, but remains a separate constant so the two protocol purposes cannot drift implicitly.
Functions§
- endpoint_
descriptor_ bytes - Returns the domain-separated bytes signed for an HTTPS endpoint descriptor.
- grant_
envelope_ v2_ canonical_ payload - Encodes the exact bytes that a GrantEnvelope v2 issuer signs.
- identity_
binding_ challenge_ v2_ bytes - Returns the exact WebAuthn challenge bytes that bind both client-minted
session roles. The array types pin both keys to raw 32-byte Ed25519 public
keys; callers base64url-encode the returned bytes without padding for
clientDataJSON.challenge. - one_
key_ device_ binding_ challenge - Computes the one-key passkey binding challenge string (weft#2047).
- parse_
grant_ envelope_ v2_ canonical_ payload - Parses one complete GrantEnvelope v2 canonical payload without fallback.
- provider_
plan_ bytes - Returns the canonical bytes signed to consent to one exact provider batch.
- recovery_
new_ device_ pop_ digest - Returns the 32-byte digest the NEW device key signs to prove possession during recovery completion (weft#2047 leg 2).
- relay_
admission_ bytes - Returns the domain-separated bytes signed for a relay admission token.
- retry_
key_ hash - Hashes the retry identity without conflating it with the request payload.
- stream_
open_ bytes - Returns the canonical bytes signed by the opening frame of a stream.
- unary_
bytes - Returns the canonical bytes signed for a unary request.