# Copyright (C) 2026 Rootiest
# SPDX-License-Identifier: AGPL-3.0-or-later

# CATEGORY
#   10-network
#
# SYNOPSIS
#   gip6
#
# DESCRIPTION
#   Fetches and prints the machine's public IPv6 address using icanhazip.com.
#   Prints an error message if IPv6 is unavailable on the current network.
#
# EXIT STATUS
#   0  IPv6 address resolved
#   1  IPv6 unavailable or not supported on this network
#
# RETURNS
#   The machine's public IPv6 address, printed to stdout
#
# EXAMPLE
#   gip6
function gip6 --description 'Get public IPv6 address'
    # Use -6 to force IPv6 and --fail to catch network errors
    set -l ip (curl -6 -s --fail https://icanhazip.com 2>/dev/null)
    
    if test $status -eq 0
        echo $ip
    else
        echo "❌ IPv6 is currently unavailable or not supported on this network."
        return 1
    end
end