clear-signing 0.1.0

ERC-7730 v2 clear signing library: decodes and formats Ethereum calldata and EIP-712 typed data for human-readable display.
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

//! Unified async data provider trait for external data resolution.
//!
//! Wallets implement [`DataProvider`] to supply token metadata, address names,
//! and NFT collection names during formatting.

use std::future::Future;
use std::pin::Pin;

use crate::token::TokenMeta;

/// Async data provider for external data resolution during formatting.
///
/// Wallets implement this trait to supply token metadata, ENS/local address names,
/// and NFT collection names. All methods have default implementations returning `None`,
/// so implementors only need to override the methods they support.
pub trait DataProvider: Send + Sync {
    /// Resolve token metadata (symbol, decimals, name) for a given chain and address.
    fn resolve_token(
        &self,
        chain_id: u64,
        address: &str,
    ) -> Pin<Box<dyn Future<Output = Option<TokenMeta>> + Send + '_>> {
        let _ = (chain_id, address);
        Box::pin(async { None })
    }

    /// Resolve an ENS name for an address.
    ///
    /// `types` hints the expected address role (e.g. `["eoa"]`, `["contract"]`).
    fn resolve_ens_name(
        &self,
        address: &str,
        chain_id: u64,
        types: Option<&[String]>,
    ) -> Pin<Box<dyn Future<Output = Option<String>> + Send + '_>> {
        let _ = (address, chain_id, types);
        Box::pin(async { None })
    }

    /// Resolve a local/contact name for an address.
    ///
    /// `types` hints the expected address role (e.g. `["eoa"]`, `["contract"]`).
    fn resolve_local_name(
        &self,
        address: &str,
        chain_id: u64,
        types: Option<&[String]>,
    ) -> Pin<Box<dyn Future<Output = Option<String>> + Send + '_>> {
        let _ = (address, chain_id, types);
        Box::pin(async { None })
    }

    /// Resolve an NFT collection name for a collection contract address.
    fn resolve_nft_collection_name(
        &self,
        collection_address: &str,
        chain_id: u64,
    ) -> Pin<Box<dyn Future<Output = Option<String>> + Send + '_>> {
        let _ = (collection_address, chain_id);
        Box::pin(async { None })
    }

    /// Resolve an approximate unix timestamp for a given block number.
    fn resolve_block_timestamp(
        &self,
        chain_id: u64,
        block_number: u64,
    ) -> Pin<Box<dyn Future<Output = Option<u64>> + Send + '_>> {
        let _ = (chain_id, block_number);
        Box::pin(async { None })
    }
}

/// No-op data provider — all methods return `None`.
pub struct EmptyDataProvider;

impl DataProvider for EmptyDataProvider {}