Struct EthereumKeysService 

pub struct EthereumKeysService { /* private fields */ }

Implementations

impl EthereumKeysService

pub async fn new( config: Config, crypto_service: CryptoService, ) -> Result<Self, String>

Creates a new instance of the service.

Parameters

• config: The configuration settings for the service.
• crypto_service: The cryptographic service used for key management.

Returns

Returns Ok(Self) if the service is successfully created, or an Err(String) containing an error message if initialization fails.

Errors

This function returns an error if the underlying KeysService::new call fails, propagating its error as a string.

impl EthereumKeysService

pub async fn resolve_public_key(&mut self, key: &str) -> Result<String, String>

Resolves a key string to its corresponding public key.

If the input key is already a compressed secp256k1 public key (determined by its length), it is returned directly. Otherwise, it is treated as an alias and resolved via the KMS service, followed by conversion to a usable public key format.

Parameters

• key: A compressed public key or a key alias.

Returns

• Ok(String): The resolved public key as a hex string.
• Err(String): An error message if resolution or conversion fails.

Errors

Returns an error if:

• The public key cannot be retrieved from the KMS for the given alias.
• Conversion from raw public key bytes to the expected hex format fails.

Trait Implementations

impl KeysServiceTrait for EthereumKeysService

fn create_key<'life0, 'life1, 'async_trait>( &'life0 mut self, _config: &'life1 Config, ) -> Pin<Box<dyn Future<Output = Result<KeyEntry, String>> + Send + 'async_trait>>

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

Creates a new KMS key, derives its public key with an optional prefix based on config, registers an alias for it, and returns the formatted public key.

Arguments

• config - Reference to the config struct used to decide prefixing.

Errors

Returns an error if key creation, public key conversion, or alias creation fails.

fn sign_transaction_hash<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 mut self, config: &'life1 Config, transaction_hash: &'life2 str, key: &'life3 str, ) -> Pin<Box<dyn Future<Output = Result<SigEntry, String>> + Send + 'async_trait>>

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

Signs a transaction hash using the provided public key and configuration mode.

Delegates signing to the keys service sign method.

Arguments

• config - Reference to the application configuration to determine signing mode.
• transaction_hash - The hash of the transaction to be signed.
• public_key - The public key corresponding to the private key for signing.

Errors

Returns an error if the signing operation fails.

fn sign_transaction<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 mut self, config: &'life1 Config, transaction_str: &'life2 str, key: &'life3 str, ) -> Pin<Box<dyn Future<Output = Result<String, String>> + Send + 'async_trait>>

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

Signs a serialized Ethereum transaction using the provided public key.

Parses the input transaction string, verifies the transaction hash and public key, signs the hash, attaches the signature to the transaction, and returns the signed transaction as a JSON string.

Arguments

• config - Reference to the application configuration. Only Ethereum mode is supported.
• transaction_str - A JSON string representing the transaction to be signed.
• public_key - The public key corresponding to the signing key.

Errors

Returns an error if:

• The application is not in Ethereum mode.
• The transaction JSON is invalid.
• The transaction hash or public key is invalid.
• The signing process fails.
• The final transaction serialization fails.

fn verify<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 mut self, transaction_hash: &'life1 str, signature_hex: &'life2 str, key: &'life3 str, ) -> Pin<Box<dyn Future<Output = Result<bool, String>> + Send + 'async_trait>>

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

Verifies that the given signature is valid for the provided transaction hash and public key.

fn verify_via_kms<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 mut self, transaction_hash: &'life1 str, signature_hex: &'life2 str, key: &'life3 str, ) -> Pin<Box<dyn Future<Output = Result<bool, String>> + Send + 'async_trait>>

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

Verifies a transaction hash using an external KMS (Key Management System).

fn delete_key<'life0, 'life1, 'async_trait>( &'life0 mut self, key: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<bool, String>> + Send + 'async_trait>>

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

Deletes the cryptographic key associated with the given key.

fn list_keys<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<Vec<KeyEntry>, String>> + Send + 'async_trait>>

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

Lists all available public keys and their metadata.