Chain

Struct Chain 

Source
pub struct Chain {
    pub chain: Vec<Block>,
    pub transactions: ChainTransactions,
    pub difficulty: f64,
    pub address: String,
    pub reward: f64,
    pub fee: f64,
    pub wallets: ChainWallets,
}
Expand description

Blockchain.

Fields§

§chain: Vec<Block>

Chain of blocks.

§transactions: ChainTransactions

List of transactions.

§difficulty: f64

Current difficulty level of the network.

§address: String

Blockchain genesis address.

§reward: f64

Block reward.

§fee: f64

Transaction fee.

§wallets: ChainWallets

Map to associate wallets with their corresponding addresses and balances.

Implementations§

Source§

impl Chain

Source

pub fn new(difficulty: f64, reward: f64, fee: f64) -> Self

Initialize a new blockchain with the specified parameters.

§Arguments
  • difficulty: The initial mining difficulty level of the network.
  • reward: The initial block reward for miners.
  • fee: The transaction fee.
§Returns

New Chain instance with the given parameters and a genesis block.

Source

pub fn get_transactions(&self, page: usize, size: usize) -> ChainTransactions

Get a list of current transactions in the blockchain.

§Arguments
  • page: The page number.
  • size: The number of transactions per page.
§Returns

A list of transactions for the specified page.

Source

pub fn get_transaction( &self, hash: &str, ) -> Result<&Transaction, BlockchainError>

Get a transaction by its identifier.

§Arguments
  • hash: The hash of the transaction to retrieve.
§Returns

An option containing a reference to the transaction if found, or None if not found.

Source

pub fn add_transaction( &mut self, from: String, to: String, amount: f64, ) -> Result<(), BlockchainError>

Add a new transaction to the blockchain.

§Arguments
  • from: The sender’s address.
  • to: The receiver’s address.
  • amount: The amount of the transaction.
§Returns

true if the transaction is successfully added to the current transactions.

Source

pub fn validate_transaction(&self, from: &str, to: &str, amount: f64) -> bool

Validate a transaction.

§Arguments
  • from: The sender’s address.
  • to: The receiver’s address.
  • amount: The amount of the transaction.
§Returns

true if the transaction is valid, false otherwise.

Source

pub fn create_wallet(&mut self, email: &str) -> String

Create a new wallet with a unique email and an initial balance.

§Arguments
  • email: The unique user email.
§Returns

The newly created wallet address.

Source

pub fn get_wallet_balance(&self, address: &str) -> Option<f64>

Get a wallet’s balance based on its address.

§Arguments
  • address: The unique wallet address.
§Returns

The wallet balance.

Source

pub fn get_wallet_transactions( &self, address: &str, page: usize, size: usize, ) -> Option<Vec<Transaction>>

Get a wallet’s transaction history based on its address.

§Arguments
  • address: The unique wallet address.
  • page: The page number.
  • size: The number of transactions per page.
§Returns

The wallet transaction history for the specified page.

Source

pub fn get_last_hash(&self) -> String

Get the hash of the last block in the blockchain.

§Returns

The hash of the last block in the blockchain as a string.

Source

pub fn update_difficulty(&mut self, difficulty: f64)

Update the mining difficulty of the blockchain.

§Arguments
  • difficulty: The new mining difficulty level.
Source

pub fn update_reward(&mut self, reward: f64)

Update the block reward.

§Arguments
  • reward: The new block reward value.
Source

pub fn update_fee(&mut self, fee: f64)

Update the transaction fee.

§Arguments
  • fee: The new transaction fee value.
Source

pub fn generate_new_block(&mut self) -> bool

Generate a new block and append it to the blockchain.

§Returns

true if a new block is successfully generated and added to the blockchain.

Source

pub fn get_merkle(transactions: ChainTransactions) -> String

Calculate the Merkle root hash for a list of transactions.

§Arguments
  • transactions: A vector of transactions for which the Merkle root hash is calculated.
§Returns

The Merkle root hash as a string.

Source

pub fn hash<T: Serialize>(item: &T) -> String

Calculate the SHA-256 hash of a serializable item.

§Arguments
  • item: A serializable item to be hashed.
§Returns

The SHA-256 hash of the item as a string.

Source

pub fn generate_address(length: usize) -> String

Generates a random alphanumeric string of a specified length.

§Arguments
  • length: The length of the generated string.
§Returns

A String containing the generated alphanumeric string.

Trait Implementations§

Source§

impl Clone for Chain

Source§

fn clone(&self) -> Chain

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Chain

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for Chain

Source§

fn default() -> Chain

Returns the “default value” for a type. Read more
Source§

impl<'de> Deserialize<'de> for Chain

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl Serialize for Chain

Source§

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. Read more

Auto Trait Implementations§

§

impl Freeze for Chain

§

impl RefUnwindSafe for Chain

§

impl Send for Chain

§

impl Sync for Chain

§

impl Unpin for Chain

§

impl UnwindSafe for Chain

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,