Comment Token

This token represents a comment created by a user.

The comment token must contain a content (c) field which contains the text of the comment in markdown format. The token must also contain a parent (p) field which points to the parent object the comment is referring to.

For other constraints see the Action Tokens.

Content-Addressing

This token is content-addressed using SHA-256:

Parent Reference

The p (parent) field references the parent action:

  • Contains the parent’s action_id (a1~...)
  • Creates immutable parent-child relationship
  • Parent can be a POST, another CMNT, or any commentable action
  • Federation: remote instances can verify the complete chain

Database Key

The database key for a comment token is [iss, t, id]

Purpose: Each comment is unique and not overridden by subsequent comments from the same user. The key includes the action ID itself, allowing multiple comments from the same user on the same parent.

Example

User @someotheruser.cloudillo.net writes a comment on a post:

Field Value
iss someotheruser.cloudillo.net
aud somegroup.cloudillo.net
iat 2024-04-13T00:01:00.000Z
k 20240301
t CMNT
c “I love U too!”
p NAado5PS4j5+abYtRpBELU0e5OQ+zGf/tuuWvUwQ6PA=