openethereum/src/header.rs

use util::*;
use basic_types::*;
use time::now_utc;

/// Type for Block number
pub type BlockNumber = u64;

/// A block header.
///
/// Reflects the specific RLP fields of a block in the chain with additional room for the seal
/// which is non-specific.
///
/// Doesn't do all that much on its own.
#[derive(Default, Debug, Clone)]
pub struct Header {
	// TODO: make all private.
	/// TODO [Gav Wood] Please document me
	pub parent_hash: H256,
	/// TODO [arkpar] Please document me
	pub timestamp: u64,
	/// TODO [debris] Please document me
	pub number: BlockNumber,
	/// TODO [Gav Wood] Please document me
	pub author: Address,

	/// TODO [debris] Please document me
	pub transactions_root: H256,
	/// TODO [debris] Please document me
	pub uncles_hash: H256,
	/// TODO [Gav Wood] Please document me
	pub extra_data: Bytes,

	/// TODO [debris] Please document me
	pub state_root: H256,
	/// TODO [debris] Please document me
	pub receipts_root: H256,
	/// TODO [debris] Please document me
	pub log_bloom: LogBloom,
	/// TODO [debris] Please document me
	pub gas_used: U256,
	/// TODO [Gav Wood] Please document me
	pub gas_limit: U256,

	/// TODO [debris] Please document me
	pub difficulty: U256,
	/// TODO [arkpar] Please document me
	pub seal: Vec<Bytes>,

	/// TODO [arkpar] Please document me
	pub hash: RefCell<Option<H256>>,
	/// TODO [Gav Wood] Please document me
	pub bare_hash: RefCell<Option<H256>>,
}

impl Header {
	/// Create a new, default-valued, header.
	pub fn new() -> Header {
		Header {
			parent_hash: ZERO_H256.clone(),
			timestamp: 0,
			number: 0,
			author: ZERO_ADDRESS.clone(),

			transactions_root: SHA3_NULL_RLP,
			uncles_hash: SHA3_EMPTY_LIST_RLP,
			extra_data: vec![],

			state_root: SHA3_NULL_RLP,
			receipts_root: SHA3_NULL_RLP,
			log_bloom: ZERO_LOGBLOOM.clone(),
			gas_used: ZERO_U256,
			gas_limit: ZERO_U256,

			difficulty: ZERO_U256,
			seal: vec![],
			hash: RefCell::new(None),
			bare_hash: RefCell::new(None),
		}
	}

	/// TODO [Gav Wood] Please document me
	pub fn number(&self) -> BlockNumber { self.number }
	/// TODO [Gav Wood] Please document me
	pub fn timestamp(&self) -> u64 { self.timestamp }
	/// TODO [Gav Wood] Please document me
	pub fn author(&self) -> &Address { &self.author }

	/// TODO [Gav Wood] Please document me
	pub fn extra_data(&self) -> &Bytes { &self.extra_data }

	/// TODO [Gav Wood] Please document me
	pub fn state_root(&self) -> &H256 { &self.state_root }
	/// TODO [Gav Wood] Please document me
	pub fn receipts_root(&self) -> &H256 { &self.receipts_root }
	/// TODO [Gav Wood] Please document me
	pub fn gas_limit(&self) -> &U256 { &self.gas_limit }

	/// TODO [Gav Wood] Please document me
	pub fn difficulty(&self) -> &U256 { &self.difficulty }
	/// TODO [Gav Wood] Please document me
	pub fn seal(&self) -> &Vec<Bytes> { &self.seal }

	// TODO: seal_at, set_seal_at &c.

	/// TODO [Gav Wood] Please document me
	pub fn set_number(&mut self, a: BlockNumber) { self.number = a; self.note_dirty(); }
	/// TODO [Gav Wood] Please document me
	pub fn set_timestamp(&mut self, a: u64) { self.timestamp = a; self.note_dirty(); }
	/// TODO [Gav Wood] Please document me
	pub fn set_timestamp_now(&mut self) { self.timestamp = now_utc().to_timespec().sec as u64; self.note_dirty(); }
	/// TODO [Gav Wood] Please document me
	pub fn set_author(&mut self, a: Address) { if a != self.author { self.author = a; self.note_dirty(); } }

	/// TODO [Gav Wood] Please document me
	pub fn set_extra_data(&mut self, a: Bytes) { if a != self.extra_data { self.extra_data = a; self.note_dirty(); } }

