feat: signer interactivity (#617)

Makes signer implementations specify whether a signing operation is
"interactive" (or just expensive). Utilizing this new information,
`Account` and `AccountFactory` now make more informed decisions on
whether to request real signatures for different types of operations.

The most significant benefit of this change is allowing using hardware
wallet without excessive unnecessary signing requests.

Author: xJonathanLEI

README.md

@@ -100,9 +100,11 @@ Examples can be found in the [examples folder](./examples):
 
 10. [Deploy an OpenZeppelin account with Ledger](./examples/deploy_account_with_ledger.rs)
 
-11. [Parsing a JSON-RPC request on the server side](./examples/parse_jsonrpc_request.rs)
+11. [Transfer ERC20 tokens with Ledger](./examples/transfer_with_ledger.rs)
 
-12. [Inspecting a erased provider-specific error type](./examples/downcast_provider_error.rs)
+12. [Parsing a JSON-RPC request on the server side](./examples/parse_jsonrpc_request.rs)
+
+13. [Inspecting a erased provider-specific error type](./examples/downcast_provider_error.rs)
 
 ## License
 

examples/declare_cairo0_contract.rs

@@ -45,5 +45,6 @@ async fn main() {
         .await
         .unwrap();
 
-    dbg!(result);
+    println!("Transaction hash: {:#064x}", result.transaction_hash);
+    println!("Class hash: {:#064x}", result.class_hash);
 }

examples/declare_cairo1_contract.rs

@@ -53,5 +53,6 @@ async fn main() {
         .await
         .unwrap();
 
-    dbg!(result);
+    println!("Transaction hash: {:#064x}", result.transaction_hash);
+    println!("Class hash: {:#064x}", result.class_hash);
 }

examples/deploy_account_with_ledger.rs

@@ -51,6 +51,7 @@ async fn main() {
     match result {
         Ok(tx) => {
             println!("Transaction hash: {:#064x}", tx.transaction_hash);
+            println!("Account: {:#064x}", tx.contract_address);
         }
         Err(err) => {
             eprintln!("Error: {err}");

examples/deploy_argent_account.rs

@@ -47,6 +47,7 @@ async fn main() {
     match result {
         Ok(tx) => {
             println!("Transaction hash: {:#064x}", tx.transaction_hash);
+            println!("Account: {:#064x}", tx.contract_address);
         }
         Err(err) => {
             eprintln!("Error: {err}");

examples/mint_tokens.rs

@@ -51,5 +51,5 @@ async fn main() {
         .await
         .unwrap();
 
-    dbg!(result);
+    println!("Transaction hash: {:#064x}", result.transaction_hash);
 }

examples/transfer_with_ledger.rs

@@ -0,0 +1,57 @@
+use starknet::{
+    accounts::{Account, Call, ExecutionEncoding, SingleOwnerAccount},
+    core::{
+        chain_id,
+        types::{BlockId, BlockTag, Felt},
+        utils::get_selector_from_name,
+    },
+    macros::felt,
+    providers::{
+        jsonrpc::{HttpTransport, JsonRpcClient},
+        Url,
+    },
+    signers::LedgerSigner,
+};
+
+#[tokio::main]
+async fn main() {
+    let provider = JsonRpcClient::new(HttpTransport::new(
+        Url::parse("https://starknet-sepolia.public.blastapi.io/rpc/v0_7").unwrap(),
+    ));
+
+    let signer = LedgerSigner::new(
+        "m/2645'/1195502025'/1470455285'/0'/0'/0"
+            .try_into()
+            .expect("unable to parse path"),
+    )
+    .await
+    .expect("failed to initialize Starknet Ledger app");
+    let address = Felt::from_hex("YOUR_ACCOUNT_CONTRACT_ADDRESS_IN_HEX_HERE").unwrap();
+    let eth_token_address =
+        Felt::from_hex("0x049d36570d4e46f48e99674bd3fcc84644ddd6b96f7c741b1562b82f9e004dc7")
+            .unwrap();
+
+    let mut account = SingleOwnerAccount::new(
+        provider,
+        signer,
+        address,
+        chain_id::SEPOLIA,
+        ExecutionEncoding::New,
+    );
+
+    // `SingleOwnerAccount` defaults to checking nonce and estimating fees against the latest
+    // block. Optionally change the target block to pending with the following line:
+    account.set_block_id(BlockId::Tag(BlockTag::Pending));
+
+    let result = account
+        .execute_v1(vec![Call {
+            to: eth_token_address,
+            selector: get_selector_from_name("transfer").unwrap(),
+            calldata: vec![felt!("0x1234"), felt!("100"), Felt::ZERO],
+        }])
+        .send()
+        .await
+        .unwrap();
+
+    println!("Transaction hash: {:#064x}", result.transaction_hash);
+}