use std::collections::{VecDeque, HashMap}; use ciphersuite::{group::GroupEncoding, Ciphersuite, Ristretto}; use serai_db::{DbTxn, Db}; use scale::Decode; use tendermint::ext::{Network, Commit}; use crate::{ ReadWrite, ProvidedError, ProvidedTransactions, BlockError, Block, Mempool, Transaction, transaction::{Signed, TransactionKind, TransactionError, Transaction as TransactionTrait}, }; #[derive(Debug)] pub(crate) struct Blockchain { db: Option, genesis: [u8; 32], block_number: u32, tip: [u8; 32], next_nonces: HashMap<::G, u32>, provided: ProvidedTransactions, mempool: Mempool, pub(crate) next_block_notifications: VecDeque>, } impl Blockchain { fn tip_key(genesis: [u8; 32]) -> Vec { D::key(b"tributary_blockchain", b"tip", genesis) } fn block_number_key(&self) -> Vec { D::key(b"tributary_blockchain", b"block_number", self.genesis) } fn block_key(genesis: &[u8], hash: &[u8; 32]) -> Vec { D::key(b"tributary_blockchain", b"block", [genesis, hash].concat()) } fn block_hash_key(genesis: &[u8], block_number: u32) -> Vec { D::key(b"tributary_blockchain", b"block_hash", [genesis, &block_number.to_le_bytes()].concat()) } fn commit_key(genesis: &[u8], hash: &[u8; 32]) -> Vec { D::key(b"tributary_blockchain", b"commit", [genesis, hash].concat()) } fn block_after_key(genesis: &[u8], hash: &[u8; 32]) -> Vec { D::key(b"tributary_blockchain", b"block_after", [genesis, hash].concat()) } fn unsigned_included_key(genesis: &[u8], hash: &[u8; 32]) -> Vec { D::key(b"tributary_blockchain", b"unsigned_included", [genesis, hash].concat()) } fn provided_included_key(genesis: &[u8], hash: &[u8; 32]) -> Vec { D::key(b"tributary_blockchain", b"provided_included", [genesis, hash].concat()) } fn next_nonce_key(&self, signer: &::G) -> Vec { D::key( b"tributary_blockchain", b"next_nonce", [self.genesis.as_ref(), signer.to_bytes().as_ref()].concat(), ) } pub(crate) fn new( db: D, genesis: [u8; 32], participants: &[::G], ) -> Self { let mut next_nonces = HashMap::new(); for participant in participants { next_nonces.insert(*participant, 0); } let mut res = Self { db: Some(db.clone()), genesis, block_number: 0, tip: genesis, next_nonces, provided: ProvidedTransactions::new(db.clone(), genesis), mempool: Mempool::new(db, genesis), next_block_notifications: VecDeque::new(), }; if let Some((block_number, tip)) = { let db = res.db.as_ref().unwrap(); db.get(res.block_number_key()).map(|number| (number, db.get(Self::tip_key(genesis)).unwrap())) } { res.block_number = u32::from_le_bytes(block_number.try_into().unwrap()); res.tip.copy_from_slice(&tip); } for participant in participants { if let Some(next_nonce) = res.db.as_ref().unwrap().get(res.next_nonce_key(participant)) { res.next_nonces.insert(*participant, u32::from_le_bytes(next_nonce.try_into().unwrap())); } } res } pub(crate) fn tip(&self) -> [u8; 32] { self.tip } pub(crate) fn block_number(&self) -> u32 { self.block_number } pub(crate) fn block_from_db(db: &D, genesis: [u8; 32], block: &[u8; 32]) -> Option> { db.get(Self::block_key(&genesis, block)) .map(|bytes| Block::::read::<&[u8]>(&mut bytes.as_ref()).unwrap()) } pub(crate) fn commit_from_db(db: &D, genesis: [u8; 32], block: &[u8; 32]) -> Option> { db.get(Self::commit_key(&genesis, block)) } pub(crate) fn block_hash_from_db(db: &D, genesis: [u8; 32], block: u32) -> Option<[u8; 32]> { db.get(Self::block_hash_key(&genesis, block)).map(|h| h.try_into().unwrap()) } pub(crate) fn commit(&self, block: &[u8; 32]) -> Option> { Self::commit_from_db(self.db.as_ref().unwrap(), self.genesis, block) } pub(crate) fn block_hash(&self, block: u32) -> Option<[u8; 32]> { Self::block_hash_from_db(self.db.as_ref().unwrap(), self.genesis, block) } pub(crate) fn commit_by_block_number(&self, block: u32) -> Option> { self.commit(&self.block_hash(block)?) } pub(crate) fn block_after(db: &D, genesis: [u8; 32], block: &[u8; 32]) -> Option<[u8; 32]> { db.get(Self::block_after_key(&genesis, block)).map(|bytes| bytes.try_into().unwrap()) } pub(crate) fn locally_provided_txs_in_block( db: &D, genesis: &[u8; 32], block: &[u8; 32], order: &str, ) -> bool { let local_key = ProvidedTransactions::::locally_provided_quantity_key(genesis, order); let local = db.get(local_key).map(|bytes| u32::from_le_bytes(bytes.try_into().unwrap())).unwrap_or(0); let block_key = ProvidedTransactions::::block_provided_quantity_key(genesis, block, order); let block = db.get(block_key).map(|bytes| u32::from_le_bytes(bytes.try_into().unwrap())).unwrap_or(0); local >= block } pub(crate) fn tip_from_db(db: &D, genesis: [u8; 32]) -> [u8; 32] { db.get(Self::tip_key(genesis)).map(|bytes| bytes.try_into().unwrap()).unwrap_or(genesis) } pub(crate) fn add_transaction( &mut self, internal: bool, tx: Transaction, schema: N::SignatureScheme, ) -> Result { let db = self.db.as_ref().unwrap(); let genesis = self.genesis; let commit = |block: u32| -> Option> { let hash = Self::block_hash_from_db(db, genesis, block)?; // we must have a commit per valid hash let commit = Self::commit_from_db(db, genesis, &hash).unwrap(); // commit has to be valid if it is coming from our db Some(Commit::::decode(&mut commit.as_ref()).unwrap()) }; let unsigned_in_chain = |hash: [u8; 32]| db.get(Self::unsigned_included_key(&self.genesis, &hash)).is_some(); self.mempool.add::(&self.next_nonces, internal, tx, schema, unsigned_in_chain, commit) } pub(crate) fn provide_transaction(&mut self, tx: T) -> Result<(), ProvidedError> { self.provided.provide(tx) } /// Returns the next nonce for signing, or None if they aren't a participant. pub(crate) fn next_nonce(&self, key: ::G) -> Option { Some(self.next_nonces.get(&key).cloned()?.max(self.mempool.next_nonce(&key).unwrap_or(0))) } pub(crate) fn build_block(&mut self, schema: N::SignatureScheme) -> Block { let db = self.db.as_ref().unwrap(); let unsigned_in_chain = |hash: [u8; 32]| db.get(Self::unsigned_included_key(&self.genesis, &hash)).is_some(); let block = Block::new( self.tip, self.provided.transactions.values().flatten().cloned().collect(), self.mempool.block(&self.next_nonces, unsigned_in_chain), ); // build_block should not return invalid blocks self.verify_block::(&block, schema, false).unwrap(); block } pub(crate) fn verify_block( &self, block: &Block, schema: N::SignatureScheme, allow_non_local_provided: bool, ) -> Result<(), BlockError> { let db = self.db.as_ref().unwrap(); let unsigned_in_chain = |hash: [u8; 32]| db.get(Self::unsigned_included_key(&self.genesis, &hash)).is_some(); let provided_in_chain = |hash: [u8; 32]| db.get(Self::provided_included_key(&self.genesis, &hash)).is_some(); let commit = |block: u32| -> Option> { let commit = self.commit_by_block_number(block)?; // commit has to be valid if it is coming from our db Some(Commit::::decode(&mut commit.as_ref()).unwrap()) }; block.verify::( self.genesis, self.tip, self.provided.transactions.clone(), self.next_nonces.clone(), schema, &commit, unsigned_in_chain, provided_in_chain, allow_non_local_provided, ) } /// Add a block. pub(crate) fn add_block( &mut self, block: &Block, commit: Vec, schema: N::SignatureScheme, ) -> Result<(), BlockError> { self.verify_block::(block, schema, true)?; log::info!( "adding block {} to tributary {} with {} TXs", hex::encode(block.hash()), hex::encode(self.genesis), block.transactions.len(), ); // None of the following assertions should be reachable since we verified the block // Take it from the Option so Rust doesn't consider self as mutably borrowed thanks to the // existence of the txn let mut db = self.db.take().unwrap(); let mut txn = db.txn(); self.tip = block.hash(); txn.put(Self::tip_key(self.genesis), self.tip); self.block_number += 1; txn.put(self.block_number_key(), self.block_number.to_le_bytes()); txn.put(Self::block_hash_key(&self.genesis, self.block_number), self.tip); txn.put(Self::block_key(&self.genesis, &self.tip), block.serialize()); txn.put(Self::commit_key(&self.genesis, &self.tip), commit); txn.put(Self::block_after_key(&self.genesis, &block.parent()), block.hash()); for tx in &block.transactions { match tx.kind() { TransactionKind::Provided(order) => { let hash = tx.hash(); self.provided.complete(&mut txn, order, self.tip, hash); txn.put(Self::provided_included_key(&self.genesis, &hash), []); } TransactionKind::Unsigned => { let hash = tx.hash(); // Save as included on chain txn.put(Self::unsigned_included_key(&self.genesis, &hash), []); // remove from the mempool self.mempool.remove(&hash); } TransactionKind::Signed(Signed { signer, nonce, .. }) => { let next_nonce = nonce + 1; let prev = self .next_nonces .insert(*signer, next_nonce) .expect("block had signed transaction from non-participant"); if prev != *nonce { panic!("verified block had an invalid nonce"); } txn.put(self.next_nonce_key(signer), next_nonce.to_le_bytes()); self.mempool.remove(&tx.hash()); } } } txn.commit(); self.db = Some(db); for tx in self.next_block_notifications.drain(..) { let _ = tx.send(()); } Ok(()) } }