Add a way to try to convert a transaction error into contract errors if present

[HenryMBaldwin]

The abigen! macro seems to generate enums with some special sauce for displaying when they're decorated with #[error_type] and #[error]. It seems unintuitive that theres no trivial way to attempt to convert/ extract one of the custom error enums from an Error::Transaction (returned from a '.simulate().await' or '.call().await') where reason is Reason::Failure. I think it may be as simple as generating something like this via abigen! (pseudo-code):

impl TryFrom<u64> for MyErrorEnum {
    fn try_from(revert_id: u64) -> Result<MyErrorEnum> {
        match revert_id {
            <revert-id-from-abi-1> => Ok(MyErrorEnum::ErrorOne),
            <revert-id-from-abi-2> => Ok(MyErrorEnum::ErrorTwo),
            ...,
            _ => return Err(),
}

Otherwise, it seems like the best way to do this is pattern matching on hardcoded values from the contract/abi, which is less robust to abi changes in future development.

[rymnc]

@IGI-111 do you think this is possible?

[IGI-111]

The SDK is allowed to treat client execution failure however it likes, so this is more of a structural question about how the SDK handles errors generally.

However, custom return codes must still be supported as a lot of sway code out there still does it the old fashioned way.

Moreover, some people may be relying on specific messages from the SDK (notably in the case of std errors which have their own custom handling) so breaking this without extensive testing or knowledge of the full implications will be dangerous and at least a breaking change.