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
| Concern | Owner |
|---|---|
| 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 unconfigured | hyprstream (config, tls) |
| Publishing DNS-01 TXT + wildcard A/AAAA records | product layer (dns::DnsProvider) |
| Driving the ACME directory for DNS-01 issuance | product 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.