AIP 17: Reactions to Messages Source

Author Aleksei Lebedev, Stanislav Jelezoglo
Status Draft
Type Standards
Category ARC
Created 2023-05-24
Requires 5

Simple Summary

This proposal introduces the ability to add reactions to messages in ADAMANT Messenger apps.


Reactions are represented as emoji-based responses to specific messages, enhancing the interactive and expressive capabilities of the messaging platform.


To establish a consistent and standardized approach for implementing message reactions in ADAMANT Messenger apps, a comprehensive specification is necessary.


When a user wishes to react to a specific message, the client must send ADM rich message as described in AIP-5 and include a new field called reactto_id in the message structure. See the syntax below.


According to AIP-5, field must contain encrypted stringified JSON. For reactions, this JSON includes reactto_id and react_message, representing the chosen emoji reaction.

Below is shown structure of the message object:

  reactto_id: String
  react_message: String

Object’s fields as described:

  • reactto_id - Represents the ADM transaction ID of the message to which the user is reacting. This field is mandatory.
  • react_message - Denotes the chosen emoji reaction. This field is also mandatory.

Users can attach multiple reactions to a single message, with each new reaction replacing the previous one. A user’s reaction to a specific message will be react_message with the latest tx timestamp. To remove a reaction, users can send an empty value for the react_message field:

  "reactto_id": "7452709338464950789",
  "react_message": ""

In a dialog, both participants can react to the same message, and an app will show both of them. How to display them is at the discretion of the application.

Reaction transaction is always a message, type 8. See AIP-10


Object before encryption, sending reaction to a message:

  "reactto_id": "7452709338464950789",
  "react_message": "👍"

Example of removing a reaction:

  "reactto_id": "7452709338464950789",
  "react_message": ""

Full transaction after encryption from U15677078342684640219 to U7972131227889954319 looks like:

  "transaction": {
    "type": 8,
    "amount": 0, // Amount should be 0
    "senderId": "U15677078342684640219",
    "senderPublicKey": "e16e624fd0a5123294b448c21f30a07a0435533c693b146b14e66830e4e20404",
    "asset": {
      "chat": {
        "message": "70cbd07ff2ceaf0fc38a01ef9...", // `reactto_id` and `react_message` encrypted
        "own_message": "e98794eaedf47e...",
        "type": 2 // Type should be 2 (Rich Content Message)
    "recipientId": "U7972131227889954319",
    "timestamp": 46116887,
    "signature": "8fc2a54604109a6fcdccec2..."


The introduction of reactions adds a layer of interactivity and engagement to ADAMANT Messenger, allowing users to express sentiments quickly without the need for extensive text-based replies. A standardized approach ensures consistent behavior across different ADAMANT Messenger apps.

Copyright and related rights waived via CC0.