Struct CasperKeysService 

pub struct CasperKeysService { /* private fields */ }

Implementations

impl CasperKeysService

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

Creates a new CasperKeysService instance.

Errors

Returns an error if the KeysService initialization fails.

Trait Implementations

impl KeysServiceTrait for CasperKeysService

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 keys_serviced 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.

Selects a prefix keys_serviced on the active mode (Casper or Ethereum), and 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.
• 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 Casper 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 Casper 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 Casper 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.