Struct ethers_signers::AwsSigner

pub struct AwsSigner { /* private fields */ }

Available on crate feature aws only.

An ethers Signer that uses keys held in Amazon AWS KMS.

The AWS Signer passes signing requests to the cloud service. AWS KMS keys are identified by a UUID, the key_id.

Because the public key is unknown, we retrieve it on instantiation of the signer. This means that the new function is async and must be called within some runtime.

use rusoto_core::Client;
use rusoto_kms::{Kms, KmsClient};

user ethers_signers::Signer;

let client = Client::new_with(
    EnvironmentProvider::default(),
    HttpClient::new().unwrap()
);
let kms_client = KmsClient::new_with_client(client, Region::UsWest1);
let key_id = "...";
let chain_id = 1;

let signer = AwsSigner::new(kms_client, key_id, chain_id).await?;
let sig = signer.sign_message(H256::zero()).await?;

Implementations

impl AwsSigner

pub async fn new<T>( kms: KmsClient, key_id: T, chain_id: u64 ) -> Result<AwsSigner, AwsSignerError>

where T: AsRef<str>,

Instantiate a new signer from an existing KmsClient and Key ID.

This function retrieves the public key from AWS and calculates the Etheruem address. It is therefore async.

pub async fn get_pubkey_for_key<T>( &self, key_id: T ) -> Result<VerifyingKey, AwsSignerError>

where T: AsRef<str>,

Fetch the pubkey associated with a key id

pub async fn get_pubkey(&self) -> Result<VerifyingKey, AwsSignerError>

Fetch the pubkey associated with this signer’s key ID

pub async fn sign_digest_with_key<T>( &self, key_id: T, digest: [u8; 32] ) -> Result<KSig, AwsSignerError>

where T: AsRef<str>,

Sign a digest with the key associated with a key id

pub async fn sign_digest( &self, digest: [u8; 32] ) -> Result<KSig, AwsSignerError>

Sign a digest with this signer’s key

Trait Implementations

impl Clone for AwsSigner

fn clone(&self) -> AwsSigner

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AwsSigner

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for AwsSigner

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Signer for AwsSigner

fn chain_id(&self) -> u64

Returns the signer’s chain id

fn with_chain_id<T: Into<u64>>(self, chain_id: T) -> Self

Sets the signer’s chain id

type Error = AwsSignerError

fn sign_message<'life0, 'async_trait, S>( &'life0 self, message: S ) -> Pin<Box<dyn Future<Output = Result<EthSig, Self::Error>> + Send + 'async_trait>>

where S: 'async_trait + Send + Sync + AsRef<[u8]>, Self: 'async_trait, 'life0: 'async_trait,

Signs the hash of the provided message after prefixing it

fn sign_transaction<'life0, 'life1, 'async_trait>( &'life0 self, tx: &'life1 TypedTransaction ) -> Pin<Box<dyn Future<Output = Result<EthSig, Self::Error>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Signs the transaction

fn sign_typed_data<'life0, 'life1, 'async_trait, T>( &'life0 self, payload: &'life1 T ) -> Pin<Box<dyn Future<Output = Result<EthSig, Self::Error>> + Send + 'async_trait>>

where T: 'async_trait + Eip712 + Send + Sync, Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Encodes and signs the typed data according EIP-712. Payload must implement Eip712 trait.

fn address(&self) -> Address

Returns the signer’s Ethereum Address