XcmpQueue¶
Events¶
BadFormat¶
Bad XCM format used.
Attributes¶
Name | Type | Composition |
---|---|---|
message_hash | XcmHash |
[u8; 32] |
BadVersion¶
Bad XCM version used.
Attributes¶
Name | Type | Composition |
---|---|---|
message_hash | XcmHash |
[u8; 32] |
DeferredBucketDiscarded¶
The deferred bucket was discarded.
Attributes¶
Name | Type | Composition |
---|---|---|
sender | ParaId |
u32 |
index | DeferredIndex |
('u32', 'u16') |
DeferredXcmDiscarded¶
The deferred message was successfully discarded.
Attributes¶
Name | Type | Composition |
---|---|---|
sender | ParaId |
u32 |
sent_at | RelayBlockNumber |
u32 |
deferred_to | RelayBlockNumber |
u32 |
index | DeferredIndex |
('u32', 'u16') |
position | u32 |
u32 |
message_hash | Option<XcmHash> |
(None, '[u8; 32]') |
Fail¶
Some XCM failed.
Attributes¶
Name | Type | Composition |
---|---|---|
message_hash | XcmHash |
[u8; 32] |
message_id | XcmHash |
[u8; 32] |
error | XcmError |
{'Overflow': None, 'Unimplemented': None, 'UntrustedReserveLocation': None, 'UntrustedTeleportLocation': None, 'LocationFull': None, 'LocationNotInvertible': None, 'BadOrigin': None, 'InvalidLocation': None, 'AssetNotFound': None, 'FailedToTransactAsset': None, 'NotWithdrawable': None, 'LocationCannotHold': None, 'ExceedsMaxMessageSize': None, 'DestinationUnsupported': None, 'Transport': None, 'Unroutable': None, 'UnknownClaim': None, 'FailedToDecode': None, 'MaxWeightInvalid': None, 'NotHoldingFees': None, 'TooExpensive': None, 'Trap': 'u64', 'ExpectationFalse': None, 'PalletNotFound': None, 'NameMismatch': None, 'VersionIncompatible': None, 'HoldingWouldOverflow': None, 'ExportError': None, 'ReanchorFailed': None, 'NoDeal': None, 'FeesNotMet': None, 'LockError': None, 'NoPermission': None, 'Unanchored': None, 'NotDepositable': None, 'UnhandledXcmVersion': None, 'WeightLimitReached': {'ref_time': 'u64', 'proof_size': 'u64'}, 'Barrier': None, 'WeightNotComputable': None, 'ExceedsStackLimit': None} |
weight | Weight |
{'ref_time': 'u64', 'proof_size': 'u64'} |
OverweightEnqueued¶
An XCM exceeded the individual message weight budget.
Attributes¶
Name | Type | Composition |
---|---|---|
sender | ParaId |
u32 |
sent_at | RelayBlockNumber |
u32 |
index | OverweightIndex |
u64 |
required | Weight |
{'ref_time': 'u64', 'proof_size': 'u64'} |
OverweightServiced¶
An XCM from the overweight queue was executed with the given actual weight used.
Attributes¶
Name | Type | Composition |
---|---|---|
index | OverweightIndex |
u64 |
used | Weight |
{'ref_time': 'u64', 'proof_size': 'u64'} |
Success¶
Some XCM was executed ok.
Attributes¶
Name | Type | Composition |
---|---|---|
message_hash | XcmHash |
[u8; 32] |
message_id | XcmHash |
[u8; 32] |
weight | Weight |
{'ref_time': 'u64', 'proof_size': 'u64'} |
XcmDeferred¶
Some XCM was deferred for later execution
Attributes¶
Name | Type | Composition |
---|---|---|
sender | ParaId |
u32 |
sent_at | RelayBlockNumber |
u32 |
deferred_to | RelayBlockNumber |
u32 |
index | DeferredIndex |
('u32', 'u16') |
position | u32 |
u32 |
message_hash | Option<XcmHash> |
(None, '[u8; 32]') |
XcmDeferredQueueFull¶
The deferred queue is full with xcm messages
Attributes¶
Name | Type | Composition |
---|---|---|
sender | ParaId |
u32 |
sent_at | RelayBlockNumber |
u32 |
message_hash | Option<XcmHash> |
(None, '[u8; 32]') |
XcmpMessageSent¶
An HRMP message was sent to a sibling parachain.
Attributes¶
Name | Type | Composition |
---|---|---|
message_hash | XcmHash |
[u8; 32] |
Storage functions¶
CounterForOverweight¶
Counter for the related counted storage map
Python¶
result = substrate.query(
'XcmpQueue', 'CounterForOverweight', []
)
Return value¶
'u32'
DeferAllBy¶
Whether or not and if so by how much to defer all incoming XCMs.
Python¶
result = substrate.query(
'XcmpQueue', 'DeferAllBy', []
)
Return value¶
'u32'
DeferredIndices¶
Index of deferred message buckets to process.
Python¶
result = substrate.query(
'XcmpQueue', 'DeferredIndices', ['u32']
)
Return value¶
'scale_info::502'
DeferredMessageBuckets¶
Storage for deferred messages, indexed by para id, block and counter.
Python¶
result = substrate.query(
'XcmpQueue', 'DeferredMessageBuckets', ['u32', ('u32', 'u16')]
)
Return value¶
[
(
None,
{
'deferred_to': 'u32',
'sender': 'u32',
'sent_at': 'u32',
'xcm': {
None: None,
'V2': ['scale_info::307'],
'V3': ['scale_info::311'],
},
},
),
]
DeferredQueueSuspended¶
Whether or not the Deferred queue is suspended from executing XCMs or not.
Python¶
result = substrate.query(
'XcmpQueue', 'DeferredQueueSuspended', []
)
Return value¶
'bool'
InboundXcmpMessages¶
Inbound aggregate XCMP messages. It can only be one per ParaId/block.
Python¶
result = substrate.query(
'XcmpQueue', 'InboundXcmpMessages', ['u32', 'u32']
)
Return value¶
'Bytes'
InboundXcmpStatus¶
Status of the inbound XCMP channels.
Python¶
result = substrate.query(
'XcmpQueue', 'InboundXcmpStatus', []
)
Return value¶
[
{
'message_metadata': [
(
'u32',
(
'ConcatenatedVersionedXcm',
'ConcatenatedEncodedBlob',
'Signals',
),
),
],
'sender': 'u32',
'state': ('Ok', 'Suspended'),
},
]
OutboundXcmpMessages¶
The messages outbound in a given XCMP channel.
Python¶
result = substrate.query(
'XcmpQueue', 'OutboundXcmpMessages', ['u32', 'u16']
)
Return value¶
'Bytes'
OutboundXcmpStatus¶
The non-empty XCMP channels in order of becoming non-empty, and the index of the first
and last outbound message. If the two indices are equal, then it indicates an empty
queue and there must be a non-Ok
OutboundStatus
. We assume queues grow no greater
than 65535 items. Queue indices for normal messages begin at one; zero is reserved in
case of the need to send a high-priority signal message this block.
The bool is true if there is a signal message waiting to be sent.
Python¶
result = substrate.query(
'XcmpQueue', 'OutboundXcmpStatus', []
)
Return value¶
[
{
'first_index': 'u16',
'last_index': 'u16',
'recipient': 'u32',
'signals_exist': 'bool',
'state': ('Ok', 'Suspended'),
},
]
Overweight¶
The messages that exceeded max individual message weight budget.
These message stay in this storage map until they are manually dispatched via
service_overweight
.
Python¶
result = substrate.query(
'XcmpQueue', 'Overweight', ['u64']
)
Return value¶
('u32', 'u32', 'Bytes')
OverweightCount¶
The number of overweight messages ever recorded in Overweight
. Also doubles as the next
available free overweight index.
Python¶
result = substrate.query(
'XcmpQueue', 'OverweightCount', []
)
Return value¶
'u64'
QueueConfig¶
The configuration which controls the dynamics of the outbound queue.
Python¶
result = substrate.query(
'XcmpQueue', 'QueueConfig', []
)
Return value¶
{
'drop_threshold': 'u32',
'resume_threshold': 'u32',
'suspend_threshold': 'u32',
'threshold_weight': {'proof_size': 'u64', 'ref_time': 'u64'},
'weight_restrict_decay': {'proof_size': 'u64', 'ref_time': 'u64'},
'xcmp_max_individual_weight': {'proof_size': 'u64', 'ref_time': 'u64'},
}
QueueSuspended¶
Whether or not the XCMP queue is suspended from executing incoming XCMs or not.
Python¶
result = substrate.query(
'XcmpQueue', 'QueueSuspended', []
)
Return value¶
'bool'
SignalMessages¶
Any signal messages waiting to be sent.
Python¶
result = substrate.query(
'XcmpQueue', 'SignalMessages', ['u32']
)
Return value¶
'Bytes'
Errors¶
BadOverweightIndex¶
Bad overweight index.
BadXcm¶
Bad XCM data.
BadXcmOrigin¶
Bad XCM origin.
FailedToSend¶
Failed to send XCM message.
MessageNotFound¶
Indicated message is not present.
WeightOverLimit¶
Provided weight is possibly not enough to execute the message.