Tearleads

PrincipalStateResponse

One signed state in a principal policy chain: it commits to the principal's membership, grants, key epoch, encrypted payload, signer, and predecessor.

Shape

object

22 fields
  • createdAtstringrequired
  • encapsulationPublicKeystringrequired

    The principal's public key at this key epoch; key material for the principal is wrapped to it.

  • externalAuthorityPrincipalStateExternalAuthorityResponserequirednullable

    For a group administered by the organization, the exact Admins head that authorized this state; null when the state's own policy authorized it.

  • grantCountintegerrequired
    • at least 0

    Number of container grants the principal holds.

  • grantRootstringrequired

    Digest of the sorted container grants; with grantCount it authenticates the complete grant list.

  • keyEpochintegerrequired
    • at least 1

    The principal's key epoch; envelopes and wraps name the epoch they were made for.

  • keyFingerprintstringrequired

    Fingerprint of encapsulationPublicKey.

  • memberCountintegerrequired
    • at least 0
  • memberEnvelopesRootstringrequired

    Digest committing to every member envelope of this key epoch.

  • membershipModestringrequired
    • always projection

    Always projection: membership is the signed projection list.

  • membershipRootstringrequired
  • payloadCiphertextHashstringrequired

    Hash of the state's encrypted payload.

  • prevStateHashstringrequirednullable

    Hash of the previous state, or null for the first.

  • principalIdstringrequired
  • principalTypestringrequired
    • one of group, organization
  • projectionRootstringrequired
  • signaturestringrequired

    ML-DSA-87 signature over the canonical state.

  • signedAtstringrequired
  • signerUserIdstringrequired
  • signerUserKeyFingerprintstringrequired

    Signing key fingerprint of the signer.

  • stateHashstringrequired

    Hash of this signed state; other objects cite the head by it.

  • versionintegerrequired
    • at least 1

    Position in the chain, starting at 1.

Other fields are allowed.

Used by

Schemas