appProtocolData (45)

The appProtocolData message is used to send data for a specific application protocol. Unlike appData, which is tied to a temporary session and a specific application, this message targets a persistent protocol identifier, which can be supported by multiple different apps.

Core Data Types

Payload Structure

The payload follows the structure of an AppDataMessage, but the sessionId field is repurposed to hold the protocolId.

FieldData TypeMinMaxDescription
protocolIdIxiBytes**The unique identifier of the application protocol this data is for.
dataIxiBytes1*The raw, protocol-specific data payload.

Behavioral Notes

  • Prerequisite: A client should first use getAppProtocols and appProtocols to confirm the recipient supports the protocolId before sending data with this message.
  • Recipient Action: The recipient's client looks up the protocolId and dispatches the data payload to the corresponding local Mini-App or service that has registered to handle that protocol.