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:
- The entire JWT token (header + payload + signature) is hashed
- Action ID format:
a1~{base64_hash} - See Content-Addressing & Merkle Trees for details
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… |