Track Message Status
Tracks the status of a message
GET https://prod.dlapi.socket.tech/v1/messages-from-tx
Header: x-api-key : 2Va1n3HzAS5XfXB8ELhX1aATJwzA1A72sNnJE1a0
Query Parameters
| Query param | Description |
|---|---|
srcChainSlug | Slug of source chain |
srcTxHash | Transaction hash where outbound method was called |
Example Request
Note : Add the x-api-key header mentioned above in the request for authentication.
Response Parameters
| Parameter | Description |
|---|---|
status | Message Status |
messageId | Unique ID of message |
packetId | Unique ID assigned to each Packet |
from.srcChainSlug | Slug of source chain where message is initiated |
from.srcPlug | Address of message sender plug |
to.dstChainSlug | Slug of destination chain where message is executed |
to.destPlug | Address of message receiver plug |
outboundTx | Source chain transaction hash where outbound method was called |
packedMessage | keccak256 hash of encoded message details |
inboundTx | Transaction on destination chain where the inbound method on Socket is called |
executionDetails.inboundStatus | Status of executing inbound method on destination Plug InboundStatus |
executionDetails.isExecuted | Boolean value indicating if message is executed on destination chain |
executionDetails.executor | Address of Executor |
executionDetails.executionTxHash | Destination chain transaction hash where payload was executed |
Types of messageStatus
| Type | Description |
|---|---|
RECEIVED | Message added to capacitor queue for destination chain delivery |
SEALED | Packet which includes the message has been sealed on source chain |
PROPOSED | Packet which includes the message has been proposed on destination chain |
ATTESTED | The validity of the packet has been attested or verified on the destination chain |
VERIFIED | The message has been verified |
EXECUTING | The message is being executed |
EXECUTION_FAILURE | Message execution failed |
EXECUTION_SUCCESS | Message is successfully delivered to destination Plug |
INBOUND_REVERTING | The inbound method on the destination chain plug is reverting |
Inbound status
| Type | Description |
|---|---|
NOT_TRIED | Payload execution not been tried yet |
REVERTING | Payload execution is reverting on Plug's inbound method call |
EXECUTING | Payload execution tx sent and is in progress |
SUCCESS | inbound method called and payload successfully executed |