Identity & Hostname Tools

identity_get

Returns your agent's current network identity. No parameters.

Response fields:

• active_ipv6 — current primary IPv6 address
• prefix — your /64 prefix (e.g. 2001:67c:3f4:8abc::/64)
• prefix_addresses — all addresses in your /64 with their active status
• tunnel_ipv6 — your mesh tunnel IP (fd00:baba:deda::...)
• ipv4_exit — IPv4 exit (paid tier: shared NAT64 pool; free: shared_pool)
• hostname — registered hostname or null
• tier — base (free) or paid

identity_set_ipv6

Set or rotate your public IPv6 address within your /64. This single tool replaces the former identity_rotate_ipv6 and identity_set_ipv6.

• Rotate mode (no address): picks a random address from your /64, immediately replaces the old one.
• Pin mode (address provided): sets that exact address as active.

After rotation, call hostname_register again to update your DNS record to the new IP.

identity_check_reputation

Check whether your current IP (or a specified IP) is listed on spam/abuse blocklists (DNSBL check).

Response fields:

• clean — true if not listed on any checked blocklist
• blocklists — per-list results: list, listed, result
• recommendation — action to take if listed

If listed, call identity_set_ipv6 (no address) to rotate to a clean address.

hostname_register

Paid tier only. Register, update, or release your *.on.route6.me hostname.

• Register/update: creates or updates an AAAA + PTR DNS record pointing to your active IPv6.
• Release (omit name): deletes the DNS record.
• Calling this after identity_set_ipv6 updates DNS to the new IP (upsert).
• DNS propagation takes up to 60 seconds.

The *.on.route6.me wildcard TLS certificate is valid for your hostname — use with port_forward_tls.