Auctions¶

Calls¶

bid¶

See [Pallet::bid].

Attributes¶

Name	Type
para	`ParaId`
auction_index	`AuctionIndex`
first_slot	`LeasePeriodOf<T>`
last_slot	`LeasePeriodOf<T>`
amount	`BalanceOf<T>`

Python¶

call = substrate.compose_call(
    'Auctions', 'bid', {
    'amount': 'u128',
    'auction_index': 'u32',
    'first_slot': 'u32',
    'last_slot': 'u32',
    'para': 'u32',
}
)

cancel_auction¶

See [Pallet::cancel_auction].

Attributes¶

No attributes

Python¶

call = substrate.compose_call(
    'Auctions', 'cancel_auction', {}
)

new_auction¶

See [Pallet::new_auction].

Attributes¶

Name	Type
duration	`BlockNumberFor<T>`
lease_period_index	`LeasePeriodOf<T>`

Python¶

call = substrate.compose_call(
    'Auctions', 'new_auction', {
    'duration': 'u32',
    'lease_period_index': 'u32',
}
)

Events¶

AuctionClosed¶

An auction ended. All funds become unreserved.

Attributes¶

Name	Type	Composition
auction_index	`AuctionIndex`	`u32`

AuctionStarted¶

An auction started. Provides its index and the block number where it will begin to close and the first lease period of the quadruplet that is auctioned.

Attributes¶

Name	Type	Composition
auction_index	`AuctionIndex`	`u32`
lease_period	`LeasePeriodOf<T>`	`u32`
ending	`BlockNumberFor<T>`	`u32`

BidAccepted¶

A new bid has been accepted as the current winner.

Attributes¶

Name	Type	Composition
bidder	`T::AccountId`	`AccountId`
para_id	`ParaId`	`u32`
amount	`BalanceOf<T>`	`u128`
first_slot	`LeasePeriodOf<T>`	`u32`
last_slot	`LeasePeriodOf<T>`	`u32`

ReserveConfiscated¶

Someone attempted to lease the same slot twice for a parachain. The amount is held in reserve but no parachain slot has been leased.

Attributes¶

Name	Type	Composition
para_id	`ParaId`	`u32`
leaser	`T::AccountId`	`AccountId`
amount	`BalanceOf<T>`	`u128`

Reserved¶

Funds were reserved for a winning bid. First balance is the extra amount reserved. Second is the total.

Attributes¶

Name	Type	Composition
bidder	`T::AccountId`	`AccountId`
extra_reserved	`BalanceOf<T>`	`u128`
total_amount	`BalanceOf<T>`	`u128`

Unreserved¶

Funds were unreserved since bidder is no longer active. [bidder, amount]

Attributes¶

Name	Type	Composition
bidder	`T::AccountId`	`AccountId`
amount	`BalanceOf<T>`	`u128`

WinningOffset¶

The winning offset was chosen for an auction. This will map into the Winning storage map.

Attributes¶

Name	Type	Composition
auction_index	`AuctionIndex`	`u32`
block_number	`BlockNumberFor<T>`	`u32`

Storage functions¶

AuctionCounter¶

Number of auctions started so far.

Python¶

result = substrate.query(
    'Auctions', 'AuctionCounter', []
)

Return value¶

'u32'

AuctionInfo¶

Information relating to the current auction, if there is one.

The first item in the tuple is the lease period index that the first of the four contiguous lease periods on auction is for. The second is the block number when the auction will "begin to end", i.e. the first block of the Ending Period of the auction.

Python¶

result = substrate.query(
    'Auctions', 'AuctionInfo', []
)

Return value¶

('u32', 'u32')

ReservedAmounts¶

Amounts currently reserved in the accounts of the bidders currently winning (sub-)ranges.

Python¶

result = substrate.query(
    'Auctions', 'ReservedAmounts', [('AccountId', 'u32')]
)

Return value¶

'u128'

Winning¶

The winning bids for each of the 10 ranges at each sample in the final Ending Period of the current auction. The map's key is the 0-based index into the Sample Size. The first sample of the ending period is 0; the last is Sample Size - 1.

Python¶

result = substrate.query(
    'Auctions', 'Winning', ['u32']
)

Return value¶

"[(None, ('AccountId', 'u32', 'u128')); 36]"

Constants¶

EndingPeriod¶

The number of blocks over which an auction may be retroactively ended.

Value¶

Python¶

constant = substrate.get_constant('Auctions', 'EndingPeriod')

LeasePeriodsPerSlot¶

Value¶

Python¶

constant = substrate.get_constant('Auctions', 'LeasePeriodsPerSlot')

SampleLength¶

The length of each sample to take during the ending period.

EndingPeriod / SampleLength = Total # of Samples

Value¶

Python¶

constant = substrate.get_constant('Auctions', 'SampleLength')

SlotRangeCount¶

Value¶

Python¶

constant = substrate.get_constant('Auctions', 'SlotRangeCount')

Errors¶

AlreadyLeasedOut¶

The para is already leased out for part of this range.

AuctionEnded¶

Auction has already ended.

AuctionInProgress¶

This auction is already in progress.

LeasePeriodInPast¶

The lease period is in the past.

NotAuction¶

Not an auction.

NotCurrentAuction¶

Not a current auction.

ParaNotRegistered¶

Para is not registered