zeroclaw-labs/zeroclaw · error
Blocked host ' ' resolved to , which the configured NAT64…
Error message
Blocked host '{host}' resolved to {v6}, which the configured NAT64 prefix {prefix} translates to non-global address {embedded} What it means
SSRF guard failure in validate_resolved_ips_are_public: an IPv6 answer is inside a configured NAT64 prefix, and the IPv4 address embedded by that prefix is non-globally-routable (for example RFC1918 or link-local). Overlapping prefixes translate one address to several destinations, and every translation must pass, so any bad embedded target blocks the host.
Solutions
- Remove the host from the allowlist or add the NAT64-translated non-global address range to allowed private hosts; do not bypass the guard silently.
Defensive patterns
Strategy: validation
When it happens
Trigger: Thrown at crates/zeroclaw-infra/src/net_guard.rs:859 when the library encounters an invalid state.
Common situations: See trigger scenarios.
AI-assisted analysis of zeroclaw-labs/zeroclaw@88bb9c8533 (2026-08-23).
Data as JSON: /api/errors/743366bbbce07a0e.
Report an issue: GitHub.
Appendix: source
Thrown at crates/zeroclaw-infra/src/net_guard.rs:859
if ips.is_empty() {
anyhow::bail!("Failed to resolve host '{host}'");
}
for ip in ips {
if is_cloud_metadata_ip(*ip) {
return Err(metadata_block_error(host, *ip));
}
if let std::net::IpAddr::V6(v6) = ip {
// Overlapping prefixes translate one address to several different
// destinations. Every one of them is reachable, so the address is
// accepted only when all of them are acceptable.
for (prefix, embedded) in network_specific_embedded_ipv4s(*v6, nat64_prefixes) {
if is_cloud_metadata_ip(std::net::IpAddr::V4(embedded)) {
return Err(nat64_metadata_block_error(host, *v6, prefix, embedded));
}
if is_non_global_v4(embedded) {
anyhow::bail!(
"Blocked host '{host}' resolved to {v6}, which the configured NAT64 prefix \
{prefix} translates to non-global address {embedded}"
);
}
}
}
let non_global = match ip {
std::net::IpAddr::V4(v4) => is_non_global_v4(*v4),
std::net::IpAddr::V6(v6) => is_non_global_v6(*v6),
};
if non_global {
anyhow::bail!("Blocked host '{host}' resolved to non-global address {ip}");
}
}
Ok(())
}View on GitHub (pinned to 88bb9c8533)