Coin Selection for Migration

Creates a series of coin selections that, when published as transactions, will have the effect of migrating all funds from one wallet to another.

Since UTxO-based blockchains typically impose limits on the sizes of individual transactions, and since individual UTxO sets can contain arbitrarily many entries, migrating all funds from one wallet to another may require the creation of several transactions.

This function therefore partitions the given set of inputs into multiple batches of up to b inputs, where b is specified by the given BatchSize parameter. (See idealBatchSize for an automatic way to calculate a suitable batch size.)

For each batch of inputs, this function creates a separate CoinSelection with the given inputs and a generated change set, where the change set represents the value to be transferred to the target wallet, carefully adjusted to deduct a fee in accordance with the given FeeOptions parameter. The set of outputs for each coin selection is purposefully left empty, as all value is captured in the change set.

Since: 1.0.0

An upper limit for the number of inputs to include in each coin selection generated by selectCoins.

Since: 1.0.0

Calculate an ideal batch size based on the given coin selection limit.

Since: 1.0.0