Method for readonly calls

mpoplavkov · July 4, 2024, 3:04pm

Is there an analogue of TS get method for contracts in Rust SDK? To call read-only contract functions

anderson · July 4, 2024, 3:13pm

It looks like it’s in the making and should be available soon.

github.com/FuelLabs/fuels-rs

feat!: unfunded read only calls

FuelLabs:master ← FuelLabs:feature/read_only_calls

opened 03:19PM - 06 Jun 24 UTC

segfault-magnet

+525 -209

closes: #1405 Finishing a transaction builder (i.e. `.build(`) now requires… a `Context` object. ```rust #[derive(Debug, Clone, Default)] pub enum ScriptContext { /// Transaction is estimated and signatures are automatically added. #[default] Complete, /// Transaction is estimated but no signatures are added. /// Building without signatures will set the witness indexes of signed coins in the /// order as they appear in the inputs. Multiple coins with the same owner will have /// the same witness index. Make sure you sign the built transaction in the expected order. NoSignatures, /// No estimation is done and no signatures are added. Fake coins are added if no spendable inputs /// are present. Unused outputs are filled with variable outputs. Meant only for transactions that are to be dry-run with validations off. /// Useful for reading state with unfunded accounts. StateReadOnly, } ``` The transaction builder will proceed to finalize the transaction in a manner fitting the context the tx will be used in. Simulating a call now requires the user to tweak how the simulated call will be executed: ```rust /// Used to control simulations/dry-runs #[derive(Debug, Clone, Default)] pub enum Execution { /// The transaction will be subject to all validations -- the tx fee must be covered, witnesses /// and UTXOs must be valid, etc. #[default] Realistic, /// Most validation is disabled. Witnesses are replaced with fake ones, fake base assets are /// added if necessary. Unused outputs are filled with variable outputs. Useful for fetching state without needing an account /// with base assets. StateReadOnly, } ``` And that allows for actual read only calls ```rust let no_funds_wallet = WalletUnlocked::new_random(provider); let response = MyContract::new(contract_id, no_funds_wallet.clone()) .methods() .get(5, 6) .simulate(Execution::StateReadOnly) .await?; ``` # Breaking changes * `SizedAsciiString` no longer implements `AsRef<[u8]>`. To get the underlying bytes you can turn it into a `&str` via the new `AsRef<str>` and call `as_bytes()` on the `&str`: `sized_string.as_ref().as_bytes()`. * Transaction builders now require a `Context` object in their `build` methods. `Create`, `Upload`, `Upgrade` tx builders use `Context` while `Script` builders use `ScriptContext`. Refer to the rust docs for details on each context. * `.simulate()` now accepts an `Execution` argument allowing for realistic or state-read-only simulations. ### Checklist - [x] I have linked to any relevant issues. - [x] I have updated the documentation. - [x] I have added tests that prove my fix is effective or that my feature works. - [x] I have added necessary labels. - [x] I have done my best to ensure that my PR adheres to [the Fuel Labs Code Review Standards](https://github.com/FuelLabs/rfcs/blob/master/text/code-standards/external-contributors.md). - [x] I have requested a review from the relevant team or maintainers.

Topic		Replies	Views
Is it possible to call a read only function from an empty wallet or without a wallet? General	4	133	March 5, 2024
How to build a transaction without signatures in Rust SDK? Rust SDK	2	215	December 23, 2023
How to sign a transaction in Rust SDK? Rust SDK	1	242	December 23, 2023
Simulate Call as ContractID from WalletUnlocked? Rust SDK feedback	2	244	May 8, 2023
How to get txId from a ScriptCall? Rust SDK	18	563	June 20, 2023

Method for readonly calls

Related topics