32 releases (8 breaking)

new 0.8.1 Dec 16, 2024
0.7.3 Dec 5, 2024
0.7.0 Nov 28, 2024
0.2.0 Jul 16, 2024
0.0.0-reserved Nov 23, 2023

#270 in Magic Beans

Download history 18251/week @ 2024-08-27 22961/week @ 2024-09-03 23258/week @ 2024-09-10 26179/week @ 2024-09-17 25399/week @ 2024-09-24 31246/week @ 2024-10-01 38691/week @ 2024-10-08 40073/week @ 2024-10-15 40963/week @ 2024-10-22 36032/week @ 2024-10-29 40015/week @ 2024-11-05 34353/week @ 2024-11-12 36797/week @ 2024-11-19 40275/week @ 2024-11-26 43994/week @ 2024-12-03 38170/week @ 2024-12-10

165,238 downloads per month
Used in 119 crates (18 directly)

MIT/Apache

23KB
325 lines

alloy-signer

Ethereum signer abstraction.

You can implement the Signer trait to extend functionality to other signers such as Hardware Security Modules, KMS etc. See its documentation for more.

Signer implementations in Alloy:

Examples

Sign an Ethereum prefixed message (EIP-712):

use alloy_signer::{Signer, SignerSync};
use alloy_signer_local::PrivateKeySigner;

// Instantiate a signer.
let signer = PrivateKeySigner::random();

// Sign a message.
let message = "Some data";
let signature = signer.sign_message_sync(message.as_bytes())?;

// Recover the signer from the message.
let recovered = signature.recover_address_from_msg(message)?;
assert_eq!(recovered, signer.address());
# Ok::<_, Box<dyn std::error::Error>>(())

Sign a transaction:

use alloy_consensus::TxLegacy;
use alloy_primitives::{U256, address, bytes};
use alloy_signer::{Signer, SignerSync};
use alloy_signer_local::PrivateKeySigner;
use alloy_network::{TxSignerSync};

// Instantiate a signer.
let signer = "dcf2cbdd171a21c480aa7f53d77f31bb102282b3ff099c78e3118b37348c72f7"
    .parse::<PrivateKeySigner>()?;

// Create a transaction.
let mut tx = TxLegacy {
    to: address!("d8dA6BF26964aF9D7eEd9e03E53415D37aA96045").into(),
    value: U256::from(1_000_000_000),
    gas_limit: 2_000_000,
    nonce: 0,
    gas_price: 21_000_000_000,
    input: bytes!(),
    chain_id: Some(1),
};

// Sign it.
let signature = signer.sign_transaction_sync(&mut tx)?;
# Ok::<_, Box<dyn std::error::Error>>(())

Dependencies

~17MB
~364K SLoC