@cardano-sdk/input-selection v0.12.28
Cardano JS SDK | Input Selection | CIP-0002
This package implements concepts from the draft specification being developed in CIP-0002.
Currently, there is only 1 input selection algorithm: RoundRobinRandomImprove, which is an Random-Improve adaptation that handles asset selection.
Usage Example
import { roundRobinRandomImprove, defaultSelectionConstraints, InputSelector, SelectionResult, SelectionSkeleton } from '@cardano-sdk/input-selection';
import { loadCardanoSerializationLib, CSL, CardanoSerializationLib, ProtocolParametersRequiredByWallet } from '@cardano-sdk/core';
const demo = async (protocolParameters: ProtocolParametersRequiredByWallet): Promise<SelectionResult> => {
const csl: CardanoSerializationLib = await loadCardanoSerializationLib();
const selector: InputSelector = roundRobinRandomImprove(coinsPerUtxoWord);
// It is important that you use the same instance of cardano-serialization-lib across your application.
// Bad: TransactionUnspentOutput.new(...)
// Good: CSL.TransactionUnspentOutput.new(...)
const utxo: CSL.TransactionUnspentOutput[] = [CSL.TransactionUnspentOutput.new(...), ...];
const outputs: CSL.TransactionOutput[] = [CSL.TransactionOutput.new(...), ...];
// Used to estimate min fee and validate transaction size
const buildTx = (inputSelection: SelectionSkeleton): Promise<CSL.Transaction> => {...};
const constraints = defaultSelectionConstraints({
protocolParameters, buildTx,
});
return selector.select({
utxo,
outputs,
constraints,
});
};
Tests
Input selection is tested with property-based tests using fast-check, as well as a few regular example-based tests.
Due to nature of property-based tests, code coverage report is slightly different on each build.
RoundRobinRandomImprove has 100% code coverage when using high numRuns
option (e.g. 100_000).
Note that to run it with high numRuns
you need to increase Jest and fast-check timeout.
See code coverage report.
4 days ago
12 days ago
24 days ago
1 month ago
2 months ago
2 months ago
2 months ago
2 months ago
2 months ago
3 months ago
3 months ago
3 months ago
3 months ago
3 months ago
3 months ago
3 months ago
4 months ago
4 months ago
4 months ago
4 months ago
5 months ago
5 months ago
5 months ago
5 months ago
10 months ago
8 months ago
8 months ago
10 months ago
5 months ago
10 months ago
10 months ago
9 months ago
9 months ago
9 months ago
9 months ago
8 months ago
7 months ago
7 months ago
7 months ago
7 months ago
6 months ago
10 months ago
10 months ago
8 months ago
10 months ago
11 months ago
11 months ago
11 months ago
10 months ago
10 months ago
11 months ago
12 months ago
12 months ago
11 months ago
12 months ago
12 months ago
11 months ago
11 months ago
12 months ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
2 years ago
1 year ago
1 year ago
1 year ago
1 year ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago