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
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= |