Struct CosmosKeysService 

pub struct CosmosKeysService { /* private fields */ }

Implementations

impl CosmosKeysService

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

Creates a new CosmosKeysService instance.

Arguments

• config - The configuration object used to initialize the service.
• crypto_service - The cryptographic service used for signing and key management.

Errors

Returns an error string if the KeysService fails to initialize.

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

Resolves a Cosmos-compatible public key from a key identifier.

If the provided key is already a valid 33-byte compressed public key in hex format (expected length COSMOS_SECP_LEN), it is returned as-is. Otherwise, the key is assumed to be an alias or identifier managed by the KMS, and the corresponding public key is fetched from the KMS and serialized for use with Cosmos.

Errors

Returns an error if:

• The KMS fails to return a public key for the given alias.
• The returned key cannot be converted into a valid Cosmos-compatible public key.

Trait Implementations

impl KeysServiceTrait for CosmosKeysService

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, 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 internal sign method.

Arguments

• config - Reference to the application configuration to determine signing mode.
• transaction_hash - The hash of the transaction to be signed.
• key - The key alias 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 Cosmos 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 Cosmos mode is supported.
• transaction_str - A JSON string representing the transaction to be signed.
• key - The key alias corresponding to the signing key.

Errors

Returns an error if:

• The application is not in Cosmos 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_hex: &'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_hex: &'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.