Struct KeysService 

pub struct KeysService {
    pub kms_client_service: Arc<dyn KmsClientService>,
    pub crypto_service: CryptoService,
}

Fields

kms_client_service: Arc<dyn KmsClientService>

crypto_service: CryptoService

Implementations

impl KeysService

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

Creates a new KeyService instance with the given config and crypto service.

Initializes the appropriate KMS client (AWS or else) based on the config.

Errors

Returns an error if the AWS KMS client fails to initialize.

pub async fn sign( &mut self, transaction_hash_hex: &str, key: &str, prefix: Option<&str>, ) -> Result<String, String>

Signs a given transaction hash using the specified key.

This function delegates signing to the underlying KMS client service, then converts the resulting signature into the expected format. An optional prefix can be prepended to the final signature string.

Parameters

• transaction_hash_hex: The transaction hash to sign, as a hex-encoded string.
• key: The key or alias to use for signing.
• prefix: An optional string slice to prepend to the signature (e.g., a format or type prefix).

Returns

• Ok(String): The formatted signature string, optionally prefixed.
• Err(String): An error message if signing or signature conversion fails.

Errors

Returns an error if:

• The KMS client service fails to produce a signature for the given hash and key.
• Conversion of the raw signature bytes into the desired format fails.

pub fn verify( &mut self, transaction_hash_hex: &str, signature_hex: &str, public_key: &str, ) -> Result<bool, String>

Verifies a signature against a transaction hash and public key.

Arguments

• transaction_hash_hex - The hex-encoded transaction hash to verify.
• signature_hex - The hex-encoded signature to verify.
• public_key - The public key to use for verification.

Errors

Returns an error string if the verification process fails.

Returns

Ok(true) if the signature is valid, Ok(false) if invalid.

pub fn verify_eip155( &mut self, transaction_hash_hex: &str, signature_hex: &str, public_key: &str, ) -> Result<bool, String>

Verifies an Ethereum EIP-155 signature against a transaction hash and public key.

Arguments

• transaction_hash_hex - The hex-encoded transaction hash to verify.
• signature_hex - The hex-encoded signature to verify.
• public_key - The public key to use for verification.

Errors

Returns an error string if the verification process fails.

Returns

Ok(true) if the signature is valid, Ok(false) if invalid.

pub async fn verify_via_kms( &mut self, transaction_hash_hex: &str, signature_hex: &str, public_key: &str, ) -> Result<bool, String>

Verifies a signature against a transaction hash and public key using both local crypto verification and KMS verification.

First, verifies the signature locally via the crypto service. If that succeeds, converts the signature to ASN.1 base64 format and verifies it via the KMS client.

Arguments

• transaction_hash_hex - Hex-encoded transaction hash to verify.
• signature_hex - Hex-encoded signature to verify.
• public_key - Public key used for verification.

Errors

Returns an error string if either local or KMS verification fails.

Returns

Ok(true) if both verifications pass, Ok(false) if local verification fails.

pub async fn verify_via_kms_eip155( &mut self, transaction_hash_hex: &str, signature_hex: &str, public_key: &str, ) -> Result<bool, String>

Verifies an EIP-155 signature and then confirms it via KMS.

This method first performs a cryptographic verification of the signature according to EIP-155. If that succeeds, it proceeds to verify the signature via the KMS service.

Parameters

• transaction_hash_hex: The transaction hash to verify, as a hex-encoded string.
• signature_hex: The signature to verify, as a hex-encoded string.
• public_key: The public key corresponding to the signer, as a hex string.

Returns

• Ok(true) if both cryptographic and KMS verifications succeed.
• Ok(false) if the cryptographic verification fails.
• Err(String) if any error occurs during verification.

Errors

Returns an error if:

• The inputs cannot be parsed or decoded correctly.
• The cryptographic verification process encounters an unexpected error.
• The KMS verification call fails or returns an error.

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

Deletes a key identified by the given key using the KMS client.

Arguments

• key - The key identifying the key to delete.

Errors

Returns an error string if the deletion fails.

Returns

Ok(true) if the key was successfully deleted.

pub async fn list_keys(&mut self) -> Result<Vec<KeyEntry>, String>

Retrieves a list of keys from the KMS client.

Errors

Returns an error string if the key listing fails.

Returns

Ok with a vector of KeyEntry