"""Tests for the follow-up alerts derived from a saved health check.""" import unittest from alerts import build_alerts PRODUCTS = ("SeedSigner", "Blockstream Jade", "Nunchuk", "Sparrow Wallet") def clean_record(): """Return a saved check whose results need no follow-up.""" return { "checked_at": "2026-10-01", "next_check_due": "2027-10-01", "software_compatibility_status": "OK", "contact_info_verified": 1, "key_checks": [ { "key_number": 1, "name": "SeedSigner", "type": "hardware", "available": 1, "hardware_works": 1, "seed_backup_status": "OK", "address_verified": 1, "address_path_verified": 1, }, { "key_number": 2, "name": "Blockstream Jade", "type": "hardware", "available": 1, "hardware_works": 1, "seed_backup_status": "OK", "address_verified": 1, "address_path_verified": 1, }, { "key_number": 3, "name": "Nunchuk", "type": "cloud", "available": 1, "hardware_works": None, "seed_backup_status": None, "address_verified": 1, "address_path_verified": 1, }, ], "tool_checks": [ {"product": product, "bip327_status": "IKKJE_VURDERT", "slip39_status": "IKKJE_VURDERT"} for product in PRODUCTS ], "ai_security_checks": [ {"provider": product, "status": "TRYGG"} for product in PRODUCTS ], } class AlertTests(unittest.TestCase): def codes(self, record): return [alert["code"] for alert in build_alerts(record)] def test_a_check_without_problems_has_no_alerts(self): self.assertEqual(build_alerts(clean_record()), []) def test_an_unavailable_key_requires_immediate_follow_up(self): record = clean_record() record["key_checks"][1]["available"] = 0 alerts = build_alerts(record) self.assertEqual(self.codes(record), ["key_unavailable"]) self.assertEqual(alerts[0]["severity"], "critical") self.assertEqual(alerts[0]["source"], "Key 2: Blockstream Jade") def test_a_hardware_failure_points_at_testing_the_backup_elsewhere(self): record = clean_record() record["key_checks"][0]["hardware_works"] = 0 alerts = build_alerts(record) self.assertEqual(self.codes(record), ["hardware_failure"]) self.assertIn("another compatible device", alerts[0]["message"]) def test_a_damaged_seed_backup_points_at_protocol_3(self): record = clean_record() record["key_checks"][0]["seed_backup_status"] = "PROBLEM" alerts = build_alerts(record) self.assertEqual(self.codes(record), ["seed_backup_problem"]) self.assertEqual(alerts[0]["severity"], "critical") self.assertIn("PROTOCOL 3", alerts[0]["message"]) def test_a_failed_address_verification_points_at_bsms(self): record = clean_record() record["key_checks"][0]["address_verified"] = 0 alerts = build_alerts(record) self.assertEqual(self.codes(record), ["address_verification_failed"]) self.assertIn("BSMS", alerts[0]["message"]) def test_a_failed_address_path_verification_is_reported_once(self): record = clean_record() record["key_checks"][0]["address_path_verified"] = 0 self.assertEqual(self.codes(record), ["address_verification_failed"]) def test_incompatible_software_suggests_an_alternative(self): record = clean_record() record["software_compatibility_status"] = "PROBLEM" alerts = build_alerts(record) self.assertEqual(self.codes(record), ["software_incompatible"]) self.assertEqual(alerts[0]["source"], "Software compatibility") def test_reported_bip327_support_is_an_informational_alert(self): record = clean_record() record["tool_checks"][0]["bip327_status"] = "OK" alerts = build_alerts(record) self.assertEqual(self.codes(record), ["bip327_available"]) self.assertEqual(alerts[0]["severity"], "info") self.assertEqual(alerts[0]["source"], "SeedSigner (BIP327)") def test_reported_slip39_support_is_an_informational_alert(self): record = clean_record() record["tool_checks"][1]["slip39_status"] = "OK" alerts = build_alerts(record) self.assertEqual(self.codes(record), ["slip39_available"]) self.assertEqual(alerts[0]["source"], "Blockstream Jade (SLIP39)") def test_a_vulnerable_security_status_must_be_followed_up(self): record = clean_record() record["ai_security_checks"][2]["status"] = "SÅRBAR" alerts = build_alerts(record) self.assertEqual(self.codes(record), ["security_vulnerable"]) self.assertEqual(alerts[0]["severity"], "critical") self.assertEqual(alerts[0]["source"], "Nunchuk") def test_a_compromised_security_status_points_at_the_key_loss_procedure(self): record = clean_record() record["ai_security_checks"][0]["status"] = "KOMPROMITTERT" alerts = build_alerts(record) self.assertEqual(self.codes(record), ["security_compromised"]) self.assertIn("key loss procedure", alerts[0]["message"]) def test_unconfirmed_contact_information_is_reported(self): record = clean_record() record["contact_info_verified"] = 0 alerts = build_alerts(record) self.assertEqual(self.codes(record), ["contact_info_unconfirmed"]) self.assertEqual(alerts[0]["source"], "Contact information") def test_unassessed_values_are_not_treated_as_failures(self): record = clean_record() record["contact_info_verified"] = None record["software_compatibility_status"] = "IKKJE_VURDERT" record["key_checks"][0]["available"] = None record["key_checks"][0]["hardware_works"] = None record["key_checks"][0]["seed_backup_status"] = "IKKJE_VURDERT" record["key_checks"][0]["address_verified"] = None record["key_checks"][0]["address_path_verified"] = None self.assertEqual(build_alerts(record), []) def test_critical_alerts_are_listed_before_informational_ones(self): record = clean_record() record["contact_info_verified"] = 0 record["tool_checks"][0]["bip327_status"] = "OK" record["ai_security_checks"][3]["status"] = "SÅRBAR" record["key_checks"][2]["available"] = 0 severities = [alert["severity"] for alert in build_alerts(record)] self.assertEqual( severities, ["critical", "critical", "info", "info"], ) self.assertEqual( self.codes(record), ["key_unavailable", "security_vulnerable", "bip327_available", "contact_info_unconfirmed"], ) if __name__ == "__main__": unittest.main()