Skip to main content

Module account

Module account 

Source
Expand description

Account identity — host-form did:web account zone, DNS interface, and DNS-01 wildcard TLS (epic #1158, Phase A3 / ticket #1162).

This module owns the deployment-facing configuration surface for the account zone and the interfaces (not implementations) for the two product-layer concerns above it: managed DNS and ACME DNS-01 wildcard issuance.

§What hyprstream owns vs. what the product layer owns

ConcernOwner
Account-zone apex name (no default — sane-degrade)hyprstream (config)
Wildcard shape *.<apex> (exactly one label — the A2 seam)hyprstream (zone)
Renewal schedule + expiry alarm (total-outage surface)hyprstream (renewal)
Sane-degrade when unconfiguredhyprstream (config, tls)
Publishing DNS-01 TXT + wildcard A/AAAA recordsproduct layer (dns::DnsProvider)
Driving the ACME directory for DNS-01 issuanceproduct layer (tls::WildcardCertIssuer)

The account label grammar (LDH, NFKC, confusable rejection, reserved list, never-reuse) is owned by A2 (#1160); B1 enforces it at mint time. This crate only guarantees the wildcard covers exactly one label.

§No PowerDNS, anywhere

hyprstream must not require a specific DNS server. If it did, self-hosters could not run it. Managed DNS is a product layer above a protocol that does not depend on it — the same posture the epic takes for managed DNS.

Re-exports§

pub use config::AccountHttpConfig;
pub use config::AccountZoneConfig;
pub use dns::DnsError;
pub use dns::DnsProvider;
pub use dns::UnconfiguredDnsProvider;
pub use renewal::AlarmThresholds;
pub use renewal::CertHealth;
pub use renewal::CertHealthMonitor;
pub use renewal::CertRenewer;
pub use tls::CertHandle;
pub use tls::IssuanceError;
pub use tls::IssuedCert;
pub use tls::NullWildcardCertIssuer;
pub use tls::WildcardCertIssuer;
pub use zone::AccountZone;
pub use zone::AccountZoneError;

Modules§

config
Configuration surface for the account zone (epic #1158, ticket #1162 / A3).
dns
The DNS management interface (epic #1158, ticket #1162 / Phase A3).
renewal
Renewal, monitoring, and the expiry alarm for the account-zone wildcard certificate (epic #1158, ticket #1162 / A3).
tls
DNS-01 wildcard certificate issuance for the account zone (epic #1158, ticket #1162 / A3).
zone
The deployment-configured account zone (epic #1158, ticket #1162 / Phase A3).

Functions§

publish_wildcard_records
Publish the wildcard A/AAAA records for the delegated account zone, if the deployment configured targets and wired a DNS backend.