解析V3洋葱域名：技术指南与PHP实现

<?php

// 假设这里有一个Base32解码器类或函数
// 实际应用中，您需要引入一个成熟的Base32库，例如 https://github.com/base32/base32
class Base32
{
    private static $map = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ234567';

    public static function decode(string $input): string
    {
        $input = strtoupper($input);
        $buffer = '';
        $bits = 0;
        $value = 0;

        for ($i = 0; $i < strlen($input); $i++) {
            $char = $input[$i];
            $pos = strpos(self::$map, $char);

            if ($pos === false) {
                // Skip invalid characters, or throw an error
                continue;
            }

            $value = ($value << 5) | $pos;
            $bits += 5;

            if ($bits >= 8) {
                $bits -= 8;
                $buffer .= chr(($value >> $bits) & 0xFF);
            }
        }
        return $buffer;
    }
}

/**
 * 解析V3洋葱域名，提取公钥、校验和和版本号。
 *
 * @param string $onionAddress 完整的V3洋葱域名，例如 "pg6mmjiyjmcrsslvykfwnntlaru7p5svn6y2ymmju6nubxndf4pscryd.onion"
 * @return array|null 包含 'publicKey', 'checksum', 'version' 的关联数组，或在解析失败时返回 null。
 */
function parseV3OnionDomain(string $onionAddress): ?array
{
    // 1. 移除 .onion 后缀
    if (!str_ends_with($onionAddress, '.onion')) {
        echo "错误: 无效的洋葱地址格式，缺少 '.onion' 后缀。\n";
        return null;
    }
    $domainBase32 = str_replace(".onion", "", $onionAddress);

    // 2. Base32 解码
    $decodedBinary = Base32::decode($domainBase32);

    // 检查解码后的长度，V3地址应为35字节
    if (strlen($decodedBinary) !== 35) {
        echo "错误: Base32解码后的数据长度不正确，期望35字节，实际为 " . strlen($decodedBinary) . " 字节。\n";
        return null;
    }

    // 3. 字节截取
    $publicKey = substr($decodedBinary, 0, 32);      // 前32字节是公钥
    $checksum  = substr($decodedBinary, 32, 2);      // 紧随公钥的2字节是校验和
    $version   = substr($decodedBinary, 34, 1);      // 最后一个字节是版本号

    // 将二进制数据转换为可读的十六进制字符串
    $publicKeyHex = bin2hex($publicKey);
    $checksumHex  = bin2hex($checksum);
    $versionHex   = bin2hex($version);

    return [
        'publicKey' => $publicKeyHex,
        'checksum'  => $checksumHex,
        'version'   => $versionHex,
        'versionDecimal' => hexdec($versionHex) // 版本号的十进制表示
    ];
}

// 示例用法
$onionUrl = "pg6mmjiyjmcrsslvykfwnntlaru7p5svn6y2ymmju6nubxndf4pscryd.onion";
$parsedData = parseV3OnionDomain($onionUrl);

if ($parsedData) {
    echo "成功解析V3洋葱域名: {$onionUrl}\n";
    echo "公钥 (HEX): " . $parsedData['publicKey'] . "\n";
    echo "校验和 (HEX): " . $parsedData['checksum'] . "\n";
    echo "版本 (HEX): " . $parsedData['version'] . "\n";
    echo "版本 (DEC): " . $parsedData['versionDecimal'] . "\n";

    // 验证版本号是否为3
    if ($parsedData['versionDecimal'] === 3) {
        echo "版本号验证成功：为V3地址。\n";
    } else {
        echo "警告：版本号不是预期的V3。\n";
    }

    // --- 校验和验证示例 (需要一个SHA3-256库) ---
    // 注意：PHP内置的hash函数不支持SHA3-256，需要引入第三方库或PECL扩展
    // 例如：composer require phpseclib/phpseclib
    // use phpseclib3\Crypt\Hash;
    // $hash = new Hash('sha3-256');
    // $inputForChecksum = ".onion checksum" . hex2bin($parsedData['publicKey']) . hex2bin($parsedData['version']);
    // $calculatedChecksum = substr($hash->hash($inputForChecksum), 0, 2); // 取前两个字节
    // if ($calculatedChecksum === hex2bin($parsedData['checksum'])) {
    //     echo "校验和验证成功！\n";
    // } else {
    //     echo "校验和验证失败！地址可能无效或被篡改。\n";
    // }
}

?>