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

Gating

A comment is rejected if the parent action has comments disabled. The CMNT definition sets gated_by_parent_flag: 'C', so a parent carrying the lowercase c flag (comments off) blocks new comments.

Database Key

CMNT has no key_pattern, so every comment is unique and identified by its action ID. A user can post multiple comments on the same parent. Use the CMNT:DEL subtype to delete a comment.

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 a1~8kR3mN9pQ2vL6xWpYzT4BjN…