// file: crates/ksp-onchain-transport-lib/tests/release_completeness.rs // version: 10 //! Release-level completeness canaries for the `0.2.1` HTTP foundation contract. #[test] fn release_registry_partition_matches_the_audited_http_plan() { let mut foundation = 0_usize; let mut accounts_tokens_cluster = 0_usize; let mut transactions = 0_usize; let mut blocks_economics = 0_usize; let mut historical_in_current = 0_usize; for descriptor in ksp_onchain_transport_lib::current_http_rpc_methods() { match descriptor.coverage_release() { ksp_onchain_transport_lib::HttpRpcCoverageRelease::V0_2_1 => foundation += 1, ksp_onchain_transport_lib::HttpRpcCoverageRelease::V0_2_2 => accounts_tokens_cluster += 1, ksp_onchain_transport_lib::HttpRpcCoverageRelease::V0_2_3 => transactions += 1, ksp_onchain_transport_lib::HttpRpcCoverageRelease::V0_2_4 => blocks_economics += 1, ksp_onchain_transport_lib::HttpRpcCoverageRelease::Historical => historical_in_current += 1, } } assert_eq!(ksp_onchain_transport_lib::current_http_rpc_methods().len(), 52); assert_eq!(ksp_onchain_transport_lib::historical_http_rpc_methods().len(), 14); assert_eq!(foundation, 4); assert_eq!(accounts_tokens_cluster, 22); assert_eq!(transactions, 11); assert_eq!(blocks_economics, 15); assert_eq!(historical_in_current, 0); } #[test] fn release_foundation_canaries_and_historical_statuses_are_exact() { let mut foundation_names = std::vec::Vec::<&str>::new(); for descriptor in ksp_onchain_transport_lib::current_http_rpc_methods() { if descriptor.coverage_release() == ksp_onchain_transport_lib::HttpRpcCoverageRelease::V0_2_1 { foundation_names.push(descriptor.method()); assert_eq!(descriptor.runtime_status(), ksp_onchain_transport_lib::RpcRuntimeStatus::Supported); } } foundation_names.sort_unstable(); assert_eq!(foundation_names, std::vec!["getBalance", "getGenesisHash", "getHealth", "getVersion"]); for descriptor in ksp_onchain_transport_lib::historical_http_rpc_methods() { assert_eq!(descriptor.documentation_status(), ksp_onchain_transport_lib::RpcDocumentationStatus::Deprecated); assert_eq!(descriptor.runtime_status(), ksp_onchain_transport_lib::RpcRuntimeStatus::Removed); assert_eq!(descriptor.coverage_release(), ksp_onchain_transport_lib::HttpRpcCoverageRelease::Historical); assert_eq!(descriptor.transport_retry_class(), ksp_onchain_transport_lib::TransportRetryClass::NotApplicable); } } #[test] fn release_pre_003_accounts_subset_is_exact_without_advancing_other_v0_2_2_families() { let mut account_names = std::vec::Vec::<&str>::new(); for descriptor in ksp_onchain_transport_lib::current_http_rpc_methods() { if descriptor.coverage_release() == ksp_onchain_transport_lib::HttpRpcCoverageRelease::V0_2_2 && descriptor.category() == ksp_onchain_transport_lib::HttpRpcCategory::Accounts { account_names.push(descriptor.method()); assert_eq!(descriptor.operation_kind(), ksp_onchain_transport_lib::RpcOperationKind::Read); assert_eq!(descriptor.transport_retry_class(), ksp_onchain_transport_lib::TransportRetryClass::RetrySafe); } } account_names.sort_unstable(); assert_eq!( account_names, std::vec!["getAccountInfo", "getLargestAccounts", "getMinimumBalanceForRentExemption", "getMultipleAccounts", "getProgramAccounts",], ); } #[test] fn release_pre_004_tokens_subset_is_exact_and_retry_safe() { let mut token_names = std::vec::Vec::<&str>::new(); for descriptor in ksp_onchain_transport_lib::current_http_rpc_methods() { if descriptor.coverage_release() == ksp_onchain_transport_lib::HttpRpcCoverageRelease::V0_2_2 && descriptor.category() == ksp_onchain_transport_lib::HttpRpcCategory::Tokens { token_names.push(descriptor.method()); assert_eq!(descriptor.operation_kind(), ksp_onchain_transport_lib::RpcOperationKind::Read); assert_eq!(descriptor.transport_retry_class(), ksp_onchain_transport_lib::TransportRetryClass::RetrySafe); } } token_names.sort_unstable(); assert_eq!( token_names, std::vec!["getTokenAccountBalance", "getTokenAccountsByDelegate", "getTokenAccountsByOwner", "getTokenLargestAccounts", "getTokenSupply",], ); } #[test] fn release_pre_005_simple_cluster_subset_is_exact_and_retry_safe() { let expected = std::vec![ "getClusterNodes", "getEpochInfo", "getEpochSchedule", "getHighestSnapshotSlot", "getIdentity", "getMaxRetransmitSlot", "getMaxShredInsertSlot", ]; let deferred = std::vec!["getLeaderSchedule", "getSlot", "getSlotLeader", "getSlotLeaders", "getVoteAccounts"]; for method_name in &expected { let descriptor = ksp_onchain_transport_lib::find_http_rpc_method(method_name).expect("pre.005 cluster descriptor must exist"); assert_eq!(descriptor.category(), ksp_onchain_transport_lib::HttpRpcCategory::Cluster); assert_eq!(descriptor.coverage_release(), ksp_onchain_transport_lib::HttpRpcCoverageRelease::V0_2_2); assert_eq!(descriptor.operation_kind(), ksp_onchain_transport_lib::RpcOperationKind::Read); assert_eq!(descriptor.transport_retry_class(), ksp_onchain_transport_lib::TransportRetryClass::RetrySafe); } for method_name in &deferred { let descriptor = ksp_onchain_transport_lib::find_http_rpc_method(method_name).expect("pre.006 cluster descriptor must remain registered"); assert_eq!(descriptor.coverage_release(), ksp_onchain_transport_lib::HttpRpcCoverageRelease::V0_2_2); } assert_eq!(expected.len(), 7); assert_eq!(deferred.len(), 5); } #[test] fn release_pre_006_completes_cluster_subset_exactly_and_retry_safe() { let mut expected = std::vec![ "getClusterNodes", "getEpochInfo", "getEpochSchedule", "getHighestSnapshotSlot", "getIdentity", "getLeaderSchedule", "getMaxRetransmitSlot", "getMaxShredInsertSlot", "getSlot", "getSlotLeader", "getSlotLeaders", "getVoteAccounts", ]; let mut actual = std::vec::Vec::new(); for descriptor in ksp_onchain_transport_lib::current_http_rpc_methods() { if descriptor.coverage_release() == ksp_onchain_transport_lib::HttpRpcCoverageRelease::V0_2_2 && descriptor.category() == ksp_onchain_transport_lib::HttpRpcCategory::Cluster { actual.push(descriptor.method()); assert_eq!(descriptor.operation_kind(), ksp_onchain_transport_lib::RpcOperationKind::Read); assert_eq!(descriptor.transport_retry_class(), ksp_onchain_transport_lib::TransportRetryClass::RetrySafe); } } actual.sort_unstable(); expected.sort_unstable(); assert_eq!(actual, expected); assert_eq!(actual.len(), 12); } #[test] fn release_pre_007_v0_2_2_exact_set_is_complete_without_advancing_future_releases() { let mut expected = std::vec![ "getAccountInfo", "getClusterNodes", "getEpochInfo", "getEpochSchedule", "getHighestSnapshotSlot", "getIdentity", "getLargestAccounts", "getLeaderSchedule", "getMaxRetransmitSlot", "getMaxShredInsertSlot", "getMinimumBalanceForRentExemption", "getMultipleAccounts", "getProgramAccounts", "getSlot", "getSlotLeader", "getSlotLeaders", "getTokenAccountBalance", "getTokenAccountsByDelegate", "getTokenAccountsByOwner", "getTokenLargestAccounts", "getTokenSupply", "getVoteAccounts", ]; let mut actual = std::vec::Vec::new(); let mut future_transactions = 0_usize; let mut future_blocks_economics = 0_usize; for descriptor in ksp_onchain_transport_lib::current_http_rpc_methods() { match descriptor.coverage_release() { ksp_onchain_transport_lib::HttpRpcCoverageRelease::V0_2_2 => { actual.push(descriptor.method()); assert_eq!(descriptor.documentation_status(), ksp_onchain_transport_lib::RpcDocumentationStatus::Stable); assert_eq!(descriptor.runtime_status(), ksp_onchain_transport_lib::RpcRuntimeStatus::Supported); assert_eq!(descriptor.operation_kind(), ksp_onchain_transport_lib::RpcOperationKind::Read); assert_eq!(descriptor.transport_retry_class(), ksp_onchain_transport_lib::TransportRetryClass::RetrySafe); }, ksp_onchain_transport_lib::HttpRpcCoverageRelease::V0_2_3 => future_transactions += 1, ksp_onchain_transport_lib::HttpRpcCoverageRelease::V0_2_4 => future_blocks_economics += 1, _ => {}, } } actual.sort_unstable(); expected.sort_unstable(); assert_eq!(actual, expected); assert_eq!(actual.len(), 22); assert_eq!(future_transactions, 11); assert_eq!(future_blocks_economics, 15); } #[test] fn release_v0_2_3_descriptor_set_and_safety_classes_are_exact_before_wrapper_completion() { let mut expected = std::vec![ "getFeeForMessage", "getLatestBlockhash", "getRecentPrioritizationFees", "getSignaturesForAddress", "getSignatureStatuses", "getTransaction", "getTransactionCount", "isBlockhashValid", "requestAirdrop", "sendTransaction", "simulateTransaction", ]; let mut actual = std::vec::Vec::new(); let mut reads = 0_usize; let mut writes = 0_usize; let mut simulations = 0_usize; for descriptor in ksp_onchain_transport_lib::current_http_rpc_methods() { if descriptor.coverage_release() != ksp_onchain_transport_lib::HttpRpcCoverageRelease::V0_2_3 { continue; } actual.push(descriptor.method()); match descriptor.operation_kind() { ksp_onchain_transport_lib::RpcOperationKind::Read => { reads += 1; assert_eq!(descriptor.transport_retry_class(), ksp_onchain_transport_lib::TransportRetryClass::RetrySafe); }, ksp_onchain_transport_lib::RpcOperationKind::WriteSubmission => { writes += 1; assert_eq!(descriptor.transport_retry_class(), ksp_onchain_transport_lib::TransportRetryClass::NeverAfterDispatch); }, ksp_onchain_transport_lib::RpcOperationKind::Simulation => { simulations += 1; assert_eq!(descriptor.transport_retry_class(), ksp_onchain_transport_lib::TransportRetryClass::RetrySafe); }, } } actual.sort_unstable(); expected.sort_unstable(); assert_eq!(actual, expected); assert_eq!(reads, 8); assert_eq!(writes, 2); assert_eq!(simulations, 1); } #[test] fn release_pre_003_transaction_read_subset_is_exact_and_retry_safe() { let mut expected = std::vec!["getFeeForMessage", "getLatestBlockhash", "getTransactionCount", "isBlockhashValid"]; let mut actual = std::vec::Vec::new(); for method_name in &expected { let descriptor = ksp_onchain_transport_lib::find_http_rpc_method(method_name).expect("pre.003 Transaction descriptor must exist"); actual.push(descriptor.method()); assert_eq!(descriptor.category(), ksp_onchain_transport_lib::HttpRpcCategory::Transactions); assert_eq!(descriptor.coverage_release(), ksp_onchain_transport_lib::HttpRpcCoverageRelease::V0_2_3); assert_eq!(descriptor.operation_kind(), ksp_onchain_transport_lib::RpcOperationKind::Read); assert_eq!(descriptor.transport_retry_class(), ksp_onchain_transport_lib::TransportRetryClass::RetrySafe); } actual.sort_unstable(); expected.sort_unstable(); assert_eq!(actual, expected); assert_eq!(actual.len(), 4); } #[test] fn release_pre_004_transaction_read_subset_is_exact_and_retry_safe() { let mut expected = std::vec![ "getFeeForMessage", "getLatestBlockhash", "getRecentPrioritizationFees", "getSignaturesForAddress", "getSignatureStatuses", "getTransactionCount", "isBlockhashValid", ]; let deferred = std::vec!["getTransaction", "requestAirdrop", "sendTransaction", "simulateTransaction"]; let mut actual = std::vec::Vec::new(); for method_name in &expected { let descriptor = ksp_onchain_transport_lib::find_http_rpc_method(method_name).expect("pre.004 Transaction descriptor must exist"); actual.push(descriptor.method()); assert_eq!(descriptor.category(), ksp_onchain_transport_lib::HttpRpcCategory::Transactions); assert_eq!(descriptor.coverage_release(), ksp_onchain_transport_lib::HttpRpcCoverageRelease::V0_2_3); assert_eq!(descriptor.operation_kind(), ksp_onchain_transport_lib::RpcOperationKind::Read); assert_eq!(descriptor.transport_retry_class(), ksp_onchain_transport_lib::TransportRetryClass::RetrySafe); } for method_name in &deferred { let descriptor = ksp_onchain_transport_lib::find_http_rpc_method(method_name).expect("deferred Transaction descriptor must remain registered"); assert_eq!(descriptor.coverage_release(), ksp_onchain_transport_lib::HttpRpcCoverageRelease::V0_2_3); } actual.sort_unstable(); expected.sort_unstable(); assert_eq!(actual, expected); assert_eq!(actual.len(), 7); assert_eq!(deferred.len(), 4); } #[test] fn release_pre_005_transaction_read_subset_adds_complete_get_transaction_without_advancing_writes_or_simulation() { let mut expected = std::vec![ "getFeeForMessage", "getLatestBlockhash", "getRecentPrioritizationFees", "getSignaturesForAddress", "getSignatureStatuses", "getTransaction", "getTransactionCount", "isBlockhashValid", ]; let deferred = std::vec!["requestAirdrop", "sendTransaction", "simulateTransaction"]; let mut actual = std::vec::Vec::new(); for method_name in &expected { let descriptor = ksp_onchain_transport_lib::find_http_rpc_method(method_name).expect("pre.005 Transaction descriptor must exist"); actual.push(descriptor.method()); assert_eq!(descriptor.category(), ksp_onchain_transport_lib::HttpRpcCategory::Transactions); assert_eq!(descriptor.coverage_release(), ksp_onchain_transport_lib::HttpRpcCoverageRelease::V0_2_3); assert_eq!(descriptor.operation_kind(), ksp_onchain_transport_lib::RpcOperationKind::Read); assert_eq!(descriptor.transport_retry_class(), ksp_onchain_transport_lib::TransportRetryClass::RetrySafe); } let get_transaction = ksp_onchain_transport_lib::find_http_rpc_method("getTransaction").expect("getTransaction descriptor must exist"); assert!(get_transaction.request_form_status().has_deprecated_legacy()); for method_name in &deferred { let descriptor = ksp_onchain_transport_lib::find_http_rpc_method(method_name).expect("deferred Transaction descriptor must remain registered"); assert_eq!(descriptor.coverage_release(), ksp_onchain_transport_lib::HttpRpcCoverageRelease::V0_2_3); } actual.sort_unstable(); expected.sort_unstable(); assert_eq!(actual, expected); assert_eq!(actual.len(), 8); assert_eq!(deferred.len(), 3); }