feat: fees and tip helpers

[PhilippeR26]

Motivation and Resolution

1. Tip is now operational in Rpc 0.9. Nothing is helping the user to choose a value.
2. ResourceBounds customization. It's complicated to customize the margins.
3. It's not easy to get the 3 gas prices.

Usage related changes

Based on what is available in Ethereum SDKs (viem, ethers, web3), some new helpers are added:
These functions are available only for Rpc 0.8 onwards.

1. To get blockchain statistics of the use of Tip:

const tipStats0: TipStats | undefined = await myProvider.getTipStatsFromBlocks();

Note

default values are highly negociable.

2. To customize easily the margins of a ressourceBounds:

const estimate: EstimateFee = await account0.estimateInvokeFee(myCall);
const resourceBounds = stark.setResourceBounds(estimate, 100, 10);
const res = await account0.execute(myCall, {
    resourceBounds,
    tip: 1n * 10n ** 9n
});

3. To get the gas prices:

const gasPrices0: GasPrices = await myProvider.getGasPrices();

Development related changes

• getGasPrices() and getTipStatsFromBlocks() are located in RPC08.RpcChannel.
• setResourceBounds() is located in stark/rpc08.
• new types are in a new tip.type.ts file, in provider/types.

Important

PR to merge in the RPC 0.9 branch.

Note

• in this draft PR, the new features are implemented in RPC 0.8. To see where will be the right final location.
• tests & guides are not yet implemented.

Checklist:

• Performed a self-review of the code
• Rebased to the last commit of the target branch (or merged it into my branch)
• Documented the changes in code (API docs will be generated automatically)
• Updated the tests
• All tests are passing

[tabaktoni]

Now can use toOverheadResourceBounds

[PhilippeR26]

As discussed, only item 3 has been kept.

[tabaktoni]

Why dont add implementation also to RPC 0.8 and include it into Provider ?

[PhilippeR26]

Modified.

[tabaktoni]

LGTM

[github-actions]

🎉 This PR is included in version 8.1.0 🎉

The release is available on:

• npm package (@next dist-tag)
• GitHub release

Your semantic-release bot 📦🚀