use super::*;
const ROOT_A: &str = "be2us-64aaa-aaaaa-qaabq-cai";
const GOVERNANCE_A: &str = "bkyz2-fmaaa-aaaaa-qaaaq-cai";
const LEDGER_A: &str = "bd3sg-teaaa-aaaaa-qaaba-cai";
const SWAP_A: &str = "br5f7-7uaaa-aaaaa-qaaca-cai";
const INDEX_A: &str = "bw4dl-smaaa-aaaaa-qaacq-cai";
const ROOT_B: &str = "bd3sg-teaaa-aaaaa-qaaba-cai";
const GOVERNANCE_B: &str = "br5f7-7uaaa-aaaaa-qaaca-cai";
const LEDGER_B: &str = "bw4dl-smaaa-aaaaa-qaacq-cai";
const SWAP_B: &str = "ryjl3-tyaaa-aaaaa-aaaba-cai";
const INDEX_B: &str = "r7inp-6aaaa-aaaaa-aaabq-cai";
#[test]
fn sns_list_report_uses_names_and_compact_ids_by_default() {
let request = list_request(false);
let report = build_sns_list_report_with_source(&request, &FixtureSnsListSource)
.expect("sns list report");
let text = sns_list_report_text(&report);
assert_eq!(report.schema_version, SNS_LIST_REPORT_SCHEMA_VERSION);
assert_eq!(report.network, MAINNET_NETWORK);
assert_eq!(report.sns_wasm_canister_id, MAINNET_SNS_WASM_CANISTER_ID);
assert_eq!(report.sns_count, 1);
assert!(!report.verbose);
assert_eq!(report.sort, "id");
assert_eq!(report.sns_instances[0].id, 1);
assert_eq!(report.sns_instances[0].name, "Fixture SNS");
assert_eq!(report.sns_instances[0].root_canister_id, ROOT_A);
assert_eq!(report.metadata_error_count, 0);
assert_eq!(report.sns_instances[0].metadata_error, None);
assert!(text.contains("ID NAME"));
assert!(text.contains("NAME"));
assert!(text.contains("sort: id"));
assert!(text.contains("metadata_errors: 0"));
assert!(text.contains("Fixture SNS"));
assert!(text.contains(&ROOT_A[..COMPACT_PRINCIPAL_CHARS]));
assert!(!text.contains(ROOT_A));
}
#[test]
fn sns_list_report_verbose_text_keeps_full_ids() {
let request = list_request(true);
let report = build_sns_list_report_with_source(&request, &FixtureSnsListSource)
.expect("sns list report");
let text = sns_list_report_text(&report);
assert!(report.verbose);
assert!(text.contains(ROOT_A));
assert!(text.contains(GOVERNANCE_A));
}
#[test]
fn sns_info_resolves_list_id() {
let request = info_request("1");
let report = build_sns_info_report_with_source(&request, &FixtureSnsListSource)
.expect("sns info report");
let text = sns_info_report_text(&report);
assert_eq!(report.schema_version, SNS_INFO_REPORT_SCHEMA_VERSION);
assert_eq!(report.id, 1);
assert_eq!(report.name, "Fixture SNS");
assert_eq!(report.description.as_deref(), Some("Fixture description"));
assert_eq!(report.url.as_deref(), Some("https://example.com"));
assert_eq!(report.metadata_error, None);
assert!(text.contains("root_canister_id: be2us-64aaa-aaaaa-qaabq-cai"));
}
#[test]
fn sns_info_resolves_root_principal() {
let request = info_request(ROOT_A);
let report = build_sns_info_report_with_source(&request, &FixtureSnsListSource)
.expect("sns info report");
assert_eq!(report.id, 1);
assert_eq!(report.root_canister_id, ROOT_A);
}
#[test]
fn sns_token_resolves_list_id_and_renders_ledger_metadata() {
let request = token_request("1");
let report = build_sns_token_report_with_source(&request, &FixtureSnsTokenSource)
.expect("sns token report");
let text = sns_token_report_text(&report);
assert_eq!(report.schema_version, SNS_TOKEN_REPORT_SCHEMA_VERSION);
assert_eq!(report.id, 1);
assert_eq!(report.name, "Fixture SNS");
assert_eq!(report.root_canister_id, ROOT_A);
assert_eq!(report.ledger_canister_id, LEDGER_A);
assert_eq!(report.sns_index_canister_id, INDEX_A);
assert_eq!(report.ledger_index_canister_id.as_deref(), Some(INDEX_A));
assert_eq!(report.token_name, "Fixture Token");
assert_eq!(report.token_symbol, "FIX");
assert_eq!(report.decimals, 8);
assert_eq!(report.transfer_fee, "10000");
assert_eq!(report.total_supply, "1000000000");
assert_eq!(report.minting_account_owner.as_deref(), Some(GOVERNANCE_A));
assert_eq!(
report.minting_account_subaccount_hex.as_deref(),
Some("000102")
);
assert_eq!(report.supported_standards[0].name, "ICRC-1");
assert_eq!(report.metadata[0].key, "icrc1:name");
assert!(report.metadata.iter().any(|row| row.key == "icrc1:logo"
&& row.value_type == "bool"
&& row.value == serde_json::json!(true)));
assert!(text.contains("token_symbol: FIX"));
assert!(text.contains("ledger_index_canister_id: bw4dl-smaaa-aaaaa-qaacq-cai"));
assert!(text.contains("ICRC-1"));
assert!(text.contains("icrc1:name"));
assert!(text.contains("icrc1:logo"));
assert!(text.contains("true"));
assert!(!text.contains("data:image"));
}
#[test]
fn sns_token_logo_metadata_is_presence_boolean() {
let row = metadata_row(
SNS_TOKEN_LOGO_METADATA_KEY.to_string(),
IcrcMetadataValue::Text("data:image/png;base64,large-logo".to_string()),
);
assert_eq!(row.key, SNS_TOKEN_LOGO_METADATA_KEY);
assert_eq!(row.value_type, "bool");
assert_eq!(row.value, serde_json::json!(true));
}
#[test]
fn sns_token_empty_logo_metadata_is_false() {
let row = metadata_row(
SNS_TOKEN_LOGO_METADATA_KEY.to_string(),
IcrcMetadataValue::Text(" ".to_string()),
);
assert_eq!(row.value_type, "bool");
assert_eq!(row.value, serde_json::json!(false));
}
#[test]
fn sns_neurons_resolves_list_id_and_renders_governance_neurons() {
let mut request = neurons_request("1");
request.owner_principal_id = Some(GOVERNANCE_A.to_string());
let report = build_sns_neurons_report_with_source(&request, &FixtureSnsNeuronsSource)
.expect("sns neurons report");
let text = sns_neurons_report_text(&report);
assert_eq!(report.schema_version, SNS_NEURONS_REPORT_SCHEMA_VERSION);
assert_eq!(report.id, 1);
assert_eq!(report.name, "Fixture SNS");
assert_eq!(report.root_canister_id, ROOT_A);
assert_eq!(report.governance_canister_id, GOVERNANCE_A);
assert_eq!(report.requested_limit, 10);
assert_eq!(report.owner_principal_id.as_deref(), Some(GOVERNANCE_A));
assert_eq!(report.neuron_count, 1);
assert_eq!(report.neurons[0].neuron_id, "00010203");
assert_eq!(report.neurons[0].cached_neuron_stake_e8s, 123);
assert_eq!(report.neurons[0].maturity_e8s_equivalent, 456);
assert_eq!(report.neurons[0].staked_maturity_e8s_equivalent, Some(789));
assert_eq!(report.neurons[0].created_at, "2026-06-01T00:00:00Z");
assert!(text.contains("governance_canister_id: bkyz2-fmaaa-aaaaa-qaaaq-cai"));
assert!(text.contains("requested_limit: 10"));
assert!(text.contains("owner_principal_id: bkyz2-fmaaa-aaaaa-qaaaq-cai"));
assert!(text.contains("00010203"));
assert!(text.contains("2026-06-01T00:00:00Z"));
}
#[test]
fn sns_list_ids_follow_source_order() {
let request = list_request(false);
let report = build_sns_list_report_with_source(&request, &UnsortedFixtureSnsListSource)
.expect("sns list report");
let info = build_sns_info_report_with_source(&info_request("1"), &UnsortedFixtureSnsListSource)
.expect("sns info report");
assert_eq!(report.sns_instances[0].id, 1);
assert_eq!(report.sns_instances[0].name, "A Name");
assert_eq!(report.sns_instances[0].root_canister_id, ROOT_A);
assert_eq!(report.sns_instances[1].id, 2);
assert_eq!(report.sns_instances[1].name, "Z Name");
assert_eq!(report.sns_instances[1].root_canister_id, ROOT_B);
assert_eq!(info.id, 1);
assert_eq!(info.root_canister_id, ROOT_A);
}
#[test]
fn sns_list_name_sort_keeps_stable_ids() {
let mut request = list_request(false);
request.sort = SnsListSort::Name;
let report = build_sns_list_report_with_source(&request, &UnsortedFixtureSnsListSource)
.expect("sns list report");
let text = sns_list_report_text(&report);
let info = build_sns_info_report_with_source(&info_request("1"), &UnsortedFixtureSnsListSource)
.expect("sns info report");
assert_eq!(report.sort, "name");
assert_eq!(report.sns_instances[0].id, 1);
assert_eq!(report.sns_instances[0].name, "A Name");
assert_eq!(report.sns_instances[1].id, 2);
assert_eq!(report.sns_instances[1].name, "Z Name");
assert!(text.contains("sort: name"));
assert_eq!(info.id, 1);
assert_eq!(info.root_canister_id, ROOT_A);
}
#[test]
fn sns_list_surfaces_metadata_fallbacks() {
let request = list_request(true);
let report = build_sns_list_report_with_source(&request, &MetadataErrorFixtureSnsListSource)
.expect("sns list report");
let text = sns_list_report_text(&report);
let info =
build_sns_info_report_with_source(&info_request("1"), &MetadataErrorFixtureSnsListSource)
.expect("sns info report");
let info_text = sns_info_report_text(&info);
assert_eq!(report.metadata_error_count, 1);
assert_eq!(
report.sns_instances[0].metadata_error.as_deref(),
Some("get_metadata: Canister has no Wasm module")
);
assert!(text.contains("metadata_errors: 1"));
assert!(text.contains("metadata_error_details:"));
assert!(text.contains("get_metadata: Canister has no Wasm module"));
assert_eq!(
info.metadata_error.as_deref(),
Some("get_metadata: Canister has no Wasm module")
);
assert!(info_text.contains("metadata_error: get_metadata: Canister has no Wasm module"));
}
#[test]
fn sns_info_rejects_unknown_id() {
let request = info_request("2");
let err =
build_sns_info_report_with_source(&request, &FixtureSnsListSource).expect_err("unknown id");
assert!(matches!(
err,
SnsHostError::UnknownSnsId {
id: 2,
sns_count: 1
}
));
}
#[test]
fn sns_list_rejects_local_network() {
let request = SnsListRequest {
network: "local".to_string(),
source_endpoint: DEFAULT_SNS_SOURCE_ENDPOINT.to_string(),
now_unix_secs: 1_780_531_200,
verbose: false,
sort: SnsListSort::Id,
};
let err = build_sns_list_report_with_source(&request, &FixtureSnsListSource)
.expect_err("local rejected");
assert!(matches!(err, SnsHostError::UnsupportedNetwork { .. }));
}
fn list_request(verbose: bool) -> SnsListRequest {
SnsListRequest {
network: MAINNET_NETWORK.to_string(),
source_endpoint: DEFAULT_SNS_SOURCE_ENDPOINT.to_string(),
now_unix_secs: 1_780_531_200,
verbose,
sort: SnsListSort::Id,
}
}
fn info_request(input: &str) -> SnsInfoRequest {
SnsInfoRequest {
network: MAINNET_NETWORK.to_string(),
source_endpoint: DEFAULT_SNS_SOURCE_ENDPOINT.to_string(),
now_unix_secs: 1_780_531_200,
input: input.to_string(),
}
}
fn token_request(input: &str) -> SnsTokenRequest {
SnsTokenRequest {
network: MAINNET_NETWORK.to_string(),
source_endpoint: DEFAULT_SNS_SOURCE_ENDPOINT.to_string(),
now_unix_secs: 1_780_531_200,
input: input.to_string(),
}
}
fn neurons_request(input: &str) -> SnsNeuronsRequest {
SnsNeuronsRequest {
network: MAINNET_NETWORK.to_string(),
source_endpoint: DEFAULT_SNS_SOURCE_ENDPOINT.to_string(),
now_unix_secs: 1_780_531_200,
input: input.to_string(),
limit: 10,
owner_principal_id: None,
}
}
struct FixtureSnsListSource;
impl SnsListSource for FixtureSnsListSource {
fn fetch_deployed_snses(
&self,
request: &SnsFetchRequest,
) -> Result<MainnetSnsList, SnsHostError> {
Ok(MainnetSnsList {
network: MAINNET_NETWORK.to_string(),
sns_wasm_canister_id: MAINNET_SNS_WASM_CANISTER_ID.to_string(),
fetched_at: request.fetched_at.clone(),
fetched_by: request.fetched_by.clone(),
source_endpoint: request.endpoint.clone(),
sns_instances: vec![fixture_sns(
"Fixture SNS",
Some("Fixture description"),
Some("https://example.com"),
ROOT_A,
GOVERNANCE_A,
LEDGER_A,
SWAP_A,
INDEX_A,
None,
)],
})
}
}
struct UnsortedFixtureSnsListSource;
impl SnsListSource for UnsortedFixtureSnsListSource {
fn fetch_deployed_snses(
&self,
request: &SnsFetchRequest,
) -> Result<MainnetSnsList, SnsHostError> {
Ok(MainnetSnsList {
network: MAINNET_NETWORK.to_string(),
sns_wasm_canister_id: MAINNET_SNS_WASM_CANISTER_ID.to_string(),
fetched_at: request.fetched_at.clone(),
fetched_by: request.fetched_by.clone(),
source_endpoint: request.endpoint.clone(),
sns_instances: vec![
fixture_sns(
"A Name",
None,
None,
ROOT_A,
GOVERNANCE_A,
LEDGER_A,
SWAP_A,
INDEX_A,
None,
),
fixture_sns(
"Z Name",
None,
None,
ROOT_B,
GOVERNANCE_B,
LEDGER_B,
SWAP_B,
INDEX_B,
None,
),
],
})
}
}
struct MetadataErrorFixtureSnsListSource;
impl SnsListSource for MetadataErrorFixtureSnsListSource {
fn fetch_deployed_snses(
&self,
request: &SnsFetchRequest,
) -> Result<MainnetSnsList, SnsHostError> {
Ok(MainnetSnsList {
network: MAINNET_NETWORK.to_string(),
sns_wasm_canister_id: MAINNET_SNS_WASM_CANISTER_ID.to_string(),
fetched_at: request.fetched_at.clone(),
fetched_by: request.fetched_by.clone(),
source_endpoint: request.endpoint.clone(),
sns_instances: vec![fixture_sns(
"unnamed-be2us",
None,
None,
ROOT_A,
GOVERNANCE_A,
LEDGER_A,
SWAP_A,
INDEX_A,
Some("get_metadata: Canister has no Wasm module"),
)],
})
}
}
struct FixtureSnsTokenSource;
impl SnsListSource for FixtureSnsTokenSource {
fn fetch_deployed_snses(
&self,
request: &SnsFetchRequest,
) -> Result<MainnetSnsList, SnsHostError> {
FixtureSnsListSource.fetch_deployed_snses(request)
}
}
impl SnsTokenSource for FixtureSnsTokenSource {
fn fetch_sns_token(
&self,
_request: &SnsFetchRequest,
sns: &MainnetSns,
) -> Result<MainnetSnsToken, SnsHostError> {
assert_eq!(sns.ledger_canister_id, LEDGER_A);
Ok(MainnetSnsToken {
token_name: "Fixture Token".to_string(),
token_symbol: "FIX".to_string(),
decimals: 8,
transfer_fee: "10000".to_string(),
total_supply: "1000000000".to_string(),
minting_account_owner: Some(GOVERNANCE_A.to_string()),
minting_account_subaccount_hex: Some("000102".to_string()),
ledger_index_canister_id: Some(INDEX_A.to_string()),
ledger_index_error: None,
supported_standards: vec![
SnsTokenStandardRow {
name: "ICRC-1".to_string(),
url: "https://github.com/dfinity/ICRC-1".to_string(),
},
SnsTokenStandardRow {
name: "ICRC-2".to_string(),
url: "https://github.com/dfinity/ICRC-2".to_string(),
},
],
metadata: vec![
SnsTokenMetadataRow {
key: "icrc1:name".to_string(),
value_type: "text".to_string(),
value: serde_json::json!("Fixture Token"),
},
SnsTokenMetadataRow {
key: "icrc1:decimals".to_string(),
value_type: "nat".to_string(),
value: serde_json::json!("8"),
},
SnsTokenMetadataRow {
key: "icrc1:logo".to_string(),
value_type: "bool".to_string(),
value: serde_json::json!(true),
},
],
})
}
}
struct FixtureSnsNeuronsSource;
impl SnsListSource for FixtureSnsNeuronsSource {
fn fetch_deployed_snses(
&self,
request: &SnsFetchRequest,
) -> Result<MainnetSnsList, SnsHostError> {
FixtureSnsListSource.fetch_deployed_snses(request)
}
}
impl SnsNeuronsSource for FixtureSnsNeuronsSource {
fn fetch_sns_neurons(
&self,
_request: &SnsFetchRequest,
sns: &MainnetSns,
limit: u32,
owner_principal_id: Option<&str>,
) -> Result<MainnetSnsNeurons, SnsHostError> {
assert_eq!(sns.governance_canister_id, GOVERNANCE_A);
assert_eq!(limit, 10);
assert_eq!(owner_principal_id, Some(GOVERNANCE_A));
Ok(MainnetSnsNeurons {
neurons: vec![SnsNeuronRow {
neuron_id: "00010203".to_string(),
cached_neuron_stake_e8s: 123,
maturity_e8s_equivalent: 456,
staked_maturity_e8s_equivalent: Some(789),
created_timestamp_seconds: 1_780_272_000,
created_at: "2026-06-01T00:00:00Z".to_string(),
}],
})
}
}
#[allow(clippy::too_many_arguments)]
fn fixture_sns(
name: &str,
description: Option<&str>,
url: Option<&str>,
root_canister_id: &str,
governance_canister_id: &str,
ledger_canister_id: &str,
swap_canister_id: &str,
index_canister_id: &str,
metadata_error: Option<&str>,
) -> MainnetSns {
MainnetSns {
id: 0,
name: name.to_string(),
description: description.map(str::to_string),
url: url.map(str::to_string),
root_canister_id: root_canister_id.to_string(),
governance_canister_id: governance_canister_id.to_string(),
ledger_canister_id: ledger_canister_id.to_string(),
swap_canister_id: swap_canister_id.to_string(),
index_canister_id: index_canister_id.to_string(),
metadata_error: metadata_error.map(str::to_string),
}
}