feat: finalize call api

[lwshang]

SDK-1950

Description

For maintainable better user experience, this PR made some fundamental changes to the inter-canister call API (call.rs).

Constructors

Replaced Call::new() with Call::bounded_wait() and Call::unbounded_wait().

Execution

• impl IntoFuture for Call. So that a Call can be .await directly instead of invoking the call* method. No awkward Call::new().call() syntax.

• Replaced the oneway execution with the shorter and clearer Call::oneway() method.

• After a Call is executed by await , a candid()/candid_tuple() method can be chained to decode the response.

Errors

• Error: The top-level error type encapsulating all possible errors.
• CallFailed: Errors related to the execution of the call itself.
• CallRejected: Errors when an inter-canister call is rejected.
• CallPerformFailed: Errors when the ic0.call_perform operation fails.
• CandidDecodeFailed: Errors when the response cannot be decoded as Candid.

Error
├── CallFailed
│   ├── CallPerformFailed
│   └── CallRejected
└── CandidDecodeFailed

Also a CallErrorExt trait is added and implemented for all error types above.
The trait has two methods:

• is_clean_reject()
• is_immediately_retryable()

Note

The CallErrorExt trait must be explicitly imported to access its methods.

How Has This Been Tested?

e2e tests: call.rs

Checklist:

• The title of this PR complies with Conventional Commits.
• I have edited the CHANGELOG accordingly.
• I have made corresponding changes to the documentation.