ledger-sdk-eth-app 0.0.1

Ledger Ethereum app interaction helpers with EIP-712 support
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

# Ledger SDK Rust


A modular Rust SDK for communicating with Ledger hardware wallets, featuring comprehensive Ethereum app support including EIP-712 typed data signing.

## Features


- **Modular Architecture**: Clean separation of concerns across multiple crates
- **Ethereum Support**: Full Ethereum app integration with EIP-712 typed data signing
- **Transport Abstraction**: Support for multiple transport layers (HID, etc.)
- **Type Safety**: Strongly typed APIs with comprehensive error handling
- **Async Support**: Built on async/await for modern Rust applications

## Crates


| Crate                                                                   | Description                        | Version                                                                                                                 |
| ----------------------------------------------------------------------- | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| [`ledger-apdu`](https://crates.io/crates/ledger-apdu)                   | APDU types and helpers             | [![crates.io](https://img.shields.io/crates/v/ledger-apdu.svg)](https://crates.io/crates/ledger-apdu)                   |
| [`ledger-transport`](https://crates.io/crates/ledger-transport)         | Transport abstraction layer        | [![crates.io](https://img.shields.io/crates/v/ledger-transport.svg)](https://crates.io/crates/ledger-transport)         |
| [`ledger-transport-hid`](https://crates.io/crates/ledger-transport-hid) | HID transport implementation       | [![crates.io](https://img.shields.io/crates/v/ledger-transport-hid.svg)](https://crates.io/crates/ledger-transport-hid) |
| [`ledger-device-base`](https://crates.io/crates/ledger-device-base)     | Device and app information helpers | [![crates.io](https://img.shields.io/crates/v/ledger-device-base.svg)](https://crates.io/crates/ledger-device-base)     |
| [`ledger-eth-app`](https://crates.io/crates/ledger-eth-app)             | Ethereum app with EIP-712 support  | [![crates.io](https://img.shields.io/crates/v/ledger-eth-app.svg)](https://crates.io/crates/ledger-eth-app)             |

## Installation


Add the desired crates to your `Cargo.toml`:

```toml
[dependencies]
ledger-sdk-eth-app = "0.0.1"
ledger-sdk-transport-hid = "0.0.1"
```

## Quick Start


### Basic Ethereum Operations


```rust
use ledger_sdk_eth_app::EthApp;
use ledger_sdk_transport_hid::TransportNativeHID;
use ledger_sdk_eth_app::types::BipPath;

#[tokio::main]

async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Create HID transport
    let transport = TransportNativeHID::new()?;

    // Create Ethereum app instance
    let eth_app = EthApp::new();

    // Get address for derivation path
    let path = BipPath::from_string("44'/60'/0'/0/0")?;
    let address = eth_app.get_address(&transport, &path).await?;

    println!("Address: {}", address);
    Ok(())
}
```

### EIP-712 Typed Data Signing


```rust
use ledger_sdk_eth_app::EthApp;
use ledger_sdk_eth_app::commands::eip712::SignEip712TypedData;
use serde_json::json;

#[tokio::main]

async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let transport = TransportNativeHID::new()?;
    let eth_app = EthApp::new();

    // EIP-712 typed data
    let typed_data = json!({
        "domain": {
            "name": "MyApp",
            "version": "1",
            "chainId": 1,
            "verifyingContract": "0x1234567890123456789012345678901234567890"
        },
        "types": {
            "Person": [
                {"name": "name", "type": "string"},
                {"name": "wallet", "type": "address"}
            ]
        },
        "primaryType": "Person",
        "message": {
            "name": "Alice",
            "wallet": "0x1234567890123456789012345678901234567890"
        }
    });

    let path = BipPath::from_string("44'/60'/0'/0/0")?;
    let signature = eth_app.sign_eip712_from_json(&transport, &path, &typed_data.to_string()).await?;

    println!("Signature: {:?}", signature);
    Ok(())
}
```

## Building


```bash
# Build all crates

cargo build

# Run tests

cargo test

# Run examples

cargo run --example basic_test
```

## Examples


Check the `examples/` directory for more comprehensive usage examples:

- `basic_test.rs` - Basic Ethereum operations
- `usdc_permit_example.rs` - USDC permit signing with EIP-712

## License


Licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for details.

## Attribution


Portions of this code are derived from the Zondax `ledger-rs` project (Apache-2.0). See [NOTICE](NOTICE) for details.