2018-05-11 23:31:32 -07:00
|
|
|
//! The `tvu` module implements the Transaction Validation Unit, a
|
2019-01-08 08:21:39 -08:00
|
|
|
//! multi-stage transaction validation pipeline in software.
|
2018-06-14 17:05:12 -07:00
|
|
|
//!
|
2018-12-07 14:09:29 -08:00
|
|
|
//! 1. BlobFetchStage
|
|
|
|
//! - Incoming blobs are picked up from the TVU sockets and repair socket.
|
|
|
|
//! 2. RetransmitStage
|
2018-06-15 14:49:22 -07:00
|
|
|
//! - Blobs are windowed until a contiguous chunk is available. This stage also repairs and
|
|
|
|
//! retransmits blobs that are in the queue.
|
2018-12-07 14:09:29 -08:00
|
|
|
//! 3. ReplayStage
|
2018-06-15 14:49:22 -07:00
|
|
|
//! - Transactions in blobs are processed and applied to the bank.
|
|
|
|
//! - TODO We need to verify the signatures in the blobs.
|
2019-01-03 21:29:21 -08:00
|
|
|
//! 4. StorageStage
|
2018-12-07 14:09:29 -08:00
|
|
|
//! - Generating the keys used to encrypt the ledger and sample it for storage mining.
|
2018-05-11 23:31:32 -07:00
|
|
|
|
2019-02-21 11:19:45 -08:00
|
|
|
use crate::bank_forks::BankForks;
|
2019-02-21 15:16:09 -08:00
|
|
|
use crate::blockstream_service::BlockstreamService;
|
2018-12-07 19:16:27 -08:00
|
|
|
use crate::cluster_info::ClusterInfo;
|
2019-09-04 23:10:25 -07:00
|
|
|
use crate::confidence::ForkConfidenceCache;
|
2019-07-20 13:13:55 -07:00
|
|
|
use crate::ledger_cleanup_service::LedgerCleanupService;
|
2019-03-03 16:44:06 -08:00
|
|
|
use crate::poh_recorder::PohRecorder;
|
2019-01-26 00:28:08 -08:00
|
|
|
use crate::replay_stage::ReplayStage;
|
2018-12-07 19:16:27 -08:00
|
|
|
use crate::retransmit_stage::RetransmitStage;
|
2019-02-18 18:08:54 -08:00
|
|
|
use crate::rpc_subscriptions::RpcSubscriptions;
|
2018-12-07 19:16:27 -08:00
|
|
|
use crate::service::Service;
|
2019-10-07 11:08:01 -07:00
|
|
|
use crate::shred_fetch_stage::ShredFetchStage;
|
2019-10-18 14:58:16 -07:00
|
|
|
use crate::snapshot_packager_service::SnapshotPackagerService;
|
2019-01-28 14:53:50 -08:00
|
|
|
use crate::storage_stage::{StorageStage, StorageState};
|
2019-10-18 09:28:51 -07:00
|
|
|
use solana_ledger::blocktree::{Blocktree, CompletedSlotsReceiver};
|
|
|
|
use solana_ledger::leader_schedule_cache::LeaderScheduleCache;
|
2019-03-08 18:29:08 -08:00
|
|
|
use solana_sdk::pubkey::Pubkey;
|
2019-01-30 19:28:48 -08:00
|
|
|
use solana_sdk::signature::{Keypair, KeypairUtil};
|
2019-01-11 12:58:31 -08:00
|
|
|
use std::net::UdpSocket;
|
2019-07-30 19:47:24 -07:00
|
|
|
use std::path::PathBuf;
|
2019-03-04 19:02:03 -08:00
|
|
|
use std::sync::atomic::AtomicBool;
|
2019-03-03 16:44:06 -08:00
|
|
|
use std::sync::mpsc::{channel, Receiver};
|
|
|
|
use std::sync::{Arc, Mutex, RwLock};
|
2018-09-13 14:00:17 -07:00
|
|
|
use std::thread;
|
2018-05-11 23:31:32 -07:00
|
|
|
|
|
|
|
pub struct Tvu {
|
2019-10-07 11:08:01 -07:00
|
|
|
fetch_stage: ShredFetchStage,
|
2018-08-09 12:03:34 -07:00
|
|
|
retransmit_stage: RetransmitStage,
|
2018-12-07 14:09:29 -08:00
|
|
|
replay_stage: ReplayStage,
|
2019-02-21 15:16:09 -08:00
|
|
|
blockstream_service: Option<BlockstreamService>,
|
2019-07-20 13:13:55 -07:00
|
|
|
ledger_cleanup_service: Option<LedgerCleanupService>,
|
2018-10-08 13:12:33 -07:00
|
|
|
storage_stage: StorageStage,
|
2019-07-31 17:58:10 -07:00
|
|
|
snapshot_packager_service: Option<SnapshotPackagerService>,
|
2018-05-11 23:31:32 -07:00
|
|
|
}
|
|
|
|
|
2018-12-12 18:57:48 -08:00
|
|
|
pub struct Sockets {
|
|
|
|
pub fetch: Vec<UdpSocket>,
|
|
|
|
pub repair: UdpSocket,
|
2019-10-10 13:24:03 -07:00
|
|
|
pub retransmit: Vec<UdpSocket>,
|
2019-08-20 17:16:06 -07:00
|
|
|
pub forwards: Vec<UdpSocket>,
|
2018-12-12 18:57:48 -08:00
|
|
|
}
|
|
|
|
|
2018-05-11 23:31:32 -07:00
|
|
|
impl Tvu {
|
|
|
|
/// This service receives messages from a leader in the network and processes the transactions
|
2018-05-14 14:33:11 -07:00
|
|
|
/// on the bank state.
|
2018-05-11 23:31:32 -07:00
|
|
|
/// # Arguments
|
2018-10-08 19:55:54 -07:00
|
|
|
/// * `cluster_info` - The cluster_info state.
|
2019-02-21 11:37:48 -08:00
|
|
|
/// * `sockets` - fetch, repair, and retransmit sockets
|
2019-02-07 20:52:39 -08:00
|
|
|
/// * `blocktree` - the ledger itself
|
2019-01-31 13:43:22 -08:00
|
|
|
#[allow(clippy::new_ret_no_self, clippy::too_many_arguments)]
|
2019-02-21 21:43:35 -08:00
|
|
|
pub fn new<T>(
|
2019-03-09 19:28:43 -08:00
|
|
|
vote_account: &Pubkey,
|
2019-05-15 15:19:29 -07:00
|
|
|
voting_keypair: Option<&Arc<T>>,
|
|
|
|
storage_keypair: &Arc<Keypair>,
|
2019-02-21 11:19:45 -08:00
|
|
|
bank_forks: &Arc<RwLock<BankForks>>,
|
2018-12-10 11:38:29 -08:00
|
|
|
cluster_info: &Arc<RwLock<ClusterInfo>>,
|
2018-12-12 18:57:48 -08:00
|
|
|
sockets: Sockets,
|
2019-02-07 20:52:39 -08:00
|
|
|
blocktree: Arc<Blocktree>,
|
2019-01-28 14:53:50 -08:00
|
|
|
storage_state: &StorageState,
|
2019-07-30 19:47:24 -07:00
|
|
|
blockstream_unix_socket: Option<&PathBuf>,
|
2019-07-20 13:13:55 -07:00
|
|
|
max_ledger_slots: Option<u64>,
|
2019-02-04 15:33:43 -08:00
|
|
|
ledger_signal_receiver: Receiver<bool>,
|
2019-02-18 18:08:54 -08:00
|
|
|
subscriptions: &Arc<RpcSubscriptions>,
|
2019-03-03 16:44:06 -08:00
|
|
|
poh_recorder: &Arc<Mutex<PohRecorder>>,
|
2019-04-19 02:39:44 -07:00
|
|
|
leader_schedule_cache: &Arc<LeaderScheduleCache>,
|
2019-03-04 16:33:14 -08:00
|
|
|
exit: &Arc<AtomicBool>,
|
2019-05-09 14:10:04 -07:00
|
|
|
completed_slots_receiver: CompletedSlotsReceiver,
|
2019-09-04 23:10:25 -07:00
|
|
|
fork_confidence_cache: Arc<RwLock<ForkConfidenceCache>>,
|
2019-02-21 21:43:35 -08:00
|
|
|
) -> Self
|
|
|
|
where
|
|
|
|
T: 'static + KeypairUtil + Sync + Send,
|
|
|
|
{
|
2018-12-12 18:57:48 -08:00
|
|
|
let keypair: Arc<Keypair> = cluster_info
|
|
|
|
.read()
|
|
|
|
.expect("Unable to read from cluster_info during Tvu creation")
|
|
|
|
.keypair
|
|
|
|
.clone();
|
|
|
|
|
|
|
|
let Sockets {
|
|
|
|
repair: repair_socket,
|
|
|
|
fetch: fetch_sockets,
|
2019-10-10 13:24:03 -07:00
|
|
|
retransmit: retransmit_sockets,
|
2019-08-20 17:16:06 -07:00
|
|
|
forwards: tvu_forward_sockets,
|
2018-12-12 18:57:48 -08:00
|
|
|
} = sockets;
|
2018-09-25 15:41:29 -07:00
|
|
|
|
2019-08-20 17:16:06 -07:00
|
|
|
let (fetch_sender, fetch_receiver) = channel();
|
2019-01-31 13:43:22 -08:00
|
|
|
|
2018-08-30 12:07:54 -07:00
|
|
|
let repair_socket = Arc::new(repair_socket);
|
2019-10-09 13:11:19 -07:00
|
|
|
let fetch_sockets: Vec<Arc<UdpSocket>> = fetch_sockets.into_iter().map(Arc::new).collect();
|
2019-10-09 10:36:05 -07:00
|
|
|
let forward_sockets: Vec<Arc<UdpSocket>> =
|
2019-08-20 17:16:06 -07:00
|
|
|
tvu_forward_sockets.into_iter().map(Arc::new).collect();
|
2019-10-09 13:11:19 -07:00
|
|
|
let fetch_stage = ShredFetchStage::new(
|
|
|
|
fetch_sockets,
|
|
|
|
forward_sockets,
|
|
|
|
repair_socket.clone(),
|
|
|
|
&fetch_sender,
|
|
|
|
&exit,
|
|
|
|
);
|
2018-11-24 19:32:33 -08:00
|
|
|
|
2018-05-11 23:31:32 -07:00
|
|
|
//TODO
|
|
|
|
//the packets coming out of blob_receiver need to be sent to the GPU and verified
|
|
|
|
//then sent to the window, which does the erasure coding reconstruction
|
2019-02-04 15:33:43 -08:00
|
|
|
let retransmit_stage = RetransmitStage::new(
|
2019-04-22 15:21:10 -07:00
|
|
|
bank_forks.clone(),
|
2019-04-22 18:41:01 -07:00
|
|
|
leader_schedule_cache,
|
2019-02-07 20:52:39 -08:00
|
|
|
blocktree.clone(),
|
2018-10-08 19:55:54 -07:00
|
|
|
&cluster_info,
|
2019-10-10 13:24:03 -07:00
|
|
|
Arc::new(retransmit_sockets),
|
2018-08-30 12:07:54 -07:00
|
|
|
repair_socket,
|
2019-08-20 17:16:06 -07:00
|
|
|
fetch_receiver,
|
2019-03-04 20:50:02 -08:00
|
|
|
&exit,
|
2019-05-09 14:10:04 -07:00
|
|
|
completed_slots_receiver,
|
2019-05-13 15:37:50 -07:00
|
|
|
*bank_forks.read().unwrap().working_bank().epoch_schedule(),
|
2018-05-22 15:17:59 -07:00
|
|
|
);
|
2018-05-11 23:31:32 -07:00
|
|
|
|
2019-07-20 13:13:55 -07:00
|
|
|
let (blockstream_slot_sender, blockstream_slot_receiver) = channel();
|
|
|
|
let (ledger_cleanup_slot_sender, ledger_cleanup_slot_receiver) = channel();
|
2019-07-31 17:58:10 -07:00
|
|
|
let (snapshot_packager_service, snapshot_package_sender) = {
|
|
|
|
let snapshot_config = { bank_forks.read().unwrap().snapshot_config().clone() };
|
|
|
|
if snapshot_config.is_some() {
|
|
|
|
// Start a snapshot packaging service
|
|
|
|
let (sender, receiver) = channel();
|
|
|
|
let snapshot_packager_service = SnapshotPackagerService::new(receiver, exit);
|
|
|
|
(Some(snapshot_packager_service), Some(sender))
|
|
|
|
} else {
|
|
|
|
(None, None)
|
|
|
|
}
|
|
|
|
};
|
2019-07-20 13:13:55 -07:00
|
|
|
|
|
|
|
let (replay_stage, root_bank_receiver) = ReplayStage::new(
|
2019-03-09 19:28:43 -08:00
|
|
|
&keypair.pubkey(),
|
2019-03-08 18:29:08 -08:00
|
|
|
vote_account,
|
2019-01-31 20:12:51 -08:00
|
|
|
voting_keypair,
|
2019-02-07 20:52:39 -08:00
|
|
|
blocktree.clone(),
|
2019-02-21 11:37:48 -08:00
|
|
|
&bank_forks,
|
2018-12-10 11:38:29 -08:00
|
|
|
cluster_info.clone(),
|
2019-03-04 20:50:02 -08:00
|
|
|
&exit,
|
2019-02-04 15:33:43 -08:00
|
|
|
ledger_signal_receiver,
|
2019-02-18 18:08:54 -08:00
|
|
|
subscriptions,
|
2019-03-03 16:44:06 -08:00
|
|
|
poh_recorder,
|
2019-04-19 02:39:44 -07:00
|
|
|
leader_schedule_cache,
|
2019-07-20 13:13:55 -07:00
|
|
|
vec![blockstream_slot_sender, ledger_cleanup_slot_sender],
|
2019-07-31 17:58:10 -07:00
|
|
|
snapshot_package_sender,
|
2019-09-04 23:10:25 -07:00
|
|
|
fork_confidence_cache,
|
2018-07-13 12:32:20 -07:00
|
|
|
);
|
2018-06-13 21:52:23 -07:00
|
|
|
|
2019-10-02 18:33:01 -07:00
|
|
|
let blockstream_service = if let Some(blockstream_unix_socket) = blockstream_unix_socket {
|
2019-02-28 01:14:37 -08:00
|
|
|
let blockstream_service = BlockstreamService::new(
|
2019-07-20 13:13:55 -07:00
|
|
|
blockstream_slot_receiver,
|
2019-02-28 01:14:37 -08:00
|
|
|
blocktree.clone(),
|
2019-10-02 18:33:01 -07:00
|
|
|
blockstream_unix_socket,
|
2019-03-04 20:50:02 -08:00
|
|
|
&exit,
|
2019-02-11 13:51:14 -08:00
|
|
|
);
|
2019-02-21 15:16:09 -08:00
|
|
|
Some(blockstream_service)
|
2019-02-11 13:51:14 -08:00
|
|
|
} else {
|
|
|
|
None
|
|
|
|
};
|
2019-02-11 10:36:59 -08:00
|
|
|
|
2019-07-20 13:13:55 -07:00
|
|
|
let ledger_cleanup_service = max_ledger_slots.map(|max_ledger_slots| {
|
|
|
|
LedgerCleanupService::new(
|
|
|
|
ledger_cleanup_slot_receiver,
|
|
|
|
blocktree.clone(),
|
|
|
|
max_ledger_slots,
|
|
|
|
&exit,
|
|
|
|
)
|
|
|
|
});
|
|
|
|
|
2018-11-07 18:25:36 -08:00
|
|
|
let storage_stage = StorageStage::new(
|
2019-01-28 14:53:50 -08:00
|
|
|
storage_state,
|
2019-06-11 18:27:47 -07:00
|
|
|
root_bank_receiver,
|
2019-02-07 20:52:39 -08:00
|
|
|
Some(blocktree),
|
2019-01-17 14:41:48 -08:00
|
|
|
&keypair,
|
2019-05-15 15:19:29 -07:00
|
|
|
storage_keypair,
|
2019-03-04 20:50:02 -08:00
|
|
|
&exit,
|
2019-04-24 22:34:10 -07:00
|
|
|
&bank_forks,
|
2019-01-17 14:41:48 -08:00
|
|
|
&cluster_info,
|
2018-10-08 13:12:33 -07:00
|
|
|
);
|
2018-10-23 14:42:48 -07:00
|
|
|
|
2019-02-11 17:56:52 -08:00
|
|
|
Tvu {
|
|
|
|
fetch_stage,
|
|
|
|
retransmit_stage,
|
|
|
|
replay_stage,
|
2019-02-21 15:16:09 -08:00
|
|
|
blockstream_service,
|
2019-07-20 13:13:55 -07:00
|
|
|
ledger_cleanup_service,
|
2019-02-11 17:56:52 -08:00
|
|
|
storage_stage,
|
2019-07-31 17:58:10 -07:00
|
|
|
snapshot_packager_service,
|
2019-02-11 17:56:52 -08:00
|
|
|
}
|
2018-05-11 23:31:32 -07:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2018-07-03 21:14:08 -07:00
|
|
|
impl Service for Tvu {
|
2019-02-08 08:06:27 -08:00
|
|
|
type JoinReturnType = ();
|
2018-07-03 21:14:08 -07:00
|
|
|
|
2019-02-08 08:06:27 -08:00
|
|
|
fn join(self) -> thread::Result<()> {
|
2018-10-10 16:49:41 -07:00
|
|
|
self.retransmit_stage.join()?;
|
2018-09-13 14:00:17 -07:00
|
|
|
self.fetch_stage.join()?;
|
2018-10-08 13:12:33 -07:00
|
|
|
self.storage_stage.join()?;
|
2019-02-21 15:16:09 -08:00
|
|
|
if self.blockstream_service.is_some() {
|
|
|
|
self.blockstream_service.unwrap().join()?;
|
2019-02-11 13:51:14 -08:00
|
|
|
}
|
2019-07-20 13:13:55 -07:00
|
|
|
if self.ledger_cleanup_service.is_some() {
|
|
|
|
self.ledger_cleanup_service.unwrap().join()?;
|
|
|
|
}
|
2019-02-08 08:06:27 -08:00
|
|
|
self.replay_stage.join()?;
|
2019-07-31 17:58:10 -07:00
|
|
|
if let Some(s) = self.snapshot_packager_service {
|
|
|
|
s.join()?;
|
|
|
|
}
|
2019-02-08 08:06:27 -08:00
|
|
|
Ok(())
|
2018-07-03 21:14:08 -07:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2018-05-11 23:31:32 -07:00
|
|
|
#[cfg(test)]
|
2018-05-23 10:49:48 -07:00
|
|
|
pub mod tests {
|
2019-02-08 08:10:28 -08:00
|
|
|
use super::*;
|
2019-03-03 16:44:06 -08:00
|
|
|
use crate::banking_stage::create_test_recorder;
|
2018-12-07 19:16:27 -08:00
|
|
|
use crate::cluster_info::{ClusterInfo, Node};
|
2019-05-22 20:39:00 -07:00
|
|
|
use crate::genesis_utils::{create_genesis_block, GenesisBlockInfo};
|
2019-10-18 09:28:51 -07:00
|
|
|
use solana_ledger::blocktree::create_new_tmp_ledger;
|
2019-02-21 11:19:45 -08:00
|
|
|
use solana_runtime::bank::Bank;
|
2019-03-04 19:02:03 -08:00
|
|
|
use std::sync::atomic::Ordering;
|
2018-08-03 11:06:06 -07:00
|
|
|
|
2019-02-04 15:33:43 -08:00
|
|
|
#[test]
|
|
|
|
fn test_tvu_exit() {
|
|
|
|
solana_logger::setup();
|
|
|
|
let leader = Node::new_localhost();
|
|
|
|
let target1_keypair = Keypair::new();
|
2019-03-09 19:28:43 -08:00
|
|
|
let target1 = Node::new_localhost_with_pubkey(&target1_keypair.pubkey());
|
2019-02-04 15:33:43 -08:00
|
|
|
|
|
|
|
let starting_balance = 10_000;
|
2019-05-22 20:39:00 -07:00
|
|
|
let GenesisBlockInfo { genesis_block, .. } = create_genesis_block(starting_balance);
|
2019-02-21 11:19:45 -08:00
|
|
|
|
|
|
|
let bank_forks = BankForks::new(0, Bank::new(&genesis_block));
|
2019-02-04 15:33:43 -08:00
|
|
|
|
|
|
|
//start cluster_info1
|
2019-03-06 13:47:18 -08:00
|
|
|
let mut cluster_info1 = ClusterInfo::new_with_invalid_keypair(target1.info.clone());
|
2019-02-04 15:33:43 -08:00
|
|
|
cluster_info1.insert_info(leader.info.clone());
|
|
|
|
let cref1 = Arc::new(RwLock::new(cluster_info1));
|
|
|
|
|
2019-08-27 15:09:41 -07:00
|
|
|
let (blocktree_path, _) = create_new_tmp_ledger!(&genesis_block);
|
2019-05-09 14:10:04 -07:00
|
|
|
let (blocktree, l_receiver, completed_slots_receiver) =
|
|
|
|
Blocktree::open_with_signal(&blocktree_path)
|
|
|
|
.expect("Expected to successfully open ledger");
|
2019-03-29 20:00:36 -07:00
|
|
|
let blocktree = Arc::new(blocktree);
|
2019-03-03 16:44:06 -08:00
|
|
|
let bank = bank_forks.working_bank();
|
2019-03-29 20:00:36 -07:00
|
|
|
let (exit, poh_recorder, poh_service, _entry_receiver) =
|
2019-10-16 12:37:27 -07:00
|
|
|
create_test_recorder(&bank, &blocktree, None);
|
2019-03-08 18:29:08 -08:00
|
|
|
let voting_keypair = Keypair::new();
|
2019-05-15 15:19:29 -07:00
|
|
|
let storage_keypair = Arc::new(Keypair::new());
|
2019-04-19 02:39:44 -07:00
|
|
|
let leader_schedule_cache = Arc::new(LeaderScheduleCache::new_from_bank(&bank));
|
2019-09-04 23:10:25 -07:00
|
|
|
let fork_confidence_cache = Arc::new(RwLock::new(ForkConfidenceCache::default()));
|
2019-02-11 17:56:52 -08:00
|
|
|
let tvu = Tvu::new(
|
2019-03-09 19:28:43 -08:00
|
|
|
&voting_keypair.pubkey(),
|
2019-05-15 15:19:29 -07:00
|
|
|
Some(&Arc::new(voting_keypair)),
|
|
|
|
&storage_keypair,
|
2019-02-21 11:19:45 -08:00
|
|
|
&Arc::new(RwLock::new(bank_forks)),
|
2019-02-04 15:33:43 -08:00
|
|
|
&cref1,
|
|
|
|
{
|
|
|
|
Sockets {
|
|
|
|
repair: target1.sockets.repair,
|
2019-10-10 13:24:03 -07:00
|
|
|
retransmit: target1.sockets.retransmit_sockets,
|
2019-02-04 15:33:43 -08:00
|
|
|
fetch: target1.sockets.tvu,
|
2019-08-20 17:16:06 -07:00
|
|
|
forwards: target1.sockets.tvu_forwards,
|
2019-02-04 15:33:43 -08:00
|
|
|
}
|
|
|
|
},
|
2019-03-29 20:00:36 -07:00
|
|
|
blocktree,
|
2019-02-04 15:33:43 -08:00
|
|
|
&StorageState::default(),
|
|
|
|
None,
|
2019-07-20 13:13:55 -07:00
|
|
|
None,
|
2019-02-04 15:33:43 -08:00
|
|
|
l_receiver,
|
2019-02-18 18:08:54 -08:00
|
|
|
&Arc::new(RpcSubscriptions::default()),
|
2019-03-03 16:44:06 -08:00
|
|
|
&poh_recorder,
|
2019-04-19 02:39:44 -07:00
|
|
|
&leader_schedule_cache,
|
2019-03-04 16:33:14 -08:00
|
|
|
&exit,
|
2019-05-09 14:10:04 -07:00
|
|
|
completed_slots_receiver,
|
2019-09-04 23:10:25 -07:00
|
|
|
fork_confidence_cache,
|
2019-02-04 15:33:43 -08:00
|
|
|
);
|
2019-03-04 19:02:03 -08:00
|
|
|
exit.store(true, Ordering::Relaxed);
|
|
|
|
tvu.join().unwrap();
|
2019-03-04 20:50:02 -08:00
|
|
|
poh_service.join().unwrap();
|
2019-02-04 15:33:43 -08:00
|
|
|
}
|
2018-05-11 23:31:32 -07:00
|
|
|
}
|