dart_web3_trezor #

Industry-standard Trezor hardware wallet integration for Dart. Communicates with Trezor One, Trezor T, and Trezor Safe devices via the Trezor Protobuf (Bridge) protocol.

🚀 Features #

• Protobuf Support: High-performance serialization using official Trezor message definitions.
• USB HID / Bridge: Direct communication on Desktop and support for Trezor Bridge on Web/Mobile.
• Passphrase Security: Native handling of the Trezor "hidden wallet" (passphrase) entry.
• Type-Safe Commands: Typed requests for Address, Signing, and CipherKey derivation.

Usage Flow #

sequenceDiagram
    participant A as App
    participant T as TrezorClient
    participant D as Device
    A->>T: connect()
    T->>D: Initialize
    A->>T: getAddress(path)
    T->>D: PB.GetAddress
    D-->>D: PIN Entry
    D-->>T: address result
    T-->>A: EthereumAddress

🏗️ Architecture #

graph LR
    App[Dart App] --> PB[Protobuf Encoder]
    PB --> Buffer[Byte Stream]
    Buffer --> Trezor[Trezor Device]
    
    subgraph UI [On-Device PIN]
        PIN[PIN Entry]
        Pass[Passphrase]
    end
    
    Trezor --> UI

📚 Technical Reference #

Core Classes #

🛡️ Security Considerations #

• PIN Entry: The SDK supports remote PIN entry for UI flexibility, but encourage users to enter PINs on the device (Trezor T) when possible for maximum security.
• Passphrase Risk: Emphasize that a lost Trezor passphrase means permanent loss of funds. The SDK provides clear hooks for passphrase prompting.
• Code Audit: The Trezor integration touches sensitive byte-level logic. This module is written in pure Dart to be easily auditable.

💻 Usage #

Signing a Message #

import 'package:dart_web3_trezor/dart_web3_trezor.dart';

void main() async {
  final trezor = TrezorClient.usb();
  await trezor.connect();

  final signature = await trezor.signMessage(
    message: "I am the owner of this wallet",
    path: "m/44'/60'/0'/0/0",
  );

  print('Signed by Trezor: $signature');
}

📦 Installation #

dependencies:
  dart_web3_trezor: ^0.1.0