feat(dart/catalyst_cardano_serialization)!: Implement tiered fee calculation for reference scripts

[ilap]

Description

This pull request implements the tiered fee calculation model introduced in the Cardano Conway era (Chang Hardfork).

Related Issue(s)

Closes #870

Description of Changes

• Replaced the existing LinearFee model with a TieredFee model that applies progressively higher fees for reference script sizes beyond the initial 25KiB.
• Renamed minNoScriptFee() to minFee() for better clarity.
• Added a method to calculate the length of reference scripts, contributing to the overall fee calculation.
• Introduced the ReferenceScriptSizeLimitExceededException class to handle cases where the reference script size exceeds defined limits.
• Added tests for the TieredFee class to ensure that it correctly calculates fees for transactions with reference scripts.
• Added unit tests for length calculations and fee calculations involving reference scripts.

Breaking Changes

• The renaming of minNoScriptFee() to minFee() may require adjustments in dependent modules that reference this method.
• The inputs field has been updated from List<TransactionUnspentOutput> to Set<TransactionUnspentOutput>. This may require adjustments in dependent code that expects a List instead of a Set.

Other than that, there are no significant breaking changes.

Please confirm the following checks

• My code follows the style guidelines of this project
• I have performed a self-review of my code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes
• Any dependent changes have been merged and published in downstream module

[dtscalac]

@ilap Thanks for the PR. Make sure to denote in the PR's title that it contains breaking changes. I updated this PR title.

[dtscalac]

@ilap The changes in catalyst_cardano_serialization have caused compile errors in other dependent packages, i.e. catalyst_cardano. These packages provide different functionalities, they build on top of catalyst_cardano_serialization but in short, we use them as a test for backward compatibility when changing the serialization package.

Would it be possible to adjust these compilation issues as well?

[dtscalac]

LGTM.

@stevenj Please support on merging the PR, I validated it successfully.

[stevenj]

@ilap Thank you again for the great contribution.

[ilap]

Hi @stevenj and @dtscalac,

Could you please update the version of the catalyst_cardano_serialization package and any related dependencies, and publish them on pub.dev?

Thanks in advance!

Cheers,
Pal

[dtscalac]

Hi @stevenj and @dtscalac,

Could you please update the version of the catalyst_cardano_serialization package and any related dependencies, and publish them on pub.dev?

Thanks in advance!

Cheers, Pal

Hi @ilap, thanks for reaching out. You can find the newly updates packages here: pub.dev

[ilap]

Hi @stevenj and @dtscalac,
Could you please update the version of the catalyst_cardano_serialization package and any related dependencies, and publish them on pub.dev?
Thanks in advance!
Cheers, Pal

Hi @ilap, thanks for reaching out. You can find the newly updates packages here: pub.dev

Hi guys,

It seems the frb is not fully configured for the published catalyst_key_derivation package, as I ran into error when I tried to use it in some flutter example.

  Compiling catalyst_key_derivation v0.1.0 (......./catalyst-voices/catalyst_voices/packages/libs/catalyst_key_derivation/rust)
error[E0583]: file not found for module `frb_generated`
  --> src/lib.rs:20:1
   |
20 | mod frb_generated;
   | ^^^^^^^^^^^^^^^^^^
   |
   = help: to create the module `frb_generated`, create file "src/frb_generated.rs" or "src/frb_generated/mod.rs"
   = note: if there is a `mod frb_generated` elsewhere in the crate already, import it with `use crate::...` instead

error[E0432]: unresolved import `crate::frb_generated::FLUTTER_RUST_BRIDGE_HANDLER`
  --> src/api/key_derivation/mod.rs:14:5
   |
14 | use crate::frb_generated::FLUTTER_RUST_BRIDGE_HANDLER;
   |     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ no `FLUTTER_RUST_BRIDGE_HANDLER` in `frb_generated`

Some errors have detailed explanations: E0432, E0583.
For more information about an error, try `rustc --explain E0432`.
error: could not compile `catalyst_key_derivation` (lib) due to 2 previous errors

[dtscalac]

@ilap can you share your sample? Was it a web project or android/ios?

[ilap]

@ilap can you share your sample? Was it a web project or android/ios?

Hey @dtscalac,

We should continue this discussion in the issue #1471