	/// TODO [Gav Wood] Please document me
	pub fn set_gas_used(&mut self, a: U256) { self.gas_used = a; self.note_dirty(); }
	/// TODO [Gav Wood] Please document me
	pub fn set_gas_limit(&mut self, a: U256) { self.gas_limit = a; self.note_dirty(); }

	/// TODO [Gav Wood] Please document me
	pub fn set_difficulty(&mut self, a: U256) { self.difficulty = a; self.note_dirty(); }
	/// TODO [Gav Wood] Please document me
	pub fn set_seal(&mut self, a: Vec<Bytes>) { self.seal = a; self.note_dirty(); }

	/// Get the hash of this header (sha3 of the RLP).
	pub fn hash(&self) -> H256 {
 		let mut hash = self.hash.borrow_mut();
 		match &mut *hash {
 			&mut Some(ref h) => h.clone(),
 			hash @ &mut None => {
 				*hash = Some(self.rlp_sha3(Seal::With));
 				hash.as_ref().unwrap().clone()
 			}
		}
	}

	/// Get the hash of the header excluding the seal
	pub fn bare_hash(&self) -> H256 {
		let mut hash = self.bare_hash.borrow_mut();
		match &mut *hash {
			&mut Some(ref h) => h.clone(),
			hash @ &mut None => {
				*hash = Some(self.rlp_sha3(Seal::Without));
				hash.as_ref().unwrap().clone()
			}
		}
	}

	/// Note that some fields have changed. Resets the memoised hash.
	pub fn note_dirty(&self) {
 		*self.hash.borrow_mut() = None;
 		*self.bare_hash.borrow_mut() = None;
	}

	// TODO: make these functions traity 
	/// TODO [Gav Wood] Please document me
	pub fn stream_rlp(&self, s: &mut RlpStream, with_seal: Seal) {
		s.begin_list(13 + match with_seal { Seal::With => self.seal.len(), _ => 0 });
		s.append(&self.parent_hash);
		s.append(&self.uncles_hash);
		s.append(&self.author);
		s.append(&self.state_root);
		s.append(&self.transactions_root);
		s.append(&self.receipts_root);
		s.append(&self.log_bloom);
		s.append(&self.difficulty);
		s.append(&self.number);
		s.append(&self.gas_limit);
		s.append(&self.gas_used);
		s.append(&self.timestamp);
		s.append(&self.extra_data);
		if let Seal::With = with_seal {
			for b in &self.seal { 
				s.append_raw(&b, 1); 
			}
		}
	}

	/// TODO [Gav Wood] Please document me
	pub fn rlp(&self, with_seal: Seal) -> Bytes {
		let mut s = RlpStream::new();
		self.stream_rlp(&mut s, with_seal);
		s.out()
	}

	/// TODO [debris] Please document me
	pub fn rlp_sha3(&self, with_seal: Seal) -> H256 { self.rlp(with_seal).sha3() }
}

impl Decodable for Header {
	fn decode<D>(decoder: &D) -> Result<Self, DecoderError> where D: Decoder {
		let r = decoder.as_rlp();

		let mut blockheader = Header {
			parent_hash: try!(r.val_at(0)),
			uncles_hash: try!(r.val_at(1)),
			author: try!(r.val_at(2)),
			state_root: try!(r.val_at(3)),
			transactions_root: try!(r.val_at(4)),
			receipts_root: try!(r.val_at(5)),
			log_bloom: try!(r.val_at(6)),
			difficulty: try!(r.val_at(7)),
			number: try!(r.val_at(8)),
			gas_limit: try!(r.val_at(9)),
			gas_used: try!(r.val_at(10)),
			timestamp: try!(r.val_at(11)),
			extra_data: try!(r.val_at(12)),
			seal: vec![],
			hash: RefCell::new(Some(r.as_raw().sha3())),
			bare_hash: RefCell::new(None),
		};

		for i in 13..r.item_count() {
			blockheader.seal.push(try!(r.at(i)).as_raw().to_vec())
		}

		Ok(blockheader)
	}
}

impl Encodable for Header {
	fn rlp_append(&self, s: &mut RlpStream) {
		self.stream_rlp(s, Seal::With);
	}
}

#[cfg(test)]
mod tests {
}